Data4life FHIR SDK for Android/Java

Data4life FHIR SDK for Android/Java

Minimal FHIR standard models and data types of STU3 and R4 for Android and Java

Explore the docs »

Report Bug · Request Feature

Table Of Contents

• Documentation
• Installation
  • Gradle
• Maintenance
  • Requirements
  • Build
• Dependencies

Documentation

Check current documentation

Installation

Add the following maven repository url to your root build.gradle:

allprojects {
    repositories {
        ...
        maven {
            url = URI("https://maven.pkg.github.com/d4l-data4life/hc-fhir-sdk-java")
            credentials {
                username = project.findProperty("gpr.user") as String? ?: System.getenv("PACKAGE_REGISTRY_USERNAME")
                password = project.findProperty("gpr.key") as String? ?: System.getenv("PACKAGE_REGISTRY_TOKEN")
            }
        }
    }
}

Your GitHub username and token needs to be stored in your global Gradle properties: ~/.gradle/gradle.properties

NOTICE

You need to have read access to this repository and generate a personal access token with repo, write:packages and read:packages scope.

gpr.user=github-username
gpr.key=github-token

Gradle

Add following dependencies to your app build.gradle.

dependencies {
    implementation "care.data4life.hc-fhir-sdk-java:fhir-java:$version"
}

Maintenance

Requirements

• Android Studio 7.1.3

• Java 8

• Gradle 7.4.2

• Python 3.5

• Ruby

• Bundler

• Fastlane

Build

Description

fastlane is used to manage fhir-parser and integrate generated models into fhir-java project

fhir-parser is used to generate Java models from JSON examples for latest FHIR standard

Required resources include: * Base classes for primitive data types * Rules and templates for mapping * Settings with custom profiles and build targets

git submodule update --init --recursive
(for furst time installation)

Generating models

bundle exec fastlane generate_fhir_java_models

After generating the models please run a reformat code on the fhir-java/src-gen folder and make sure the test in ObservationTest and PatientTest adjustments are still in place.

Known issues with FHIR standard

• String / Integer / Bool / URL are basic Java types and should inherit from FHIR Element in future versions.

Dependencies

• Moshi JSON library

• fhir-parser as FHIR model generator