شروع به کار در Android

یک حساب Google ایجاد کنید

برای استفاده از Google Fit API، به «حساب Google» نیاز دارید. می‌توانید حساب جدیدی ایجاد کنید یا از حساب موجودی استفاده کنید. شاید بخواهید حساب جداگانه‌ای برای آزمایش کردن برنامه‌تان از دیدگاه کاربر ایجاد کنید.

دریافت خدمات Google Play

جدیدترین کتابخانه کارخواه را برای خدمات Google Play در میزبان توسعه خود دریافت کنید:

1. مدیر کیت توسعه نرم‌افزار Android را باز کنید.
2. در بخش ابزارهای کیت توسعه نرم‌افزار، خدمات Google Play را پیدا کنید.
3. اگر وضعیت این بسته‌ها نصب‌شده نیست، هر دو را انتخاب کنید و روی نصب بسته‌ها کلیک کنید.

دریافت شناسه کارخواه OAuth 2.0

برای فعال کردن Fitness API، شناسه کارخواه OAuth 2.0 دریافت کنید.

ایجاد و پیکربندی پروژه

توصیه می‌کنیم برای ساختن برنامه با Fitness API از محیط توسعه نرم‌افزار «استودیو Android» استفاده کنید. برای جزئیات مربوط به نحوه ایجاد پروژه جدید و پیکربندی آن در Android Studio، به ایجاد پروژه مراجعه کنید.

افزودن کتابخانه کارخواه خدمات Google Play

در Android Studio، فایل build.gradle را برای ماژول خود باز کنید و کتابخانه مشتری خدمات Google Play را به‌عنوان وابستگی اضافه کنید:

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

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 هنگام ساختن برنامه‌تان، کیت توسعه نرم‌افزار تناسب اندام را به‌طور خودکار بارگیری کند.

دریافت اجازه‌های لازم Android

برای خواندن و نوشتن برخی‌از انواع داده، برنامه‌تان باید اجازه‌های Android را درخواست کند.

دریافت اجازه‌های OAuth

انواع داده‌ای که برنامه‌تان اجازه دسترسی به آن‌ها را دارد با گستره‌های مجوز مطابقت دارد. برای درخواست این اجازه‌ها، باید در یک نمونه FitnessOptions اضافه کنید که برنامه‌تان به کدام نوع داده‌ها نیاز دارد. وقتی برنامه‌تان درخواست می‌کند از هرکدام از انواع داده‌های Google Fit استفاده کند، Android SDK به‌طور خودکار بررسی می‌کند که این داده‌ها به کدام دامنه‌ها تعلق دارند و از کاربر می‌خواهد به آن دامنه‌ها اجازه دسترسی بدهد.

ایجاد کارخواه میانای برنامه‌سازی کاربردی

کارخواه میانای برنامه‌سازی کاربردی ایجاد کنید و انواع داده‌ای را که برنامه‌تان برای دسترسی به آن‌ها نیاز دارد اضافه کنید تا داده‌ها را بنویسید یا بخوانید. نقطه‌های پایانی زیر دردسترس است:

• SensorsClient: دسترسی به منابع مختلف داده‌های سلامتی و تندرستی از حسگرهای سخت‌افزاری در دستگاه محلی و دستگاه‌های همپا.
• RecordingClient: برای جمع‌آوری داده‌های حسگر در پس‌زمینه با مصرف کم باتری و همیشه روشن.
• HistoryClient: درج، حذف، و خواندن داده‌های قدیمی در Google Fit.
• SessionsClient: ایجاد و مدیریت جلسه‌های فعالیت کاربر.
• GoalsClient: خواندن اهداف «امتیازهای قلب» و «تعداد قدم‌ها» که کاربران در Google Fit ایجاد کرده‌اند.
• ConfigClient: دسترسی به تنظیمات و انواع داده‌های سفارشی در پلاتفرم Google Fit.

نمونه‌ای از نحوه ساختن کارخواه Fitness API را ببینید.

جریان مجوز کاربر حاصل

در زیر، جریان مجوزدهی حاصل که کاربران هنگام درخواست اجازه‌ها تجربه می‌کنند نشان داده شده است:

1. اجازه‌های Android: کاربران پیش‌از بارگیری برنامه‌تان می‌بینند که برنامه شما چه اجازه‌هایی از Android درخواست کرده است. پس‌از بارگیری برنامه، برنامه هرگونه اجازه زمان اجرا را که نیاز دارد درخواست می‌کند و کاربران این اجازه‌ها را اعطا یا رد می‌کنند.
2. بررسی و اتصال: برنامه‌تان قبل‌از درخواست دسترسی به انواع دیگر داده‌ها، بررسی می‌کند که آیا اجازه‌ها اعطا شده‌اند یا نه.
3. درخواست گستره‌های OAuth: Google از کاربر می‌خواهد گستره‌های OAuth موردنیاز برای انواع داده‌ای را که برنامه شما می‌خواهد به آن‌ها دسترسی داشته باشد به برنامه شما اعطا کند.
4. دسترسی اعمال شد: پس‌از اینکه کاربر اجازه‌ها را اعطا کرد، برنامه‌تان می‌تواند به انواع داده‌ای که به گستره‌های اعطاشده توسط کاربر تعلق دارد دسترسی پیدا کند.