Installation Guide

1. Open your OutSystems Service Studio.
2. Navigate to the Dependencies section in your Mobile App module.
3. Add the Change App Name plugin to your module from the Forge.
4. In the Extensibility Configurations, add the following JSON:

{
  "plugin": {
    "url": "https://github.com/AKQannas/cordova-plugin-change-displayname.git",
    "variables": [
      {
        "name": "APP_NAME",
        "value": "Your Desired App Name"
      }
    ]
  }
}

• Replace Your Desired App Name with the intended name for your application.

4. Save your changes.

Configuration

1. Set the App Name:
   • Define the app name in the APP_NAME variable within the JSON configuration.
   • You can use any supported characters, including non-Latin characters like Arabic (e.g., "متجر").
2. Rebuild the Mobile App:
   • After saving the configurations, go to Module > Generate Mobile Apps.
   • Rebuild the iOS and Android apps.

Usage Instructions

1. Deploy the generated app to test environments using tools like TestFlight (for iOS) or APK files (for Android).
2. Verify the display name on the device's home screen matches the value you set in APP_NAME.

Troubleshooting

• If the build fails:
  • Ensure the plugin URL is correct.
  • Verify the app name does not contain unsupported characters for the target platform.
• Check the build logs for errors related to the plugin or Extensibility Configurations.

Important Notes

• This plugin applies the app name during the build process and cannot change it dynamically after installation.
• Compatible with both iOS and Android platforms.