Setup Mobile App

Demo Video

DIGIT Health Campaign Management Demo | DIGIT HCM

Overview

This guide provides step-by-step instructions to clone and run the DIGIT Health Campaign Management (HCM) App locally on your machine. The app is a Flutter application developed for health campaigns.

Pre-requisites

Before you begin, ensure that you have the following installed on your PC:

• Flutter 3.16.5 version

  • flutter setup for linux and android - flutter document
  • flutter setup for windows and android - flutter document
• Android device

Steps

1. Open a terminal and run the following commands:

   1. git clone https://github.com/egovernments/health-campaign-field-worker-app.git
   2. git checkout to branch installation-demo-setup
2. Open the project in your preferred IDE (Android Studio, Visual Studio Code). Make sure that your IDE is configured with the Flutter and Dart plugins.
3. Create a .env file inside the apps/health_campaign_field_worker_app folder.
4. copy the below contents to you newly created .env file

BASE_URL={replace with base url}
MDMS_API_PATH='mdms-v2/v1/_search'
TENANT_ID="mz"`
ACTIONS_API_PATH="access/v1/actions/mdms/_get"
SYNC_DOWN_RETRY_COUNT="3"
RETRY_TIME_INTERVAL="5"
CONNECT_TIMEOUT="120000"
RECEIVE_TIMEOUT="120000"
SEND_TIMEOUT="120000"
CHECK_BANDWIDTH_API="/project/check/bandwidth"
ENV_NAME="DEMO"

Steps to Generate APK

• After successfully setting up the env file, navigate to apps/health_campaign_field_worker_app folder in the terminal,
• Run the following command to generate the APK:

  flutter build apk --release --no-tree-shake-icons

• After successfully running the above command, the APK will be generated in the path

  apps/health_campaign_field_worker_app/build\app\outputs\flutter-apk\app-release.apk
• Install the generated APK on your preferred Android device.