A3L身份验证入门
要开始使用A3L身份验证,请按照本指南进行操作。
要求
要使用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文件中添加以下信息。
-
将A3L身份验证AAR文件添加为依赖项:
implementation files('<Path to AAR>/A3LAuthentication-1.1.0.aar')
-
将Google Sign-In和AppAuth添加为依赖项:
implementation 'com.google.android.gms:play-services-auth:20.7.0' implementation 'net.openid:appauth:0.11.1'
-
添加以下依赖项:
implementation 'com.squareup.okio:okio:3.2.0' implementation 'androidx.security:security-crypto:1.1.0-alpha06'
-
在build.gradle文件的默认配置中,为
appAuthRedirectScheme
添加清单占位符,如以下示例所示。appAuthRedirectScheme
值指出了在用户通过浏览器进行身份验证后,A3L应该将用户重定向到哪里。android { defaultConfig { ... manifestPlaceholders = [ 'appAuthRedirectScheme': 'com.googleusercontent.apps.<PREFIX>' ] } ... }
在您的应用中,将前面示例中的
<PREFIX>
替换为应用客户端ID的第一部分。客户端ID的格式为<PREFIX>.apps.googleusercontent.com
。请勿在build.gradle文件中的<PREFIX>
之后添加任何文本。 -
要通过
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日