Planowanie dotyczące wprowadzania użytkowników
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
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.
Treść strony i umieszczone na niej fragmenty kodu podlegają licencjom opisanym w Licencji na treści. Java i OpenJDK są znakami towarowymi lub zastrzeżonymi znakami towarowymi należącymi do firmy Oracle lub jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-27 UTC.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-07-27 UTC."],[],[],null,["# Plan for onboarding users\n\nMany apps have a custom onboarding flow such as feature education or asking user\nconsent. To enable Health Connect to launch your onboarding flow, add the\nfollowing to your manifest: \n\n \u003c!-- Required to support pre-Android 14 devices with APK Health Connect --\u003e\n \u003cactivity\n android:name=\".OnboardingActivity\"\n android:exported=\"true\"\n android:permission=\"com.google.android.apps.healthdata.permission.START_ONBOARDING\"\u003e\n \u003cintent-filter\u003e\n \u003caction android:name=\"androidx.health.ACTION_SHOW_ONBOARDING\"/\u003e\n \u003c/intent-filter\u003e\n \u003c/activity\u003e\n \u003c!-- Required to support Android 14+ devices with platform Health Connect --\u003e\n \u003cactivity-alias\n android:name=\"UAndAboveOnboardingActivity\"\n android:exported=\"true\"\n android:targetActivity=\".OnboardingActivity\"\n android:permission=\"android.permission.health.START_ONBOARDING\"\u003e\n \u003cintent-filter\u003e\n \u003caction android:name=\"android.health.connect.action.SHOW_ONBOARDING\" /\u003e\n \u003c/intent-filter\u003e\n \u003c/activity-alias\u003e\n\nUsers may initiate the connection to your app directly from the Health\nConnect app, rather than from within your app. If your app requires any\nadditional interaction beyond being granted permission to read or write data,\nprovide an onboarding activity.\n\nVersion support\n---------------\n\nTo support both pre-Android 14 and Android 14+ devices:\n\n- **Recommended approach:** Create a single onboarding activity that handles\n both scenarios. Use an activity alias, as shown in the example,to verify\n compatibility across Android versions.\n\n- **Alternative approach:** Export two separate activities,\n one for each Android version. This approach may lead to increased maintenance\n complexity.\n\nExported activity requirements\n------------------------------\n\nWhen a user attempts to connect your app to Health Connect, the exported\nactivity is launched. This activity must do the following:\n\n- Display any relevant user education such as explaining what data is written or read.\n- Ask the user to grant consent if required.\n- Make a permissions request to Health Connect.\n- Carry out any other application specific logic such as scheduling a periodic worker.\n- Once complete, allow the user to dismiss the activity.\n\nFor apps that *don't* export an onboarding activity, Health Connect instead\nbrings the user to the **Manage permissions** screen once the user attempts to\nconnect the app. This may be acceptable for apps where permissions being\ngranted is the only prerequisite for the integration to function.\n\nNote that the onboarding activity may be launched more than once, for example if\nthe user later revokes permissions to your app and then reconnects it."]]
