The OpenSRP Antenatal Care (ANC) library packages WHO-aligned ANC contact workflows, configurable forms, and supporting data stores for OpenSRP-based Android clients.

• Tooling: Gradle 8.7 · Android Gradle Plugin 8.6.0 · Java 17 (no Kotlin plugin applied)
• CI: no hosted pipeline; run Gradle builds locally before raising a PR
• Default branch: master
• Latest tag: v3.0.1 (2025-10-13)

• Digitised ANC register, contact, and counseling flows aligned with WHO guidelines
• Configurable site/population characteristics with device-to-server sync helpers
• JSON form rendering + rule-engine utilities for dynamic contact tasks and alerts
• Repositories for contact payloads, partial forms, and scheduled task management

The table below retains the historical breakdown of library capabilities and upstream dependencies.

• JDK 17 (Temurin or OpenJDK recommended)
• Android Gradle Plugin 8.6.0 with Gradle 8.7
• Kotlin: not required (Java codebase)
• Android Studio Koala / Flamingo or newer with SDK Manager access
• Android SDK: compileSdk 35, targetSdk 35, minSdk 28, Build Tools 35.0.0

Add the library from Maven Central:

repositories { mavenCentral() }
dependencies {
  implementation 'org.smartregister:opensrp-client-anc:<version>' // see Releases for the latest version
}

repositories { mavenCentral() }
dependencies {
  implementation("org.smartregister:opensrp-client-anc:<version>") // see Releases for the latest version
}

Initialise the library inside your OpenSRP application class after CoreLibrary.init and repository setup:

public class AncApplication extends DrishtiApplication {
  @Override
  public void onCreate() {
    super.onCreate();

    Context opensrpContext = Context.getInstance();
    opensrpContext.updateApplicationContext(getApplicationContext());

    ActivityConfiguration configuration = new ActivityConfiguration();
    configuration.setHomeRegisterActivityClass(CustomHomeRegisterActivity.class);

    AncLibrary.init(opensrpContext, BuildConfig.DATABASE_VERSION, configuration, new ANCEventBusIndex());
  }
}

Replace CustomHomeRegisterActivity and ANCEventBusIndex with your concrete implementations.

// Retrieve and persist ANC contact tasks
ContactTasksRepository tasksRepository = AncLibrary.getInstance().getContactTasksRepository();
Task nutritionTask = new Task(baseEntityId, "anc_contact_nutrition", "pending", false, false);
tasksRepository.saveOrUpdateTasks(nutritionTask);

// Load the ANC register form definition for custom preprocessing
JSONObject registerForm = AncLibrary.getJsonSpecHelper()
    .getFormJson(getApplicationContext(), ConstantsUtils.JsonFormUtils.ANC_REGISTER);

// Launch the contact workflow for a client
Intent contactIntent = new Intent(context, MainContactActivity.class);
contactIntent.putExtra(ConstantsUtils.IntentKeyUtils.BASE_ENTITY_ID, baseEntityId);
contactIntent.putExtra(ConstantsUtils.IntentKeyUtils.CONTACT_NO, contactNumber);
contactIntent.putExtra(ConstantsUtils.IntentKeyUtils.CLIENT_MAP, clientDetailsMap);
context.startActivity(contactIntent);

A reference implementation lives in sample/.

• Install on a connected device or emulator: ./gradlew :sample:installDebug
• Open the project in Android Studio to explore run configurations and tweak local properties.

• Full build (skipping the legacy reference app module): ./gradlew clean assemble -PskipReferenceApp=true
• Unit tests: ./gradlew :opensrp-anc:testDebugUnitTest -PskipReferenceApp=true

Published versions and changelogs are listed at GitHub Releases. Use the latest stable tag when updating <version> in your build scripts.

Contributions and issue reports are welcome. Before opening a pull request:

• Ensure builds and tests pass with the toolchain noted above.
• Review the OpenSRP developer guide and related setup notes.
• Discuss larger enhancements via issues for early feedback.

Distributed under the Apache License 2.0. See LICENSE for details.