Wir empfehlen die folgende Anleitung, um Nutzer für Ihre App einzurichten.
App einrichten
Viele Apps haben einen benutzerdefinierten Ablauf, z. B. um Informationen zu Funktionen zu erhalten oder den Nutzer zu fragen Einwilligung geben. Entwicklern wird dringend empfohlen, eine Onboarding-Aktivität zu exportieren die Health Connect gestartet wird, wenn der Nutzer mit der App für die beim ersten Mal. 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>
Bitte beachte, dass diese Funktion unter Android 14 noch nicht unterstützt wird. aber bald verfügbar.
Wenn ein Nutzer versucht, Ihre App mit Health Connect zu verbinden, werden die exportierten Daten wird gestartet. Diese Aktivität muss folgende Voraussetzungen erfüllen:
- Zeigen Sie alle relevanten Nutzerinformationen an, z. B. erklären, welche Daten geschrieben werden oder gelesen werden.
- Bitten Sie den Nutzer gegebenenfalls, seine Einwilligung zu erteilen.
- Stellen Sie eine Berechtigungsanfrage an Health Connect.
- Ausführung anderer anwendungsspezifischer Logik, z. B. der Planung einer Worker.
- Wenn der Vorgang abgeschlossen ist, erlauben Sie dem Nutzer, die Aktivität zu schließen.
Für Apps, die keine Onboarding-Aktivität exportieren, wird stattdessen Health Connect verwendet leitet den Nutzer zum Bildschirm Berechtigungen verwalten weiter, sobald er versucht, verbinden Sie die App. Das kann bei Apps möglich sein, deren Berechtigungen gewährt wurde, ist die einzige Voraussetzung dafür, dass die Integration funktioniert.
Beachten Sie, dass die Onboarding-Aktivität mehrmals gestartet werden kann, z. B. wenn Der Nutzer widerruft später die Berechtigungen für Ihre App und verbindet sie dann noch einmal.