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

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

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

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

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

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

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

برای فعال کردن «میانای برنامه‌سازی کاربردی Fitness»، شناسه کارخواه OAuth 2.0 دریافت کنید.

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

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

افزودن کتابخانه کارخواه «خدمات 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. دسترسی اعمال‌شده: پس‌از اینکه کاربر اجازه‌ها را اعطا کرد، برنامه شما می‌تواند به انواع داده‌ای که متعلق به محدوده‌هایی است که کاربر برای آن‌ها اجازه اعطا کرده است دسترسی داشته باشد.