Viele Apps haben einen benutzerdefinierten Onboarding-Ablauf für Workflows, z. B. um Nutzer über App-Funktionen zu informieren oder um die Nutzereinwilligung zu bitten. Um einen nahtlosen Verbindungs ablauf zu erstellen, kann Ihre App auch die Matchmaking API verwenden, um Nutzer aufzufordern, andere Apps zu verbinden, die Daten schreiben können, die Ihre App lesen kann.
Wenn Sie einen benutzerdefinierten Onboarding-Ablauf einbeziehen möchten, konfigurieren Sie Health Connect so, dass er automatisch gestartet wird, nachdem Berechtigungen gewährt wurden. Beachten Sie jedoch, dass die Matchmaking API diesen Trigger nicht unterstützt. Fügen Sie dazu 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 initiieren.
Versionsunterstützung
So unterstützen Sie Geräte mit Android-Versionen vor Android 14 und 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 für 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:
- Relevante Informationen für Nutzer anzeigen, z. B. welche Daten geschrieben oder gelesen werden.
- Den Nutzer gegebenenfalls um Einwilligung bitten.
- Eine Berechtigungsanfrage an Health Connect senden.
- Andere anwendungsspezifische Logik ausführen, z. B. einen periodischen Worker planen.
- Nach Abschluss der Aktivität dem Nutzer die Möglichkeit geben, sie zu schließen.
Bei Apps, die keine Onboarding-Aktivität exportieren, bringt Health Connect den Nutzer stattdessen zu dem Bildschirm Berechtigungen verwalten weiter, sobald er versucht, die App zu verbinden. Das ist möglicherweise für Apps akzeptabel, bei denen die Erteilung von Berechtigungen die einzige Voraussetzung für die Funktion der Integration ist.
Beachten Sie, dass die Onboarding-Aktivität möglicherweise mehrmals gestartet wird, z. B. wenn der Nutzer später Berechtigungen für Ihre App widerruft und sie dann wieder verbindet.