در اندروید شروع کنید

این راهنما نحوه شروع توسعه با Google Fit را در Android توضیح می دهد.

توجه: Google Fit بخشی از خدمات Google Play است. درباره مزایایی که برنامه شما از استفاده از خدمات Google Play دریافت می‌کند، بیاموزید .

راه اندازی

قبل از شروع ساخت اپلیکیشن خود، مراحل زیر را تکمیل کنید.

یک حساب Google دریافت کنید

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

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

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

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

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

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

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

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

کتابخانه سرویس گیرنده Google Play را اضافه کنید

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

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

Groovy 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 را درخواست کند .

مجوزهای OAuth را دریافت کنید

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

یک کلاینت API ایجاد کنید

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

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

نمونه ای از نحوه ایجاد یک کلاینت Fitness API را ببینید.

نتیجه جریان مجوز کاربر

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

شکل 1. جریان مجوز برای کاربران.

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

برای تایید اقدام کنید

پس از ساختن و آزمایش برنامه خود، باید برای تأیید با سطوح مختلف توجیه مورد نیاز برای حوزه های حساس و محدود درخواست دهید.

،

این راهنما نحوه شروع توسعه با Google Fit را در Android توضیح می دهد.

توجه: Google Fit بخشی از خدمات Google Play است. درباره مزایایی که برنامه شما از استفاده از خدمات Google Play دریافت می‌کند، بیاموزید .

راه اندازی

قبل از شروع ساخت اپلیکیشن خود، مراحل زیر را تکمیل کنید.

یک حساب Google دریافت کنید

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

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

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

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

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

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

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

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

کتابخانه سرویس گیرنده Google Play را اضافه کنید

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

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

Groovy 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 را درخواست کند .

مجوزهای OAuth را دریافت کنید

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

یک کلاینت API ایجاد کنید

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

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

نمونه ای از نحوه ایجاد یک کلاینت Fitness API را ببینید.

نتیجه جریان مجوز کاربر

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

شکل 1. جریان مجوز برای کاربران.

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

برای تایید اقدام کنید

پس از ساختن و آزمایش برنامه خود، باید برای تأیید با سطوح مختلف توجیه مورد نیاز برای حوزه های حساس و محدود درخواست دهید.