במדריך הזה מוסבר איך להתחיל לפתח את Google Fit ב-Android.
הגדרה
לפני שמתחילים לפתח את האפליקציה, צריך לבצע את השלבים הבאים .
קבל חשבון Google
כדי להשתמש בממשקי Google Fit API, נדרש חשבון Google. אפשר ליצור חשבון חדש או
משתמשים בחשבון קיים.
התקנת Google Play Services
אפשר לקבל את ספריית הלקוח העדכנית של Google Play Services בפיתוח שלך Host (מארח):
- פותחים את מנהל ה-SDK של Android.
- בקטע SDK Tools, מאתרים את Google Play Services.
- אם הסטטוס של החבילות האלה הוא לא מותקנת, בוחרים את שתיהן ולוחצים על 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 לכושר שיוצרת את האפליקציה שלכם.
יצירה ובדיקה של האפליקציה
אחרי שתסיימו את שלבי ההגדרה, תוכלו להתחיל בבניית האפליקציה. כדי לקבל ללמוד על סוגי הנתונים שהאפליקציה יכולה לאחסן קריאה. מידע נוסף על עבודה עם ב-Google Fit.
קבלת ההרשאות הדרושות ל-Android
כדי לקרוא ולכתוב סוגי נתונים מסוימים, האפליקציה צריכה לבקש הרשאות ב-Android.
קבלת הרשאות OAuth
סוגי הנתונים שלאפליקציה יש הרשאת גישה אליהם תואמים
היקפי הרשאות. לשאול
להרשאות אלה, צריך להוסיף
לאילו סוגי נתונים האפליקציה שלך צריכה גישה בFitnessOptions
מופע. כשהאפליקציה מבקשת להשתמש בנתונים של Google Fit
שונים, Android SDK בודק באופן אוטומטי לאילו היקפי הרשאות הם שייכים, ומבקש לבצע את הבקשה
המשתמש יקבל הרשאה להיקפים האלה.
יצירה של לקוח API
צריך ליצור לקוח API ולהוסיף את סוגי הנתונים שהאפליקציה צריכה לגשת אליהם לכתוב או לקרוא נתונים. אלה נקודות הקצה הזמינות:
-
SensorsClient
: גישה למקורות שונים של נתוני בריאות וכושר מחיישני חומרה במכשיר המקומי ובמכשירים נלווים. -
RecordingClient
: לאיסוף של נתוני חיישנים במצב של צריכת חשמל נמוכה, ותמיד פועל ברקע. -
HistoryClient
: הוספה, מחיקה וקריאה של נתונים היסטוריים ב: Google Fit. -
SessionsClient
: יצירה וניהול של סשנים של פעילות המשתמשים. -
GoalsClient
: קריאת הנתונים של נקודות אימון קרדיו ומספר צעדים שנוצרו על ידי משתמשים ב-Google Fit. -
ConfigClient
: גישה להגדרות ולסוגים מותאמים אישית של נתונים בפלטפורמת Google Fit.
תהליך הרשאת המשתמש שנוצר
כאן מוצג תהליך ההרשאה שמתקבל שהמשתמשים חווים כשהוא מבקש הרשאות:
- הרשאות ב-Android: המשתמשים יכולים לראות אילו הרשאות ב-Android יש לאפליקציה שלכם ביקשה לפני ההורדה שלה. אחרי הורדת האפליקציה, מבקש כל הרשאה שנדרשת בתחילת ההפעלה, והמשתמשים מעניקים או דוחים את ההרשאה את ההרשאות האלה.
- בדיקה וחיבור: האפליקציה בודקת אם ההרשאות מוענק לפני שהוא מבקש גישה לסוגי נתונים אחרים.
- בקשה להיקפי הרשאות OAuth: Google מבקשת מהמשתמש להעניק את ההרשאה לאפליקציה את היקפי ההרשאות של OAuth שנדרשים לסוגי הנתונים שאליהם הוא רוצה לגשת.
- הגישה הוחלה: אחרי שהמשתמש מעניק הרשאות, האפליקציה יכולה גישה לסוגי הנתונים ששייכים להיקפים שהמשתמש העניק עבור.
הגשת בקשה לאימות
אחרי שיוצרים ובודקים את האפליקציה, צריך להגיש בקשה אימות עם רמות ההצדקה הנדרשות היקפים רגישים ומוגבלים.