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.