Viele Apps haben einen benutzerdefinierten Onboarding-Vorgang, z. B. eine Funktionseinführung oder die Einholung der Nutzereinwilligung. Damit Health Connect den Onboarding-Vorgang starten kann, fügen Sie Ihrem Manifest Folgendes hinzu:
<!-- 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.SHOW_ONBOARDING" />
</intent-filter>
</activity-alias>
Nutzer können die Verbindung zu Ihrer App direkt über die Health Connect App und nicht über Ihre App herstellen. Wenn für Ihre App neben der Berechtigung zum Lesen oder Schreiben von Daten noch weitere Interaktionen erforderlich sind, müssen Sie eine Einrichtungsaktivität bereitstellen.
Versionsunterstützung
So unterstützen Sie sowohl Geräte mit Android 14 als auch Geräte mit Android 14 und höher:
Empfohlener Ansatz:Erstellen Sie eine einzelne Onboarding-Aktivität, die beide Szenarien abdeckt. Verwenden Sie einen Aktivitätsalias, wie im Beispiel gezeigt,um die Kompatibilität mit verschiedenen Android-Versionen zu prüfen.
Alternativer Ansatz:Exportieren Sie zwei separate Aktivitäten, eine für jede Android-Version. Dieser Ansatz kann zu einer höheren Wartungskomplexität führen.
Anforderungen an exportierte Aktivitäten
Wenn ein Nutzer versucht, Ihre App mit Health Connect zu verbinden, wird die exportierte Aktivität gestartet. Diese Aktivität muss Folgendes tun:
- Zeigen Sie alle relevanten Informationen für Nutzer an, z. B. welche Daten geschrieben oder gelesen werden.
- Bitten Sie den Nutzer gegebenenfalls um seine Einwilligung.
- Sie stellen eine Berechtigungsanfrage an Health Connect.
- Andere anwendungsspezifische Logik ausführen, z. B. die Planung eines periodischen Workers
- Lassen Sie den Nutzer die Aktivität schließen, sobald sie abgeschlossen ist.
Bei Apps, die keine Einrichtungsaktivität exportieren, wird der Nutzer in Health Connect stattdessen zum Bildschirm Berechtigungen verwalten weitergeleitet, wenn er versucht, die App zu verbinden. Das ist für Apps akzeptabel, bei denen die Gewährung von Berechtigungen die einzige Voraussetzung für die Funktion der Integration ist.
Die Einrichtungsaktivität kann mehrmals gestartet werden, z. B. wenn der Nutzer die Berechtigungen für Ihre App später widerruft und dann wieder eine Verknüpfung herstellt.