במדריך הזה נסביר איך מתחילים לפתח עם Google Fit ב-Android.
הגדרה
לפני שמתחילים לפתח את האפליקציה, צריך להשלים את השלבים שמפורטים בקטעים הבאים.
קבל חשבון Google
כדי להשתמש בממשקי ה-API של Google Fit, צריך חשבון Google. אתם יכולים ליצור חשבון חדש או להשתמש בחשבון קיים.
התקנת Google Play Services
מורידים את ספריית הלקוח העדכנית של Google Play Services למארח הפיתוח:
- פותחים את Android SDK Manager.
- בקטע SDK Tools, מחפשים את Google Play Services.
- אם הסטטוס של החבילות האלה הוא לא 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 כיחס תלות:
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.3.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.3.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.
תהליך ההרשאה של המשתמש שנוצר
התהליך שמתרחש לאחר מכן הוא תהליך ההרשאה שבו המשתמשים נתקלים כשהם מתבקשים להעניק הרשאות:

- הרשאות Android: המשתמשים רואים אילו הרשאות Android ביקשה האפליקציה שלכם לפני שהם מורידים אותה. אחרי שהאפליקציה מורידת, היא מבקשת את כל ההרשאות בזמן הריצה שהיא זקוקה להן, והמשתמשים מעניקים או דוחים את ההרשאות האלה.
- בדיקה והתחברות: האפליקציה בודקת אם ההרשאות אושרו לפני שהיא מבקשת גישה לסוגי נתונים אחרים.
- בקשה להיקפי OAuth: Google מבקשת מהמשתמש להעניק לאפליקציה את היקפי ההרשאות של OAuth שנדרשים לסוגי הנתונים שהיא רוצה לגשת אליהם.
- Access applied: אחרי שהמשתמש מעניק הרשאות, לאפליקציה יש גישה לסוגי הנתונים ששייכים להיקפים שהמשתמש העניק הרשאה לגביהם.
הגשת בקשה לאימות
אחרי שתיצרו את האפליקציה ותבדקו אותה, תצטרכו להגיש בקשה לאימות עם רמות שונות של הצדקה, בהתאם להיקפים הרגישים והמוגבלים.