Lập kế hoạch cho người dùng 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. Để cho phép Health Connect chạy quy trình giới thiệu, 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.SHOW_ONBOARDING" />
  </intent-filter>
</activity-alias>

Người dùng có thể bắt đầu kết nối với ứng dụng của bạn ngay từ ứng dụng Health Connect, thay vì từ bên trong ứng dụng của bạn. Nếu ứng dụng của bạn yêu cầu bất kỳ hoạt động tương tác nào khác ngoài việc cấp quyền đọc hoặc ghi dữ liệu, hãy cung cấp một hoạt động làm quen.

Hỗ trợ phiên bản

Cách hỗ trợ cả thiết bị chạy Android trước 14 và thiết bị chạy Android 14 trở lên:

  • Phương pháp đề xuất: Tạo một hoạt động làm quen duy nhất để xử lý cả hai trường hợp. Sử dụng bí danh hoạt động, như trong ví dụ,để xác minh khả năng tương thích trên các phiên bản Android.

  • Phương pháp thay thế: Xuất hai hoạt động riêng biệt, một hoạt động cho mỗi phiên bản Android. Phương pháp này có thể làm tăng độ phức tạp của việc bảo trì.

Yêu cầu đối với hoạt động đã xuấ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.