This document outlines how to build the Totara Mobile app deliverables for iOS and Android within a local environment. Before that, you will be required to setup code base with all the correct dependencies. The setup guide can be found in Getting started with the Totara Mobile app page of this documentation.
Android release build
To release an Android app to the app store, there are a couple of method you can use. For the Totara Mobile app, there’s no difference from a regular Android app release, which is well documented in official Android documentation.
Add the following properties at the end of the file android/gradle.properties
MYAPP_RELEASE_STORE_FILE=<replace> MYAPP_RELEASE_STORE_PASSWORD=<replace> MYAPP_RELEASE_KEY_ALIAS=<replace> MYAPP_RELEASE_KEY_PASSWORD=<replace>
Run following command to build release apk file
npm run local:android-release
Release apk file named app-release.apk will be generated into ./android/app/build/outputs/apk/ directory. Which can be used to publish on Google Play for public release or internal testing. It can also be directly installed on an Android device.
Resources
https://play.google.com/console/about/internal-testing/
https://developer.android.com/distribute/best-practices/develop/in-app-a-b-testing
https://developer.android.com/studio/command-line/adb#move
iOS release build
In order to build deliverable for iOS, make sure Apple provisioning information (bundle identifier and distribution certificate) are ready. Find the guide on Apple's developer help site for preparing for distribution.
Setup provisioning
Open the iOS project(./ios/TotaraMobileApp.xcworkspace) with XCode and select "Signing & Compatibilities" settings for the "Release" schema of the app.
Project: TotaraMobileApp(1) → Target: TotaraMobileApp(2) → Setting: Signing & Capabilities(3) → Schema: Release(4)
Change the "Bundle Identifier" and "Team"(5) which associated with provision profile:
Submit iOS build
There are a few ways to submit a release build to the app store for publishing or beta testing, more information can be found on Apple's help site. Here it describe how to create release build using Xcode.
First, you will be required to archive the app for any device. So select build target for any device as shown below.
Go to Product > Archive from Xcode top main menu:
Once archiving has finished, it will show the Archives window with the existing list of archives. Select the relevant version and click on the Distribute App option:
To submit a build directly to the app store or test flight you can do this by selecting App Store connect, and selecting Ad Hoc method facilitates to export the build to a local machine. Select the required mode of delivery and follow the steps accordingly.
Ad Hoc export build will generate .ipa file to the given export location, which can be directly install to the registered devices of the app with connecting to the local machine.
Resources
https://developer.apple.com/documentation/xcode/preparing_your_app_for_distribution