תחילת העבודה ב-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.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 כשמפתחים את האפליקציה.

קבלת ההרשאות הנדרשות ל-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. Access applied: אחרי שהמשתמש מעניק הרשאות, לאפליקציה יש גישה לסוגי הנתונים ששייכים להיקפים שהמשתמש העניק הרשאה לגביהם.