قبل از اینکه بتوانید ادغام Google Sign-In را در برنامه خود شروع کنید، باید یک پروژه Google API Console را پیکربندی کرده و پروژه Android Studio خود را راهاندازی کنید. مراحل موجود در این صفحه دقیقاً همین کار را انجام میدهند. مراحل بعدی نحوه ادغام Google Sign-In را در برنامه شما شرح میدهند.
پیشنیازها
ورود به سیستم گوگل برای اندروید الزامات زیر را دارد:
- یک دستگاه سازگار با اندروید که اندروید ۶.۰ یا جدیدتر را اجرا میکند و شامل فروشگاه گوگل پلی یا یک شبیهساز با AVD است که پلتفرم APIهای گوگل را بر اساس اندروید ۴.۲.۲ یا جدیدتر اجرا میکند و دارای سرویسهای گوگل پلی نسخه ۱۵.۰.۰ یا جدیدتر است.
- آخرین نسخه از کیت توسعه نرمافزار اندروید (SDK)، شامل کامپوننت ابزارهای SDK. این کیت از طریق Android SDK Manager در اندروید استودیو در دسترس است.
- پروژهای که برای کامپایل روی اندروید ۶.۰ (مارشمالو) یا جدیدتر پیکربندی شده است.
این راهنما برای کاربران اندروید استودیو نوشته شده است، که محیط توسعه پیشنهادی است.
اضافه کردن سرویسهای گوگل پلی
در فایل build.gradle سطح بالای پروژه خود، مطمئن شوید که مخزن Maven گوگل گنجانده شده است:
allprojects {
repositories {
google()
// If you're using a version of Gradle lower than 4.1, you must instead use:
// maven {
// url 'https://maven.google.com'
// }
}
}
سپس، در فایل build.gradle سطح برنامه خود، سرویسهای Google Play را به عنوان یک وابستگی اعلام کنید:
apply plugin: 'com.android.application'
...
dependencies {
implementation 'com.google.android.gms:play-services-auth:21.3.0'
}
پیکربندی یک پروژه کنسول API گوگل
- پروژه خود را در کنسول API باز کنید، یا اگر از قبل پروژهای ندارید، آن را ایجاد کنید.
- در صفحه رضایتنامه OAuth، مطمئن شوید که تمام اطلاعات کامل و دقیق هستند.
- در صفحه اعتبارنامهها، اگر از قبل شناسه کلاینت از نوع اندروید ندارید، آن را برای برنامه خود ایجاد کنید. باید نام بسته برنامه و اثر انگشت گواهی SHA-1 خود را مشخص کنید. برای اطلاعات بیشتر به بخش احراز هویت کلاینت خود مراجعه کنید.
شناسه کلاینت OAuth 2.0 سرور بکاند خود را دریافت کنید
اگر برنامه شما با یک سرور backend احراز هویت میشود یا از طریق سرور backend شما به APIهای گوگل دسترسی پیدا میکند ، باید شناسه کلاینت OAuth 2.0 را که نشان دهنده سرور backend شماست، دریافت کنید.
برای ایجاد شناسه کلاینت برای سرور خود:
پروژه خود را در کنسول API باز کنید.
در صفحه اعتبارنامهها، یک شناسه کلاینت از نوع برنامه وب ایجاد کنید. به رشته شناسه کلاینت توجه داشته باشید، که هنگام ایجاد شیء
GoogleSignInOptionsباید به متدهایrequestIdTokenیاrequestServerAuthCodeارسال کنید.
مراحل بعدی
اکنون که پروژه کنسول API گوگل را پیکربندی کرده و پروژه اندروید استودیو خود را راهاندازی کردهاید، میتوانید ورود به سیستم گوگل را در برنامه خود ادغام کنید .