我们 即将停用适用于网页的 Google 登录 JavaScript 平台库。此库将于 2023 年 3 月 31 日弃用后停止下载。请改用新版网页版 Google Identity Services。
现在,系统会禁止新创建的客户端 ID 使用旧版平台库,现有的客户端 ID 不受影响。在 2022 年 7 月 29 日之前创建的新客户端 ID 可以设置 `plugin_name` 以允许使用 Google 平台库。

开始将 Google 登录集成到您的 Android 应用中

在开始将 Google 登录集成到您自己的应用中之前,您必须配置一个 Google API 控制台项目并设置您的 Android Studio 项目。只需按照此页面上的步骤操作,后续步骤介绍了如何将 Google 登录集成到您的应用中。

前提条件

Android 版 Google 登录具有以下要求:

  • 搭载 Android 4.4 或更高版本且包含 Google Play 商店的模拟器,或配有搭载基于 Android 4.2.2 或更高版本且安装了 Google Play 服务 15.0.0 或更高版本的 Google API 平台的 AVD 的模拟器。
  • 最新版本的 Android SDK,包括 SDK 工具组件。 您可以在 Android Studio 中的 Android SDK 管理器中找到该 SDK。
  • 配置为针对 Android 4.4 (KitKat) 或更高版本进行编译的项目。

本指南适用于 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:20.2.0'
    }

配置 Google API 控制台项目

如需配置 Google API 控制台项目,请点击下面的按钮,并在出现提示时指定应用的软件包名称。您还需要提供签名证书的 SHA-1 哈希。如需了解相关信息,请参阅对客户端进行身份验证

配置项目

获取后端服务器的 OAuth 2.0 客户端 ID

如果您的应用通过后端服务器进行身份验证从后端服务器访问 Google API,您必须获取为服务器创建的 OAuth 2.0 客户端 ID。要查找 OAuth 2.0 客户端 ID,请执行以下操作:

  1. 打开 API 控制台中的“凭据”页面
  2. Web 应用类型客户端 ID 就是您的后端服务器的 OAuth 2.0 客户端 ID。

创建 GoogleSignInOptions 对象时,将此客户端 ID 传递给 requestIdTokenrequestServerAuthCode 方法。

后续步骤

现在,您已配置了 Google API 控制台项目并设置了 Android Studio 项目,接下来,您就可以将 Google 登录功能集成到您的应用中。