תוכנית למשתמשים חדשים

לאפליקציות רבות יש תהליך קליטה מותאם אישית, כמו הסבר על התכונות או בקשה לקבלת הסכמה מהמשתמשים. כדי לאפשר ל-Health Connect להפעיל את תהליך ההצטרפות, צריך להוסיף את הקטע הבא למניפסט:

<!-- 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>

המשתמשים יכולים להתחיל את הקישור לאפליקציה שלכם ישירות מאפליקציית Health Connect, ולא מתוך האפליקציה שלכם. אם האפליקציה שלכם דורשת אינטראקציה נוספת מעבר להענקת הרשאה לקרוא או לכתוב נתונים, עליכם לספק פעילות קליטה.

תמיכה בגרסאות

כדי לתמוך גם במכשירים עם Android מגרסה 14 ואילך וגם במכשירים עם גרסאות ישנות יותר של Android:

• הגישה המומלצת: יוצרים פעילות קליטה אחת שמטפלת בשני התרחישים. כדי לוודא את התאימות בגרסאות השונות של Android, אפשר להשתמש בכינוי לפעילות,כפי שמתואר בדוגמה.

• גישה חלופית: מייצאים שתי פעילויות נפרדות, אחת לכל גרסה של Android. הגישה הזו עשויה להוביל לעלייה ברמת המורכבות של התחזוקה.

דרישות לגבי פעילות שיוצאת

כשמשתמש מנסה לקשר את האפליקציה שלכם ל-Health Connect, הפעילות המיוצאת מופעלת. הפעילות הזו צריכה לבצע את הפעולות הבאות:

• להציג חומר חינוכי רלוונטי למשתמשים, כמו הסבר על הנתונים שנכתבים או נקראים.
• אם צריך, מבקשים מהמשתמש להביע הסכמה.
• שולחים בקשת הרשאות ל-Health Connect.
• לבצע לוגיקה אחרת ספציפית לאפליקציה, כמו תזמון של עובד תקופתי.
• בסיום, מאפשרים למשתמש לסגור את הפעילות.

באפליקציות שלא מייצאות פעילות של קליטת משתמשים, כשהמשתמש מנסה לחבר את האפליקציה, Health Connect מעביר אותו למסך ניהול ההרשאות. יכול להיות שזה מתאים לאפליקציות שבהן ההרשאות שהמשתמשים מעניקים הן התנאי היחיד להפעלת השילוב.

חשוב לדעת: ייתכן שהפעילות של תהליך ההצטרפות תופעל יותר מפעם אחת, למשל אם המשתמש יבטל מאוחר יותר את ההרשאות לאפליקציה ולאחר מכן יקיש על 'התחברות'.