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

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

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

הגדרה

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

קבל חשבון Google

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

התקנת Google Play Services

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

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

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

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

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

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

הוספה של ספריית הלקוח של Google Play Services

ב-Android Studio, פותחים את הקובץ build.gradle של המודול ומוסיפים את ספריית הלקוח של Google Play Services כתלות:

DSL ב-Kotlin

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

DSL מגניב

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

כדי לקרוא ולכתוב סוגים מסוימים של נתונים, האפליקציה צריכה לבקש הרשאות ב-Android.

קבלת הרשאות OAuth

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

יצירת לקוח API

כדי לכתוב או לקרוא נתונים, יוצרים לקוח API ומוסיפים את סוגי הנתונים שהאפליקציה צריכה גישה אליהם. אלה נקודות הקצה הזמינות:

• SensorsClient: גישה למקורות שונים של נתוני בריאות וכושר מחיישני חומרה במכשיר המקומי ובמכשירים נלווים.
• RecordingClient: לאיסוף נתוני חיישנים ברקע ופועל כל הזמן ברקע.
• HistoryClient: הוספה, מחיקה וקריאה של נתונים היסטוריים ב-Google Fit.
• SessionsClient: יצירה וניהול של סשנים של פעילות משתמשים.
• GoalsClient: קריאה של היעדים 'דק' אימון קרדיו' ו'צעדים' שנוצרו על ידי משתמשים ב-Google Fit.
• ConfigClient: גישה להגדרות ולסוגים של נתונים בהתאמה אישית בפלטפורמת Google Fit.

ראה דוגמה כיצד לבנות לקוח כושר API.

הזרימה המתקבלת מהרשאת המשתמש

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

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

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

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

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