您必须先配置一个 Google API 控制台项目并设置您的 Android Studio 项目,然后才能开始将 Google 登录集成到您自己的应用中。本页中的步骤就是为此而设计的。然后,后续步骤介绍了如何将 Google 登录功能集成到您的应用中。
前提条件
Google Sign-In for Android 有以下要求:
- 搭载 Android 6.0 或更高版本且包含 Google Play 商店的兼容 Android 设备,或者搭载基于 Android 4.2.2 或更高版本的 Google API 平台且安装有 Google Play 服务 15.0.0 或更高版本的模拟器 AVD。
- 最新版本的 Android SDK,包括 SDK 工具组件。 该 SDK 可通过 Android Studio 中的 Android SDK 管理器获取。
- 配置为针对 Android 6.0 (Marshmallow) 或更高版本进行编译的项目。
本指南适用于 Android Studio 用户,建议以 Android Studio 作为开发环境。
添加 Google Play 服务
在项目的顶层 build.gradle
文件中,确保包含 Google 的 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'
}
配置 Google API 控制台项目
- 在 API 控制台中打开您的项目,或者创建一个项目(如果您还没有项目)。
- 在 OAuth 同意屏幕页面上,确保所有信息完整且准确无误。
- 在“凭据”页面上,为您的应用创建 Android 类型的客户端 ID(如果尚未创建)。您需要指定应用的软件包名称和 SHA-1 证书指纹。如需了解详情,请参阅对客户端进行身份验证。
获取后端服务器的 OAuth 2.0 客户端 ID
如果您的应用通过后端服务器进行身份验证或通过后端服务器访问 Google API,您需要获取代表后端服务器的 OAuth 2.0 客户端 ID。
如需为服务器创建客户端 ID,请执行以下操作:
在 API 控制台中打开您的项目。
在“凭据”页面上,创建一个网站应用类型的客户端 ID。记下客户端 ID 字符串,您需要在创建
GoogleSignInOptions
对象时将其传递给requestIdToken
或requestServerAuthCode
方法。
后续步骤
现在,您已配置 Google API 控制台项目并设置 Android Studio 项目,接下来可以将 Google 登录集成到您的应用中。