תחילת העבודה ב-Android

במדריך הזה נסביר איך מתחילים לפתח עם Google Fit ב-Android.

הגדרה

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

כדי להשתמש בממשקי ה-API של Google Fit, צריך חשבון Google. אתם יכולים ליצור חשבון חדש או להשתמש בחשבון קיים. כדאי ליצור חשבון נפרד כדי לבדוק את האפליקציה מנקודת המבט של משתמש.

מורידים את ספריית הלקוח העדכנית של Google Play Services למארח הפיתוח:

  1. פותחים את Android SDK Manager.
  2. בקטע SDK Tools, מחפשים את Google Play Services.
  3. אם הסטטוס של החבילות האלה הוא לא Installed, בוחרים בשתיהן ולוחצים על Install Packages.

כדי להפעיל את Fitness API, מקבלים מזהה לקוח ב-OAuth 2.0.

מומלץ להשתמש בסביבת הפיתוח של Android Studio כדי ליצור אפליקציה עם Fitness API. במאמר יצירת פרויקט מוסבר איך יוצרים פרויקט חדש ומגדירים אותו ב-Android Studio.

ב-Android Studio, פותחים את הקובץ build.gradle של המודול ומוסיפים את ספריית הלקוח של Google Play Services כיחס תלות:

Kotlin DSLGroovy DSL
plugin {
    id("com.android.application")
}

...

dependencies {
        implementation("com.google.android.gms:play-services-fitness:21.2.0")
        implementation("com.google.android.gms:play-services-auth:21.3.0")
}
 
apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-fitness:21.2.0'
    implementation 'com.google.android.gms:play-services-auth:21.3.0'
}

כך Gradle מוריד באופן אוטומטי את ה-SDK של Fitness כשמפתחים את האפליקציה.

פיתוח ובדיקה של האפליקציה

אחרי שתסיימו את שלבי ההגדרה, תוכלו להתחיל לפתח את האפליקציה. כדי להתחיל, כדאי לקרוא על סוגי הנתונים שהאפליקציה יכולה לאחסן ולקרוא. מידע נוסף על עבודה עם נתונים ב-Google Fit

כדי לקרוא ולכתוב סוגי נתונים מסוימים, האפליקציה צריכה לבקש הרשאות ל-Android.

סוגי הנתונים שאפליקציה יכולה לגשת אליהם תואמים להיקפי ההרשאה. כדי לבקש את ההרשאות האלה, צריך להוסיף את סוגי הנתונים שאפליקציה צריכה גישה אליהם במכונה FitnessOptions. כשהאפליקציה מבקשת להשתמש באחד מסוגי הנתונים של Google Fit, ה-Android SDK בודק באופן אוטומטי לאילו היקפי הרשאות הם שייכים ומבקש מהמשתמש הרשאה להיקפי ההרשאות האלה.

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

  • SensorsClient: גישה למקורות שונים של נתוני בריאות ואיכות חיים מחיישני חומרה במכשיר המקומי ובמכשירים נלווים.
  • RecordingClient: לאיסוף נתוני חיישנים ברקע, כל הזמן, בצריכת אנרגיה נמוכה.
  • HistoryClient: הוספה, מחיקה וקריאה של נתונים היסטוריים ב-Google Fit.
  • SessionsClient: יצירת סשנים של פעילות משתמשים וניהול שלהם.
  • GoalsClient: קריאת היעדים של נקודות הלב והצעדים שנוצרו על ידי משתמשים ב-Google Fit.
  • ConfigClient: גישה להגדרות ולסוגי נתונים מותאמים אישית בפלטפורמת Google Fit.

דוגמה ליצירת לקוח של Fitness API

התהליך שמתרחש לאחר מכן הוא תהליך ההרשאה שבו המשתמשים נתקלים כשהם מתבקשים להעניק הרשאות:

איור 1. תהליך ההרשאה למשתמשים.
  1. הרשאות Android: המשתמשים רואים אילו הרשאות Android ביקשה האפליקציה שלכם לפני שהם מורידים אותה. אחרי שהאפליקציה מורידת, היא מבקשת את כל ההרשאות בזמן הריצה שהיא זקוקה להן, והמשתמשים מעניקים או דוחים את ההרשאות האלה.
  2. בדיקה והתחברות: האפליקציה בודקת אם ההרשאות אושרו לפני שהיא מבקשת גישה לסוגי נתונים אחרים.
  3. בקשה להיקפי OAuth: Google מבקשת מהמשתמש להעניק לאפליקציה את היקפי ההרשאות של OAuth שנדרשים לסוגי הנתונים שהיא רוצה לגשת אליהם.
  4. Access applied: אחרי שהמשתמש מעניק הרשאות, לאפליקציה יש גישה לסוגי הנתונים ששייכים להיקפים שהמשתמש העניק הרשאה לגביהם.

הגשת בקשה לאימות

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