Bạn nên làm theo hướng dẫn sau để giới thiệu người dùng vào ứng dụng của bạn.
Làm quen với ứng dụng
Nhiều ứng dụng có quy trình làm quen với ứng dụng tuỳ chỉnh, chẳng hạn như hướng dẫn về tính năng hoặc yêu cầu sự đồng ý của người dùng. Nhà phát triển nên xuất hoạt động làm quen với ứng dụng mà Health Connect khởi chạy khi người dùng tương tác với ứng dụng đó lần đầu tiên. Để thực hiện việc này, hãy thêm nội dung sau vào tệp kê khai:
<!-- 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.ACTION_SHOW_ONBOARDING" />
</intent-filter>
</activity-alias>
Xin lưu ý rằng tính năng này chưa được hỗ trợ trên Android 14 nhưng sẽ sớm ra mắt.
Khi một người dùng cố gắng kết nối ứng dụng của bạn với Health Connect, hoạt động đã xuất sẽ được khởi chạy. Hoạt động này phải thực hiện những việc sau:
- Hiện mọi hướng dẫn có liên quan cho người dùng, chẳng hạn như giải thích loại dữ liệu được ghi hoặc được đọc.
- Yêu cầu người dùng đồng ý nếu cần.
- Gửi yêu cầu quyền đến Health Connect.
- Thực hiện mọi logic khác dành riêng cho ứng dụng, chẳng hạn như lên lịch cho một trình thực thi định kỳ.
- Sau khi hoàn tất, hãy cho phép người dùng đóng hoạt động đó.
Đối với các ứng dụng không xuất hoạt động làm quen với ứng dụng, Health Connect sẽ đưa người dùng đến màn hình Quản lý quyền sau khi người dùng cố gắng kết nối ứng dụng đó. Điều này có thể chấp nhận được đối với các ứng dụng mà quyền được cấp là điều kiện tiên quyết duy nhất để quá trình tích hợp diễn ra.
Lưu ý rằng người dùng có thể khởi chạy hoạt động làm quen với ứng dụng nhiều lần, chẳng hạn như nếu sau đó người dùng thu hồi các quyền đối với ứng dụng rồi kết nối lại.