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

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

הגדרה

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

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

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

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

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

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

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

יצירה ובדיקה של האפליקציה

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

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

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