Connect a physical device or start an Android emulator. Check the device is running with adb devices (if the adb daemon is not running, start it with adb start-server).
Run react-native run-android (react-native run-android && react-native log-android for logging).
Building an APK
To build mSupply Mobile from source, you will need a signing key from a Sussol insider.
Copy or move the release key to the ./android/app directory, e.g. mv my-release-key.keystore ./android/app.
Run yarn install && ./android/gradlew assembleRelease.
The built APK can be found at android/app/build/outputs/apk/app-release.apk.
For more information, see the official React Native documentation for generating signed APKs.
Connecting to the Server
When the app is run for the first time, you will be presented with a login screen.
In the first input field, enter the address of the computer running the mSupply server. The address should be entered in the following format: http://hostname:server_port. If the server does not have a hostname, enter the IP address. If using an emulator to access an instance of mSupply running on the local device, server_ip = 10.0.2.2.
In the second input field, enter the sync site name.
In the third input field, enter the sync site password.
Press connect to begin the one-time-only initialisation process (this may take several minutes).
When initialisation is complete, the app will navigate to the user login screen. When opening the app from now on, the user will be navigated directly to the login screen.