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

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

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

הגדרה

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

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

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

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

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

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

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

כאן מוצג תהליך ההרשאה שמתקבל שהמשתמשים חווים כשהוא מבקש הרשאות:

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

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

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

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