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

להרבה אפליקציות יש תהליך מותאם אישית להצגת האפליקציה למשתמשים, למשל כדי להסביר למשתמש על התכונות של האפליקציה או כדי לבקש את הסכמתו. כדי ליצור תהליך חיבור חלק, האפליקציה יכולה גם להשתמש ב-Matchmaking API כדי להציג למשתמשים בקשה להתחבר לאפליקציות אחרות שיכולות לכתוב נתונים שהאפליקציה שלכם מוגדרת לקרוא.

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

<!-- 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.
• ביצוע לוגיקה ספציפית לאפליקציה, כמו תזמון של worker תקופתי.
• אחרי שהפעילות מסתיימת, המשתמש יכול לסגור אותה.

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

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