Generika Android

Generika App for Android, based on the Generikacc App for iOS.

Screenshots

Repository

https://github.com/zdavatz/generika_android

It's available on Google Play.

Features

• Barcode scanning (EAN-13, GS1 DataMatrix, QR Code)
• Price comparison between Original and Generic drugs
• Patient information (package leaflet) and Professional information (Fachinfo)
• Drug interaction check — local offline lookup using interactions.db from pillbox.oddb.org with 3-tier matching (same logic as oddb.org):
  1. EPha curated ATC-to-ATC interactions (~16k pairs)
  2. Substance-level interactions from Swissmedic FI (~47k entries)
  3. Class-level interactions via ATC keyword search in FachInfo text
  4. Gegenrichtung severity hints — compares FI text severity in both directions and warns when they differ
• Prescription import via AmiKo Desitin (.amk files)
• Expiry date tracking with LOT number display
• ZurRose prescription forwarding
• Automatic database download on first launch — pharmaceutical DB (downloaded as zip) and interactions DB are fetched sequentially with progress display; database stats visible in Settings
• Kostengutsprache (KVV 71) — IBD Gastroenterology cost approval form with patient, insurance, diagnosis, medication, and physician fields; PDF generation and share via email or other apps
• Insurance Card Scanner — OCR-based Swiss health insurance card scanner using ML Kit Text Recognition and CameraX; extracts name, card number, AHV, BAG number, birth date, gender; maps BAG to insurer name via JSON lookup tables
• Prescription Scanner — Two-stage scanner: live QR code detection for CHMED16A e-prescriptions + full-page OCR to extract medications, dosages, physician info, patient address, AHV and ZSR numbers

Platform

• >= Android 12.0 (API Level 31)
• minSdkVersion 23
• targetSdkVersion 31

Setup

Requirements

• IcedTea 3.6 (OpenJDK 8)
• Play Service Vision API (For Barcode Detection)

IcedTea

E.g. on Gentoo Linux

# use icedtea or icedtea-bin with `gtk` USE flag for X11
❯❯❯ equery l -po icedtea
 * Searching for icedtea ...
[IP-] [  ] dev-java/icedtea-3.6.0:8

You may want also following packages:

• dev-util/android-sdk-update-manager
• dev-util/android-tools ( for adb or fastboot etc.)

See a link below about Android specific packages.

https://wiki.gentoo.org/wiki/Android

Play Service (Vision API)

It's automatically prepared before initial boot on device. This application is needed.

https://play.google.com/store/apps/details?id=com.google.android.gms&hl=en

ZurRose Credentials

• Copy the client cert to /app/src/main/assets/client.p12.
• Copy /app/src/main/java/org/oddb/generika/util/Secrets.java.sample to Secrets.java and fill in the password for the p12 file.

Build

# via gradlew
% make build

# create apk (debug)
% make archive
# or
% gradle assembleDebug

# create apk (release)
% make release
# or
% gradle assembleRelease

Run

See targets run (connected emulator device).

# list your virtual devices
% make run ARGS="-list-avds"
./bin/emulator -list-avds
Nexus_5X_API_25
Nexus_5X_API_26
Nexus_5_API_27
Pixel_2_API_26
Pixel_2_API_27
Pixel_2_XL_API_26
...

# run
% make run ARGS="-avd Nexus_5_API_27"

For example, build-run-stop (cycle) will be like this: (at console, run an emulator on X11 DISPLAY)

# pass $ARGS to gradlew
% make build ARGS="-x lint"

# run on your X11 DISPLAY ;)
% DISPLAY=":0" make run ARGS="-avd Nexus_5_API_27"

% make stop

Debugging Steps

Run the app on your device (connected via usb/wifi)

# kill/start server
% make serve
...
* daemon not runnig; starting now at tcp:5037
* daemon started successfully

% make start ARGS="5555"
% make attach ARGS="<DEVICE_IP_ADDRESS>:5555"
% make list

% make archive
% make install ARGS="..."

# start application

# tail only application logs from attached process
% make log

% make detach

Test

Run JUnit Tests.

# via gradlew
% make test
% make test ARGS="--debug"
% make test ARGS="--stacktrace"

% make test ARGS="--tests \"*Barcode*\""

Upload to Google Play Store

App Bundle (recommended)

# build + upload to production in one step
./apkup_bundle

# or upload to a specific track
./apkup_bundle beta

Requires generika.json (service account credentials) in the project root and the android-bundle-uploader tool in ../android-bundle-uploader/.

APK (legacy)

• Install Playup from https://github.com/jeduan/playup
• Setup your json File with the security credentials
• In the Console type: playup -a generika.json /path/to/app-release.apk

License

GPL-3.0

Generika Android
Copyright (c) 2018 ywesee GmbH

See LICENSE.txt.

Some parts of barcode detection work with Android Mobile Vision API using extended codes based on codes which are included in samples project provided by The Android Open Source Project as APACHE-2.0.

https://apache.org/licenses/GPL-compatibility.html

Apache 2 software can therefore be included in GPLv3 projects, because
the GPLv3 license accepts our software into GPLv3 works. However, GPLv3
software cannot be included in Apache projects. The licenses are incompatible
in one direction only, and it is a result of ASF's licensing philosophy and
the GPLv3 authors' interpretation of copyright law.

/*
 * Copyright (C) The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

See googlesamples/android-vision.

French Translations

Dr. André Dubied