Wiele aplikacji ma niestandardowy proces wdrażania dla przepływów pracy, który służy np. do informowania użytkownika o funkcjach aplikacji lub proszenia go o zgodę użytkownika. Aby zapewnić płynne połączenie, aplikacja może też używać interfejsu Matchmaking API, aby prosić użytkowników o połączenie innych aplikacji, które mogą zapisywać dane, które Twoja aplikacja jest skonfigurowana do odczytu.
Aby uwzględnić niestandardowy proces wdrażania, skonfiguruj Health Connect tak, aby uruchamiał go automatycznie po przyznaniu uprawnień. Pamiętaj jednak, że interfejs Matchmaking API nie obsługuje tego wyzwalacza. Aby to zrobić, dodaj do pliku manifestu te informacje:
<!-- 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ą inicjować połączenie z Twoją aplikacją bezpośrednio z aplikacji Health Connect, a nie z Twojej aplikacji.
Obsługa wersji
Aby obsługiwać urządzenia z Androidem w wersji starszej niż 14 i Androidem 14 lub nowszym:
Zalecane rozwiązanie: utwórz jedną aktywność wdrażania, która obsługuje oba scenariusze. Aby sprawdzić zgodność z różnymi wersjami Androida, użyj aliasu aktywności,jak pokazano w przykładzie.
Alternatywne rozwiązanie: wyeksportuj 2 osobne aktywności – po jednej na każdą wersję Androida. To rozwiązanie 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 dla użytkownika, np. wyjaśniać, jakie dane są zapisywane lub odczytywane;
- w razie potrzeby poprosić użytkownika o wyrażenie zgody;
- wysłać prośbę o uprawnienia do Health Connect;
- wykonać inne działania specyficzne dla aplikacji, np. zaplanować okresowe działanie;
- po zakończeniu umożliwić użytkownikowi zamknięcie aktywności.
W przypadku aplikacji, które nie eksportują aktywności wprowadzającej, Health Connect przekierowuje użytkownika do ekranu Zarządzaj uprawnieniami , gdy użytkownik spróbuje połączyć aplikację. Może to być akceptowalne w przypadku aplikacji, w których przyznanie uprawnień jest jedynym warunkiem wstępnym do działania integracji.
Pamiętaj, że aktywność wdrażania może zostać uruchomiona więcej niż raz, np. jeśli użytkownik później cofnie uprawnienia do Twojej aplikacji, a następnie ponownie ją połączy.