Wiele aplikacji ma własny proces wprowadzania, np. informowanie o funkcjach lub proszenie o zgodę użytkownika. Aby umożliwić Health Connect uruchamianie procesu wprowadzania, dodaj do pliku manifestu:
<!-- 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>
Użytkownicy mogą nawiązywać połączenie z Twoją aplikacją bezpośrednio z Health Connect, a nie z aplikacji. Jeśli Twoja aplikacja wymaga dodatkowej interakcji oprócz przyznania uprawnień do odczytu lub zapisu danych, udostępnij aktywność wdrożenia.
Obsługa wersji
Aby obsługiwać urządzenia z Androidem 14 i starszymi:
Zalecane podejście: utwórz jedną aktywność wprowadzającą, która obsługuje oba scenariusze. Aby sprawdzić zgodność w różnych wersjach Androida, użyj aliasu aktywności,jak w tym przykładzie.
Alternatywne podejście: wyeksportuj 2 osobne aktywności, po jednej dla każdej wersji Androida. Takie podejście może zwiększyć złożoność konserwacji.
Wymagania dotyczące eksportowanej aktywności
Gdy użytkownik spróbuje połączyć Twoją aplikację z Health Connect, zostanie uruchomiona wyeksportowana aktywność. Ta aktywność musi:
- wyświetlać odpowiednie informacje edukacyjne, na przykład wyjaśniające, jakie dane są zapisywane lub odczytywane;
- W razie potrzeby poproś użytkownika o wyrażenie zgody.
- Prześlij prośbę o uprawnienia do Health Connect.
- Wykonywanie innych działań związanych z aplikacją, takich jak planowanie działania okresowego.
- Po zakończeniu działania pozwól użytkownikowi zamknąć okno.
W przypadku aplikacji, które nie eksportują aktywności wprowadzającej, Health Connect przekierowuje użytkownika do ekranu Zarządzanie uprawnieniami, gdy użytkownik spróbuje połączyć aplikację. Może to być akceptowalne w przypadku aplikacji, w których przypadku przyznanie uprawnień jest jedynym warunkiem wstępnym umożliwiającym integrację.
Pamiętaj, że proces wprowadzania może być uruchamiany wielokrotnie, np. jeśli użytkownik cofnie uprawnienia do aplikacji, a potem ponownie się z nią połączy.