Android Registration Client - Feature Flutter

This repository contains the Android Registration Client software for MOSIP. The feature-flutter branch focuses on integrating Flutter into the client.

Setup

To set up the Android Registration Client with Flutter and Android Studio, follow these steps:

Prerequisites

• Flutter SDK (>3.10): Install Flutter by following the official Flutter installation guide.

• Android Studio (or Any IDE of your choice): Download and install Android Studio from the official Android Studio website.

Clone the Repository:

1. The feature-flutter branch of android-reg-client is currently being actively developed. If you wish to access this branch, you can clone the repository by executing the following command in your terminal. Alternatively, you can download one of the releases available in the repository's release section.

   Code Block
   language bash
   git clone -b feature-flutter https://github.com/mosip/android-registration-client.git

Active Branches:

• developer-release/flutter/0.9.x (developer release branch)

• feature-flutter (active development branch)

Set Up Flutter in Android Studio

1. Open Android Studio.

2. Click on “Open an existing Android Studio project" and navigate to the cloned repository.

3. Open the android-registration-client directory as a project in Android Studio.

4. Install the Flutter plugin for Android Studio by going to File > Settings > Plugins and searching for "Flutter". Click on "Install" to install the plugin.

5. Configure the Flutter SDK path by going to File > Settings > Languages & Frameworks > Flutter and setting the Flutter SDK path to the location where you installed Flutter.

6. Click on the "Apply" button to save the changes.

Customising the Registration Client:

• Styling of the application can be configured by modifying these files
  lib/utils/app_style.dart, lib/utils/app_config.dart

• Application language bundles can be added to this path lib/l10n

• Label and application logo can be changed here android/app/src/main/AndroidManifest.xml

Build and Run the Application.

1. pigeon.sh file contains all the commands required to download dependencies and generate flutter - android native communication code. Run the pigeon.sh file or the commands within the file individually.

2. Connect an Android device or start an Android emulator.

3. Open the terminal in Android Studio or use the terminal outside of Android Studio.

4. Navigate to the android-registration-client directory.

5. Run the following command to build and run the application:

   Code Block
   language bash
   flutter run

Build debug and release APK.

// Debug APK
flutter build apk --debug

// Release APK
flutter build apk --release

Set up Mock MDS for Biometric Scan.

1. Install the mock mds application.

2. Open “SETTINGS“

3. In Device Config, select: “Registration” from dropdown

4. In P12 Config:

   1. Fill Device Key credentials and upload Device P12 file.

   2. Fill FTM Key credentials and upload FTM P12 file.

   3. Fill all fields in MOSIP IDA Config.

5. In Modality Config,set the quality score for Face, Finger and Iris.

6. Click on “SAVE”.

7. Then on Home Page, click “LOAD AND VALIDATE CERTIFICATES“.

8. Result for validation success will be displayed as toast message.

Contributing

If you would like to contribute to the Android Registration Client, please follow the guidelines outlined here.

License

The Android Registration Client is licensed under the Apache License 2.0.

Support

If you encounter any issues or have any questions, please open an issue on the GitHub repository.

Sources

1. GitHub - mosip/android-registration-client: Reference Android Registration Client Software - WIP

2. Flutter - Get started: Install

3. Android Studio - Download