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

כדי לצרף משתמשים לאפליקציה, מומלץ לפעול לפי ההנחיות הבאות.

הצטרפות לאפליקציה

באפליקציות רבות יש תהליך הצטרפות מותאם אישית, כמו הסבר על תכונות או שליחת בקשה למשתמשים לקבל הסכמה. מומלץ מאוד למפתחים לייצא פעילות של הדרכה למשתמשים חדשים ש-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.ACTION_SHOW_ONBOARDING" />
  </intent-filter>
</activity-alias>

חשוב לשים לב שהתכונה הזו עדיין לא זמינה ב-Android 14 אבל בקרוב.

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

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

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

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