application_properties.md

Configure Application Properties (Bundle ID, App Name)

Table of Contents

• Using Make Commands
• Renaming the Application
• Script Dependencies
• Using package_rename Directly
• Variables

Using Make Commands

The following make commands are available to facilitate application configuration:

• Renaming Application:

  make rename-package PACKAGE_NAME=com.example.newapp BUNDLE_ID=com.example.newapp ANDROID_APP_NAME="New App" IOS_APP_NAME="New App"

• Generating package rename configuration:

  make generate-package-config

• Adding and running package rename tool:

  make rename-package

Renaming the Application

To update the package name, bundle ID, and application name for Android and iOS, run the following command:

make rename-package PACKAGE_NAME=com.webtrit.newapp BUNDLE_ID=com.webtrit.newapp ANDROID_APP_NAME="WebTrit" IOS_APP_NAME="WebTrit"

Script Dependencies

This script is based on the package_rename package, which facilitates renaming default fields for each platform project within the WebTrit Phone application.

Using package_rename Directly

If you prefer to use package_rename manually, follow these steps:

1. Add package_rename as a development dependency:

   dart pub add package_rename --dev

2. Create a package_rename_config.yaml file with the following content:

   package_rename_config:
     android:
       app_name: "New App"
       package_name: com.webtrit.newapp
       override_old_package: com.webtrit.app # N
       lang: kotlin
     ios:
       app_name: "New App"
       package_name: com.webtrit.newapp

3. Run the rename command:

   dart run package_rename

Variables

• PACKAGE_NAME - Android package name
• BUNDLE_ID - iOS bundle ID
• ANDROID_APP_NAME - Android application name
• IOS_APP_NAME - iOS application name

These commands automate the renaming process and ensure consistent configuration across platforms.