开发者控制台

A3L身份验证入门

A3L身份验证入门

要开始使用A3L身份验证,请按照本指南进行操作。

要求

要使用A3L身份验证,需要满足以下要求:

  • 运行API级别21或更高版本的兼容Android设备。
  • 配置为针对Android API级别21或更高版本进行编译的项目。

配置Google API控制台

在将A3L身份验证集成到应用中之前,需要设置一个项目并在Google API控制台中对其进行配置。要了解如何配置用于身份验证的Google API控制台项目,请参阅Google开发者文档中的配置Google API控制台项目

  1. 在Google API控制台中前往您的项目,在 https://console.cloud.google.com/apis/credentials找到Android客户端ID。记下列出的类型为Android客户端ID
  2. 如果使用服务器并需要ID令牌,则需要OAuth 2.0客户端ID。要获取您的OAuth 2.0客户端ID,请按照Google开发者文档获取后端服务器的OAuth 2.0客户端ID中的说明进行操作。有关如何获取ID令牌的详细信息,请参阅使用后端服务器进行身份验证

将A3L身份验证SDK添加到您的项目

按照以下步骤将A3L身份验证SDK添加到您的项目中。

  1. 下载A3L身份验证SDK。

    该SDK包括AAR文件、Javadocs和示例应用(一个适用于Java,一个适用于Kotlin)。

  2. 将AAR文件添加到项目的libs文件夹,然后在build.gradle文件中添加以下信息。

    1. 将A3L身份验证AAR文件添加为依赖项:

        implementation files('<Path to AAR>/A3LAuthentication-1.1.0.aar')
      
    2. 将Google Sign-In和AppAuth添加为依赖项:

        implementation 'com.google.android.gms:play-services-auth:20.7.0'
        implementation 'net.openid:appauth:0.11.1'
      
    3. 添加以下依赖项:

        implementation 'com.squareup.okio:okio:3.2.0'
        implementation 'androidx.security:security-crypto:1.1.0-alpha06'
      
    4. 在build.gradle文件的默认配置中,为appAuthRedirectScheme添加清单占位符,如以下示例所示。appAuthRedirectScheme值指出了在用户通过浏览器进行身份验证后,A3L应该将用户重定向到哪里。

        android {
            defaultConfig {
                ...
                manifestPlaceholders = [
                'appAuthRedirectScheme': 'com.googleusercontent.apps.<PREFIX>'
                ]
            }
            ...
        }
      

      在您的应用中,将前面示例中的<PREFIX>替换为应用客户端ID的第一部分。客户端ID的格式为<PREFIX>.apps.googleusercontent.com。请勿在build.gradle文件中的<PREFIX>之后添加任何文本。

    5. 要通过 FosAccountCredential对象访问Google API,请添加Google身份验证库依赖关系并更新 packagingOptions以排除META-INF/DEPENDENCIES

            implementation 'com.google.auth:google-auth-library-oauth2-http:1.20.0'
      
            android {
                ...
                packagingOptions {
                    resources.excludes += 'META-INF/DEPENDENCIES'
                }
                ...
            }
      

      要使应用程序与Fire OS设备兼容,请启用Android 提供的脱糖支持

后续步骤

请参阅集成A3L身份验证


Last updated: 2023年12月5日