قبل‌از اینکه بتوانید ادغام «ورود به سیستم با Google» را در برنامه خودتان شروع کنید، باید پروژه «کنسول Google API» را پیکربندی کنید و پروژه Android Studio خود را راه‌اندازی کنید. مراحل این صفحه دقیقاً همین کار را انجام می‌دهند. سپس مراحل بعدی نحوه ادغام «ورود به سیستم با Google» را در برنامه‌تان شرح می‌دهد.
پیش‌نیازها
«ورود به سیستم با Google» برای Android شرایط لازم زیر را دارد:
- دستگاه سازگار مجهز به Android که Android نسخه ۶.۰ یا جدیدتر را اجرا می‌کند و شامل «فروشگاه Google Play» یا شبیه‌ساز با «دستگاه مجازی Android» (AVD) است که پلاتفرم Google APIs را براساس Android نسخه ۴.۲.۲ یا جدیدتر اجرا می‌کند و نسخه ۱۵.۰.۰ یا جدیدتر خدمات Google Play را دارد.
- جدیدترین نسخه کیت توسعه نرم‌افزار Android، ازجمله مؤلفه «ابزارهای کیت توسعه نرم‌افزار». کیت توسعه نرم‌افزار ازطریق «مدیر کیت توسعه نرم‌افزار Android» در «استودیو Android» دردسترس است.
- پروژه‌ای که برای کامپایل کردن با Android نسخه ۶.۰ (Marshmallow) یا جدیدتر پیکربندی شده باشد.
این راهنما برای کاربران Android Studio نوشته شده است که محیط توسعه توصیه‌شده است.
افزودن «خدمات Google Play»
در فایل build.gradle سطح بالای پروژه‌تان، بررسی کنید که مخزن Maven متعلق به Google
گنجانده شده باشد:
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'
}
پیکربندی پروژه «کنسول Google API»
- پروژه‌تان را در کنسول میانای برنامه‌سازی کاربردی باز کنید، یا اگر پروژه ندارید، پروژه‌ای ایجاد کنید.
- در صفحه صفحه کسب رضایت OAuth، مطمئن شوید همه اطلاعات کامل و دقیق باشد.
- در صفحه اعتبارنامه‌ها، اگر ازقبل شناسه کارخواه از نوع Android برای برنامه‌تان ندارید، یکی ایجاد کنید. باید نام بسته برنامه و اثر انگشت گواهینامه SHA-1 را مشخص کنید. برای اطلاعات بیشتر، اصالت‌سنجی کارخواه را ببینید.
دریافت شناسه کارخواه OAuth 2.0 سرور زیرینه
اگر برنامه‌تان با سرور زیرینه اصالت‌سنجی می‌کند یا از سرور زیرینه به Google API دسترسی پیدا می‌کند، باید شناسه کارخواه OAuth 2.0 را که نشان‌دهنده سرور زیرینه شما است دریافت کنید.
برای ایجاد شناسه کارخواه برای سرورتان:
پروژه‌تان را در کنسول API باز کنید.
در صفحه اعتبارنامه، شناسه کارخواه از نوع برنامه وب ایجاد کنید. رشته شناسه مشتری را یادداشت کنید، زیرا هنگام ایجاد شیء
GoogleSignInOptionsباید آن را به روشrequestIdTokenیاrequestServerAuthCodeارسال کنید.
مراحل بعدی
اکنون که پروژه «کنسول Google API» را پیکربندی کرده‌اید و پروژه «استودیو Android» را راه‌اندازی کرده‌اید، می‌توانید «ورود به سیستم با Google» را در برنامه‌تان ادغام کنید.