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

קבל חשבון Google

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

התקנת Google Play Services

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

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

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

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

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

כדי לפתח אפליקציה עם Fitness API, מומלץ להשתמש בסביבת הפיתוח של Android Studio. עבור לפרטים על יצירת פרויקט חדש והגדרתו ב-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.2.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.2.0'
}

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

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