תחילת העבודה ב-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:22.0.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:22.0.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.

דוגמה ליצירת לקוח API של Fitness

תהליך הרשאת המשתמש שנוצר

כך נראה תהליך ההרשאה שהמשתמשים עוברים כשהם מתבקשים לתת הרשאות:

איור 1.תהליך ההרשאה למשתמשים.

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

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

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