A3L身份验证入门

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

要求
配置Google API控制台
将A3L身份验证SDK添加到您的项目
后续步骤

要求

要使用A3L身份验证，需要满足以下要求：

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

配置Google API控制台

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

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

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

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

下载A3L身份验证SDK。

该SDK包括AAR文件、Javadocs和示例应用（一个适用于Java，一个适用于Kotlin）。
将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日