Membuat rencana untuk proses orientasi pengguna
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Banyak aplikasi memiliki alur orientasi kustom seperti edukasi tentang fitur atau meminta izin
pengguna. Agar Health Connect dapat meluncurkan alur orientasi, tambahkan
hal berikut ke manifes Anda:
<!-- 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>
Pengguna dapat memulai koneksi ke aplikasi Anda langsung dari aplikasi
Health Connect, bukan dari dalam aplikasi Anda. Jika aplikasi Anda memerlukan
interaksi tambahan selain diberi izin untuk membaca atau menulis data,
berikan aktivitas orientasi.
Dukungan versi
Untuk mendukung perangkat pra-Android 14 dan Android 14+:
Pendekatan yang direkomendasikan: Buat satu aktivitas orientasi yang menangani
kedua skenario. Gunakan alias aktivitas, seperti yang ditunjukkan dalam contoh,untuk memverifikasi
kompatibilitas di seluruh versi Android.
Pendekatan alternatif: Mengekspor dua aktivitas terpisah,
satu untuk setiap versi Android. Pendekatan ini dapat menyebabkan peningkatan kompleksitas
pemeliharaan.
Persyaratan aktivitas yang diekspor
Saat pengguna mencoba menghubungkan aplikasi Anda ke Health Connect, aktivitas
yang diekspor akan diluncurkan. Aktivitas ini harus melakukan hal berikut:
- Menampilkan edukasi pengguna yang relevan seperti menjelaskan data yang ditulis atau
dibaca.
- Meminta pengguna untuk memberikan izin jika diperlukan.
- Membuat permintaan izin ke Health Connect.
- Melakukan logika khusus aplikasi lainnya seperti menjadwalkan pekerja
berkala.
- Setelah selesai, mengizinkan pengguna menutup aktivitas.
Untuk aplikasi yang tidak mengekspor aktivitas orientasi, Health Connect
akan mengarahkan pengguna ke layar Kelola izin setelah pengguna mencoba
menghubungkan aplikasi. Hal ini dapat diterima untuk aplikasi yang hanya membutuhkan izin
yang diberikan sebagai satu-satunya prasyarat agar integrasi berfungsi.
Perhatikan bahwa aktivitas orientasi dapat diluncurkan lebih dari sekali, misalnya jika
pengguna nantinya mencabut izin ke aplikasi Anda, lalu menghubungkannya kembali.
Konten dan contoh kode di halaman ini tunduk kepada lisensi yang dijelaskan dalam Lisensi Konten. Java dan OpenJDK adalah merek dagang atau merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-27 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 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."]]
