Skip to main content

Build Your App

📮 The final build app will be sent to your email a few hours after submitting the build (normally 4-5 hours)

After customize the Design and configure the Features of your App. Now let's build the app.

1. Preconditions​

  • Not use special characters or space in the files name (of icon file, provisioning, certificate). They should be in English.
  • Export the env.dart and config json files (to save the config files if needed)
  • To build a multi-languages app, please do more configurations at "5. Multi Languages" below.

2. Build Android app​

On the left menu, select Build, then follow the steps below:

  1. Select Android APK or Android App Bundle

  2. Update your Bundle ID and click UPDATE . Your Bundle ID must not include reserved keywords.

    Check the Use OneSignal checkbox if you would like to push notifications via OneSignal.

![](/notion_imgs/847596817.png)

  1. Input Google services file and Key Store's information:

💠 Input your `Keystore`'s information if you already had them. 


If you do not have a keystore, click `CREATE KEYSTORE` button to create it automatically: 


    1. input a string to the `key password` and `store password` textboxes _(they must be the same, at least 6 characters)_ 


    2. select `CREATE` button.  


💠 Input your Google services file: click the **folder** icon, refer to your `google-services.json` file _(search "2. Android" in_ [_this guide_](/feature-firebase-setting) _to download your_ _`google-services.json`__)_

  1. Input app information as below:

    • Input your App Name (at least 2 characters)
    • App Icon (Do not use special characters or space in the file name . They should be in English.)
    • App version (format of x.x.x)
    • Build version (greater than 1)
    • Update the env.dart and config_en.json files after exporting them. (to build your app with all configured Design and Features that you have edited with AppBuilder)
    • Select Upload information button (to save all your configuration)
    • Then click Submit Build button. The result and APK, AAB files will be sent to your email after 15-30 minutes.

Finish!

3. Build iOS app​

On the left menu, select Build then follow the steps below:

  1. Select iOS IPA

  2. Update your Bundle ID and click UPDATE button (this guide.

    Check the Use OneSignal checkbox if you would like to push notifications via OneSignal.

![](/notion_imgs/1673941935.png)

  1. Input information of Apple Store Connect, Certificate, Provisioning, Google service files as below:

💠 Input information of **Admin Role** `Apple Store Connect API Private key` _(file will have an extension_ _`.p8`__)._ Make sure to login by using the Owner of the App Store Account to create the key, see [Creating API Keys for App Store Connect API](https://developer.apple.com/documentation/appstoreconnectapi/creating_api_keys_for_app_store_connect_api) or [go here to create it](https://appstoreconnect.apple.com/access/api).


![](/notion_imgs/1030342968.webp)


💠 Input your **certificate file** `.p12` and its **password**. (_Distribution_ or _iOS Distribution_ permissions)


If you do not have it, select `Automatically` button to create a new one.


_If getting an issue when creating a certificate, because it already_ _**exceeded the number of certificates**_ _with Distribution and iOS Distribution permissions, please go to_ [_Apple Developer_](https://developer.apple.com/) _to_ _**Revoke**_ _one as these steps:     
1. Login with your  account     
2. Click_ _**Account**_ _>_ _**Certificates**_  _(or go to_ [_this link_](https://developer.apple.com/account/resources/certificates/list)_). 
3. Select an old_ _**Distribution**_ _or_ _**iOS Distribution**_ _certificate      
4. Select_ _**Revoke**_ _- now you can continue to click_ _**Automatically**_ _on builder to create a new certificate._


💠 Input your **Provisioning file** or click `Create provisioning` button to create it automatically. 


Make sure to select `Re-create if exists` to delete the old provisioning file.


💠 Input the `GoogleService-Info.plist` file by selecting the **folder icon** _(search "1. iOS" in_ [_this guide_](/feature-firebase-setting) _to download your GoogleService-Info.plist file)_

  1. Input the information of your app as below:

  • Input your App Name (at least 2 characters)
  • App Icon (Do not use special characters or space in the file name. They should be in English)

💠 App version (format of x.x.x): If your App version is already published on App Store. Please increase the App version to a higher number in order to upload the new build to Test Flight. 💠 Remember to update the Build version by increasing this number of build versions whenever you build.

  • Update the env.dart and config_en.json files after exporting them. (to build your app with all configured Design and Features that you have edited with AppBuilder)
  • Select Upload information button (to save all your configuration)
  • Then click Submit Build button. If building the IPA file successfully, it will be uploaded to TestFlight. The result will be sent to your email after 1-2 hours (then wait 30 minutes for TestFlight approval).

Finish!

4. View your iOS app​

After receiving the email that notifies you have built the iOS app successfully, follow the steps below to test your iOS app on your smartphone:

  1. Go to App Store Connect, then sign in with your Apple ID.

  2. Select My Apps

  3. Select your app, then choose TestFlight

  4. Now you can check the App Version and the Build Version to view the correct one have built:

  5. Open TestFlight on your iOS smartphone to test the app. Enjoy!

5. Multi Languages​

If using this Build On Cloud feature, you can use multiple languages. Before building your app on Cloud, please follow one of both guides below: