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

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

הערה: ‏ Google Fit הוא חלק מ-Google Play Services. מידע על היתרונות של השימוש ב-Google Play Services באפליקציה

הגדרה

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

קבל חשבון 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 כתלות:

Kotlin DSL

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.5.0")
}

Groovy DSL

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.5.0'
}

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

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

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

קבלת ההרשאות הנדרשות ב-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. תהליך ההרשאה למשתמשים.

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

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

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