若要开始将 Google 登录集成到您自己的应用中,您必须先配置一个 Google API 控制台项目并设置您的 Android Studio 项目。本页面上的步骤正是为了实现这一目标。后续步骤介绍了如何将 Google 登录集成到您的应用中。
前提条件
Google Sign-In for Android 有以下要求:
- 搭载 Android 6.0 或更高版本的兼容 Android 设备,且包含 Google Play 商店;或者搭载 Android 4.2.2 或更高版本的 Android 虚拟设备 (AVD) 模拟器,且运行基于 Android 的 Google API 平台,并安装了 Google Play 服务 15.0.0 或更高版本。
- 最新版本的 Android SDK,包括 SDK 工具组件。 您可以通过 Android Studio 中的 Android SDK 管理器获取该 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 登录功能集成到您的应用中。