Wir empfehlen die folgende Anleitung, um Nutzer für Ihre App einzurichten.
App einrichten
Viele Apps haben einen benutzerdefinierten Onboarding-Ablauf, z. B. werden Informationen zu Funktionen bereitgestellt oder die Nutzereinwilligung eingeholt. Entwicklern wird dringend empfohlen, eine Onboarding-Aktivität zu exportieren, die Health Connect startet, wenn der Nutzer zum ersten Mal mit der App interagiert. Füge dazu Folgendes in dein Manifest ein:
<!-- Required to support pre-Android 14 devices with APK Health Connect -->
<activity
android:name=".OnboardingActivity"
android:exported="true"
android:permission="com.google.android.apps.healthdata.permission.START_ONBOARDING"
<intent-filter>
<action android:name="androidx.health.ACTION_SHOW_ONBOARDING"/>
</intent-filter>
</activity>
<!-- Required to support Android 14+ devices with platform Health Connect -->
<activity-alias
android:name="UAndAboveOnboardingActivity"
android:exported="true"
android:targetActivity=".OnboardingActivity"
android:permission="android.permission.health.START_ONBOARDING">
<intent-filter>
<action android:name="android.health.connect.action.ACTION_SHOW_ONBOARDING" />
</intent-filter>
</activity-alias>
Diese Funktion wird unter Android 14 noch nicht unterstützt, wir arbeiten aber daran.
Wenn ein Nutzer versucht, Ihre App mit Health Connect zu verbinden, wird die exportierte Aktivität gestartet. Diese Aktivität muss folgende Voraussetzungen erfüllen:
- Zeigen Sie alle relevanten Nutzerinformationen an, z. B. erklären, welche Daten geschrieben oder gelesen werden.
- Bitten Sie den Nutzer gegebenenfalls, seine Einwilligung zu geben.
- Senden Sie eine Berechtigungsanfrage an Health Connect.
- Ausführen einer beliebigen anderen anwendungsspezifischen Logik, z. B. zum Planen eines regelmäßigen Workers
- Wenn der Vorgang abgeschlossen ist, erlauben Sie dem Nutzer, die Aktivität zu schließen.
Bei Apps, die keine Onboarding-Aktivität exportieren, leitet Health Connect den Nutzer stattdessen zum Bildschirm Berechtigungen verwalten weiter, sobald er versucht, eine Verbindung mit der App herzustellen. Das kann bei Apps zulässig sein, bei denen das Erteilen von Berechtigungen die einzige Voraussetzung für die Integration sind.
Die Onboarding-Aktivität kann mehrmals gestartet werden, z. B. wenn der Nutzer später die Berechtigungen für deine App widerruft und sie dann wieder verbindet.