inji

MOSIP citizen app.

Dependencies

Be sure to have the following build tools installed before proceeding:

• Gradle
• Java 8
• Expo
• Android SDK
• XCode

Generate keystore for APK signing

keytool \
 -genkey -v \
 -storetype PKCS12 \
 -keyalg RSA \
 -keysize 2048 \
 -validity 10000 \
 -storepass 'android' \
 -keypass 'android' \
 -alias androidreleasekey \
 -keystore android/app/release.keystore \
 -dname "CN=io.mosip.residentapp,OU=,O=,L=,S=,C=US"

Running the app

Prepare environment

Create a .env.local file using .env as your template:

MIMOTO_HOST=
GOOGLE_NEARBY_MESSAGES_API_KEY=

And android/local.properties:

GOOGLE_NEARBY_MESSAGES_API_KEY=

More info here: Setup Google Nearby Messages in React

Android

# install all dependencies
npm install

# run Inji Newlogic directly to connected emulator or device (Default)
npm run android:newlogic

# run Inji Mosip directly to connected emulator or device
npm run android:mosip

# run Inji Philippines directly to connected emulator or device
npm run android:ph

iOS

# install all dependencies
npm install
npx pod-install

# run Metro bundler in the background
npm start

# run Inji app directly to a connected device
npm run ios -- --device

Developing Android

Build via Android Studio

The app is available in this repository's frontend/android directory. Open this directory in Android Studio (version 4.1 and above) and the app can be built and run from there.

More info here: Build your app using Android Studio

Build via command line

You need Android SDK CLI to build APK.

# 1. Install dependencies
npm install

# Setup the environment variable for keystore
export RELEASE_KEYSTORE=release.keystore
export RELEASE_KEYSTORE_ALIAS=androidreleasekey
export RELEASE_KEYSTORE_PASSWORD=android
# https://hostname/residentmobileapp is the Mimoto service url
export BACKEND_SERVICE_URL=https://hostname/residentmobileapp

# Use DEBUG_KEYSTORE, DEBUG_KEYSTORE_ALIAS, DEBUG_KEYSTORE_PASSWORD for debug build

# Use one of following command to build the flavor you need.
# Build for Mosip Philippines test
npm run build:android:ph

# Build for Newlogic test
npm run build:android:newlogic

# Build for MOSIP test
npm run build:android:mosip

More info here: Build your app from the command line

Developing iOS

Build for TestFlight

1. Install all dependencies
   • npm install
   • npx pod-install
2. Open the ios/ directory in XCode
3. Set the build target to "Any iOS device (arm64)"
4. Use an Apple Developer account that can provision builds for release/TestFlight

5. Don't forget to bump the version number when creating an archive

6. Open the Product menu and from there click Archive

7. Once done you can follow the dialog wizard to distribute the app to TestFlight

8. Go to your App Store Connect dashboard to manage the newly-uploaded build.

More info here:

• React Native - Publishing to the App Store
• Apple Developer - Distributing Your App for Beta Testing and Releases

Credits

Credits listed here