Aby wdrożyć użytkowników do aplikacji, zalecamy stosowanie podanych niżej wskazówek.
Wprowadzanie aplikacji
Wiele aplikacji ma własny proces rejestracji, np. zapoznaj się z informacjami o funkcjach lub prosi użytkownika o zgodę na wykorzystanie danych. Zdecydowanie zalecamy deweloperom wyeksportowanie działania wprowadzającego, które Health Connect uruchamia, gdy użytkownik po raz pierwszy wejdzie w interakcję z aplikacją. Aby to zrobić, dodaj do pliku manifestu te elementy:
<!-- 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>
Uwaga: obsługa tej funkcji nie jest jeszcze dostępna na Androidzie 14, ale wkrótce się to zmieni.
Gdy użytkownik spróbuje połączyć Twoją aplikację z Health Connect, wyeksportowana aktywność zostanie uruchomiona. To działanie musi:
- wyświetlać odpowiednie informacje dla użytkownika, na przykład wyjaśniać, jakie dane są zapisywane lub odczytywane;
- W razie potrzeby poproś użytkownika o zgodę.
- Wyślij prośbę o uprawnienia do Health Connect.
- żadnych innych działań logicznych związanych z aplikacją, np. planowania okresowych procesów roboczych.
- Po zakończeniu zezwól użytkownikowi na odrzucenie działania.
W przypadku aplikacji, które nie eksportują aktywności wprowadzającej, Health Connect wyświetla ekran Zarządzanie uprawnieniami, gdy użytkownik próbuje połączyć aplikację. Może to być dopuszczalne w aplikacjach, w których jedynym wymogiem wstępnym integracji jest przyznanie uprawnień.
Pamiętaj, że aktywność wprowadzająca może zostać uruchomiona więcej niż raz, np. jeśli użytkownik później anuluje uprawnienia aplikacji i połączy ją ponownie.