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

קבל חשבון Google

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

התקנת Google Play Services

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

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

קבלת מזהה לקוח OAuth 2.0

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

יצירה והגדרה של הפרויקט

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

הוספה של ספריית הלקוח של Google Play Services

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

plugin {
    id("com.android.application")
}

...

dependencies {
        implementation("com.google.android.gms:play-services-fitness:21.3.0")
        implementation("com.google.android.gms:play-services-auth:21.4.0")
}

apply plugin: 'com.android.application'

...

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

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

קבלת ההרשאות הנדרשות ב-Android

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

קבלת הרשאות OAuth

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

יצירה של לקוח API

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

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

דוגמה לאופן יצירת לקוח Fitness API

תהליך הרשאת המשתמש שמתקבל

התרשים הבא מציג את תהליך ההרשאה שמוצג למשתמשים כשהם מתבקשים לתת הרשאות:

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