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