diff --git a/content/en/docs/refguide/mobile/distributing-mobile-apps/building-native-apps/native-build-locally.md b/content/en/docs/refguide/mobile/distributing-mobile-apps/building-native-apps/native-build-locally.md index df3b467dbf0..f0fe20605df 100644 --- a/content/en/docs/refguide/mobile/distributing-mobile-apps/building-native-apps/native-build-locally.md +++ b/content/en/docs/refguide/mobile/distributing-mobile-apps/building-native-apps/native-build-locally.md @@ -40,7 +40,7 @@ To set up your local app, do the following: 1. When Mendix Native Mobile Builder launches you will see the home screen: {{< figure src="/attachments/howto/mobile/native-mobile/distribution/build-native-apps/deploying-native-app/home-screen.png" alt="Mendix Native Mobile Builder Home Screen" width="350" class="no-border" >}} -1. Select **Build app for distribution**. +1. Select **Build app for local development**. 1. Fill in your app's name and the app identifier. The wizard provides defaults, but you might want to align the app identifier to use your company's reversed URL, or change the app name in some other way: {{< figure src="/attachments/howto/mobile/native-mobile/distribution/build-native-apps/deploying-native-app/wizard-app-details.png" alt="Wizard App Details" width="350" class="no-border" >}} diff --git a/content/en/docs/refguide/mobile/distributing-mobile-apps/distributing-native-apps.md b/content/en/docs/refguide/mobile/distributing-mobile-apps/distributing-native-apps.md index 2af1d56a701..d7a0d7610e7 100644 --- a/content/en/docs/refguide/mobile/distributing-mobile-apps/distributing-native-apps.md +++ b/content/en/docs/refguide/mobile/distributing-mobile-apps/distributing-native-apps.md @@ -94,3 +94,64 @@ To generate a keystore for Android, follow these steps: {{< figure src="/attachments/refguide/mobile/managing-app-signing-keys/qanda.png" alt="info questions" class="no-border" >}} 6. Finishing these questions generates a keystore which will be saved into a *file.keystore* file in your current working directory. + +## Building a Release App {#building-release} + +Once your signing credentials are ready, you can build the signed release version of your app using Xcode (for iOS) or Android Studio (for Android). + +### iOS (Xcode) + +To build your iOS app in Xcode, do the following: + +1. Open your project in Xcode (this can be generated by the Mendix Native Builder). +1. In the project navigator, select your app target. +1. Go to the **Signing & Capabilities** tab and ensure your team and provisioning profile are set. +1. Choose **Any iOS Device (arm64)** in the device target dropdown. +1. Go to the **Product** menu and select **Archive**. +1. When the archive is complete, the **Organizer** window will open. +1. From there, you can export the *.ipa* file by selecting **Distribute App** > **App Store Connect** or **Ad Hoc**, depending on your goal. +1. Follow the steps to export the *.ipa* file or upload it directly to App Store Connect + +Once you finish the final step, the exported *.ipa* file is usually located under `"~/Library/Developer/Xcode/Archives/DATE/YOUR-APP.xcarchive"` (with the publish date and name of your app instead of DATE and YOUR-APP). + +### Android (Android Studio) + +To build an Android app in Android Studio, do the following: + +1. Open the android directory of your Mendix Native project in Android Studio. +1. Select Build > Generate Signed Bundle / APK from the top menu. +1. Choose APK or Android App Bundle (AAB). +1. Follow the wizard and choose your keystore file, alias, and password. +1. Select release as the build variant. +1. Complete the wizard and wait for Android Studio to build the release file. + +Once you finish the final step, the output *.apk* or *.aab* file will be located in one of two places (with the name of your project instead of YOUR-PROJECT): + +* `"YOUR-PROJECT/android/app/build/outputs/apk/release/app-release.apk"` +* `"~YOUR-PROJECT/android/app/build/outputs/bundle/release/app-release.aab"` + +## Publishing to App Stores {#publishing} + +### iOS – App Store Connect + +To publish in the iOS App Store, do the following: + +1. Log into App Store Connect. +1. Create a new app record if this is your first time submitting. +1. Upload the *.ipa* file directly from Xcode or by using Transporter (a free tool from Apple). +1. Fill in all required metadata, screenshots, and compliance information. +1. Submit your app for review. + +Make sure your Apple Developer Account is active and the app has passed validation before submission. + +### Android – Google Play Console + +To publish in the Android Google Play Console, do the following: + +1. Go to the Google Play Console. +1. Create a new application and fill in the store listing information. +1. Navigate to the **Release** > **Production** > **Create Release section**. +1. Upload your signed *.apk* or *.aab* file. +1. Review and roll out your release to production. + +Be sure to enroll in Google Play App Signing if you plan to use AAB files. Also, don’t forget to set up content rating, privacy policies, and testing tracks if needed. \ No newline at end of file diff --git a/content/en/docs/refguide/mobile/distributing-mobile-apps/overtheair-updates.md b/content/en/docs/refguide/mobile/distributing-mobile-apps/overtheair-updates.md index 9a46b26d6f4..845c4deb1bb 100644 --- a/content/en/docs/refguide/mobile/distributing-mobile-apps/overtheair-updates.md +++ b/content/en/docs/refguide/mobile/distributing-mobile-apps/overtheair-updates.md @@ -61,7 +61,7 @@ OTA updates are useful in the following app development cases: * Style changes * Static image, text, or other static asset changes * Layout changes -* Nanoflow changes +* Adding/Editing Nanoflow or Microflow * JavaScript action changes * Widgets added or removed * You added a new custom JavaScript-only widget or module @@ -77,7 +77,6 @@ If you have made any changes directly to your iOS or Android app, you will have * You fundamentally changed your app's functionality (this is an Apple App Store limitation, and will require a re-release and re-review of your app by Apple—your app might be removed if you do not comply) * A new native module has been added (such as the [Native Mobile AR](https://marketplace.mendix.com/link/component/117209) module — for more information see [Modules](/refguide/modules/) * The app has been renamed -* You added a new microflow or nanoflow * The app's launcher icons have been changed * The splash screen has been changed * The native template was updated (NT patch updates also require a full release) diff --git a/content/en/docs/refguide10/mobile/distributing-mobile-apps/building-native-apps/native-build-locally.md b/content/en/docs/refguide10/mobile/distributing-mobile-apps/building-native-apps/native-build-locally.md index 9659892c9ad..74aa021a331 100644 --- a/content/en/docs/refguide10/mobile/distributing-mobile-apps/building-native-apps/native-build-locally.md +++ b/content/en/docs/refguide10/mobile/distributing-mobile-apps/building-native-apps/native-build-locally.md @@ -40,7 +40,7 @@ To set up your local app, do the following: 1. When Mendix Native Mobile Builder launches you will see the home screen: {{< figure src="/attachments/howto10/mobile/native-mobile/distribution/build-native-apps/deploying-native-app/home-screen.png" alt="Mendix Native Mobile Builder Home Screen" width="350" class="no-border" >}} -1. Select **Build app for distribution**. +1. Select **Build app for local development**. 1. Fill in your app's name and the app identifier. The wizard provides defaults, but you might want to align the app identifier to use your company's reversed URL, or change the app name in some other way: {{< figure src="/attachments/howto10/mobile/native-mobile/distribution/build-native-apps/deploying-native-app/wizard-app-details.png" alt="Wizard App Details" width="350" class="no-border" >}} diff --git a/content/en/docs/refguide10/mobile/distributing-mobile-apps/distributing-native-apps.md b/content/en/docs/refguide10/mobile/distributing-mobile-apps/distributing-native-apps.md index 5e7f9eee8e8..11f2edab5ce 100644 --- a/content/en/docs/refguide10/mobile/distributing-mobile-apps/distributing-native-apps.md +++ b/content/en/docs/refguide10/mobile/distributing-mobile-apps/distributing-native-apps.md @@ -94,3 +94,64 @@ To generate a keystore for Android, follow these steps: {{< figure src="/attachments/refguide10/mobile/managing-app-signing-keys/qanda.png" alt="info questions" class="no-border" >}} 6. Finishing these questions generates a keystore which will be saved into a *file.keystore* file in your current working directory. + +## Building a Release App {#building-release} + +Once your signing credentials are ready, you can build the signed release version of your app using Xcode (for iOS) or Android Studio (for Android). + +### iOS (Xcode) + +To build your iOS app in Xcode, do the following: + +1. Open your project in Xcode (this can be generated by the Mendix Native Builder). +1. In the project navigator, select your app target. +1. Go to the **Signing & Capabilities** tab and ensure your team and provisioning profile are set. +1. Choose **Any iOS Device (arm64)** in the device target dropdown. +1. Go to the **Product** menu and select **Archive**. +1. When the archive is complete, the **Organizer** window will open. +1. From there, you can export the *.ipa* file by selecting **Distribute App** > **App Store Connect** or **Ad Hoc**, depending on your goal. +1. Follow the steps to export the *.ipa* file or upload it directly to App Store Connect + +Once you finish the final step, the exported *.ipa* file is usually located under `"~/Library/Developer/Xcode/Archives/DATE/YOUR-APP.xcarchive"` (with the publish date and name of your app instead of DATE and YOUR-APP). + +### Android (Android Studio) + +To build an Android app in Android Studio, do the following: + +1. Open the android directory of your Mendix Native project in Android Studio. +1. Select **Build** > **Generate Signed Bundle / APK** from the top menu. +1. Choose **APK** or **Android App Bundle (AAB)**. +1. Follow the wizard and choose your keystore file, alias, and password. +1. Select release as the build variant. +1. Complete the wizard and wait for Android Studio to build the release file. + +Once you finish the final step, the output *.apk* or *.aab* file will be located in one of two places (with the name of your project instead of YOUR-PROJECT): + +* `"YOUR-PROJECT/android/app/build/outputs/apk/release/app-release.apk"` +* `"~YOUR-PROJECT/android/app/build/outputs/bundle/release/app-release.aab"` + +## Publishing to App Stores {#publishing} + +### iOS – App Store Connect + +To publish in the iOS App Store, do the following: + +1. Log into App Store Connect. +1. Create a new app record if this is your first time submitting. +1. Upload the *.ipa* file directly from Xcode or by using Transporter (a free tool from Apple). +1. Fill in all required metadata, screenshots, and compliance information. +1. Submit your app for review. + +Make sure your Apple Developer Account is active and the app has passed validation before submission. + +### Android – Google Play Console + +To publish in the Android Google Play Console, do the following: + +1. Go to the Google Play Console. +1. Create a new application and fill in the store listing information. +1. Navigate to the **Release** > **Production** > **Create Release section**. +1. Upload your signed *.apk* or *.aab* file. +1. Review and roll out your release to production. + +Be sure to enroll in Google Play App Signing if you plan to use AAB files. Also, don’t forget to set up content rating, privacy policies, and testing tracks if needed. \ No newline at end of file diff --git a/content/en/docs/refguide10/mobile/distributing-mobile-apps/overtheair-updates.md b/content/en/docs/refguide10/mobile/distributing-mobile-apps/overtheair-updates.md index e62bd1d7d04..58aa5a53033 100644 --- a/content/en/docs/refguide10/mobile/distributing-mobile-apps/overtheair-updates.md +++ b/content/en/docs/refguide10/mobile/distributing-mobile-apps/overtheair-updates.md @@ -61,7 +61,7 @@ OTA updates are useful in the following app development cases: * Style changes * Static image, text, or other static asset changes * Layout changes -* Nanoflow changes +* Adding/Editing Nanoflow or Microflow * JavaScript action changes * Widgets added or removed * You added a new custom JavaScript-only widget or module @@ -77,7 +77,6 @@ If you have made any changes directly to your iOS or Android app, you will have * You fundamentally changed your app's functionality (this is an Apple App Store limitation, and will require a re-release and re-review of your app by Apple—your app might be removed if you do not comply) * A new native module has been added (such as the [Native Mobile AR](https://marketplace.mendix.com/link/component/117209) module — for more information see [Modules](/refguide10/modules/) * The app has been renamed -* You added a new microflow or nanoflow * The app's launcher icons have been changed * The splash screen has been changed * The native template was updated (NT patch updates also require a full release) diff --git a/content/en/docs/refguide9/mobile/distributing-mobile-apps/building-native-apps/native-build-locally.md b/content/en/docs/refguide9/mobile/distributing-mobile-apps/building-native-apps/native-build-locally.md index eeb99a6f4bc..0127beeba18 100644 --- a/content/en/docs/refguide9/mobile/distributing-mobile-apps/building-native-apps/native-build-locally.md +++ b/content/en/docs/refguide9/mobile/distributing-mobile-apps/building-native-apps/native-build-locally.md @@ -40,7 +40,7 @@ To set up your local app, do the following: 1. When Mendix Native Mobile Builder launches you will see the home screen: {{< figure src="/attachments/howto9/mobile/native-mobile/distribution/build-native-apps/deploying-native-app/home-screen.png" alt="Mendix Native Mobile Builder Home Screen" width="350" class="no-border" >}} -1. Select **Build app for distribution**. +1. Select **Build app for local development**. 1. Fill in your app's name and the app identifier. The wizard provides defaults, but you might want to align the app identifier to use your company's reversed URL, or change the app name in some other way: {{< figure src="/attachments/howto9/mobile/native-mobile/distribution/build-native-apps/deploying-native-app/wizard-app-details.png" alt="Wizard App Details" width="350" class="no-border" >}} diff --git a/content/en/docs/refguide9/mobile/distributing-mobile-apps/distributing-native-apps.md b/content/en/docs/refguide9/mobile/distributing-mobile-apps/distributing-native-apps.md index a20ef6dd69f..ad70fb8d84a 100644 --- a/content/en/docs/refguide9/mobile/distributing-mobile-apps/distributing-native-apps.md +++ b/content/en/docs/refguide9/mobile/distributing-mobile-apps/distributing-native-apps.md @@ -94,3 +94,64 @@ To generate a keystore for Android, follow these steps: {{< figure src="/attachments/refguide9/mobile/managing-app-signing-keys/qanda.png" alt="info questions" class="no-border" >}} 6. Finishing these questions generates a keystore which will be saved into a *file.keystore* file in your current working directory. + +## Building a Release App {#building-release} + +Once your signing credentials are ready, you can build the signed release version of your app using Xcode (for iOS) or Android Studio (for Android). + +### iOS (Xcode) + +To build your iOS app in Xcode, do the following: + +1. Open your project in Xcode (this can be generated by the Mendix Native Builder). +1. In the project navigator, select your app target. +1. Go to the **Signing & Capabilities** tab and ensure your team and provisioning profile are set. +1. Choose **Any iOS Device (arm64)** in the device target dropdown. +1. Go to the **Product** menu and select **Archive**. +1. When the archive is complete, the **Organizer** window will open. +1. From there, you can export the *.ipa* file by selecting **Distribute App** > **App Store Connect** or **Ad Hoc**, depending on your goal. +1. Follow the steps to export the *.ipa* file or upload it directly to App Store Connect + +Once you finish the final step, the exported *.ipa* file is usually located under `"~/Library/Developer/Xcode/Archives/DATE/YOUR-APP.xcarchive"` (with the publish date and name of your app instead of DATE and YOUR-APP). + +### Android (Android Studio) + +To build an Android app in Android Studio, do the following: + +1. Open the android directory of your Mendix Native project in Android Studio. +1. Select **Build** > **Generate Signed Bundle / APK** from the top menu. +1. Choose **APK** or **Android App Bundle (AAB)**. +1. Follow the wizard and choose your keystore file, alias, and password. +1. Select release as the build variant. +1. Complete the wizard and wait for Android Studio to build the release file. + +Once you finish the final step, the output *.apk* or *.aab* file will be located in one of two places (with the name of your project instead of YOUR-PROJECT): + +* `"YOUR-PROJECT/android/app/build/outputs/apk/release/app-release.apk"` +* `"~YOUR-PROJECT/android/app/build/outputs/bundle/release/app-release.aab"` + +## Publishing to App Stores {#publishing} + +### iOS – App Store Connect + +To publish in the iOS App Store, do the following: + +1. Log into App Store Connect. +1. Create a new app record if this is your first time submitting. +1. Upload the *.ipa* file directly from Xcode or by using Transporter (a free tool from Apple). +1. Fill in all required metadata, screenshots, and compliance information. +1. Submit your app for review. + +Make sure your Apple Developer Account is active and the app has passed validation before submission. + +### Android – Google Play Console + +To publish in the Android Google Play Console, do the following: + +1. Go to the Google Play Console. +1. Create a new application and fill in the store listing information. +1. Navigate to the **Release** > **Production** > **Create Release section**. +1. Upload your signed *.apk* or *.aab* file. +1. Review and roll out your release to production. + +Be sure to enroll in Google Play App Signing if you plan to use AAB files. Also, don’t forget to set up content rating, privacy policies, and testing tracks if needed. \ No newline at end of file diff --git a/content/en/docs/refguide9/mobile/distributing-mobile-apps/overtheair-updates.md b/content/en/docs/refguide9/mobile/distributing-mobile-apps/overtheair-updates.md index 9c33bbdbfd0..16e0c4f5c81 100644 --- a/content/en/docs/refguide9/mobile/distributing-mobile-apps/overtheair-updates.md +++ b/content/en/docs/refguide9/mobile/distributing-mobile-apps/overtheair-updates.md @@ -61,7 +61,7 @@ OTA updates are useful in the following app development cases: * Style changes * Static image, text, or other static asset changes * Layout changes -* Nanoflow changes +* Adding/Editing Nanoflow or Microflow * JavaScript action changes * Widgets added or removed * You added a new custom JavaScript-only widget or module @@ -77,7 +77,6 @@ If you have made any changes directly to your iOS or Android app, you will have * You fundamentally changed your app's functionality (this is an Apple App Store limitation, and will require a re-release and re-review of your app by Apple—your app might be removed if you do not comply) * A new native module has been added (such as the [Native Mobile AR](https://marketplace.mendix.com/link/component/117209) module — for more information see [Modules](/refguide9/modules/)) * The app has been renamed -* You added a new microflow or nanoflow * The app's launcher icons have been changed * The splash screen has been changed diff --git a/static/attachments/howto10/mobile/native-mobile/distribution/build-native-apps/deploying-native-app/home-screen.png b/static/attachments/howto10/mobile/native-mobile/distribution/build-native-apps/deploying-native-app/home-screen.png index a29c3916265..2e02c27d845 100644 Binary files a/static/attachments/howto10/mobile/native-mobile/distribution/build-native-apps/deploying-native-app/home-screen.png and b/static/attachments/howto10/mobile/native-mobile/distribution/build-native-apps/deploying-native-app/home-screen.png differ