Google 登录

更新时间: 2022-10-19 14:53:05
编辑

准备工作

在 Google API Console Credentials (opens new window) 及 Authing Console 控制台 (opens new window)进行配置，请参阅 Google 移动端。


集成 Google 登录步骤

第一步：添加依赖

implementation 'cn.authing:guard:+'
implementation 'com.google.android.gms:play-services-auth:20.2.0'

Guard 只是 compileOnly 依赖 gms，这样可以让 App 按需引入，防止 Guard aar 包随着支持的第三方登录增加而越来越大。所以每增加一个第三方身份源，都需要 App 手动加上该身份源的依赖。

第二步：初始化 Guard Android SDK

在应用启动的时候初始化：

// context is application or initial activity
// ”AUTHING_APP_ID“ is obtained from the Authing console
Authing.init(context, "AUTHING_APP_ID");

第三步：分场景使用

  • 使用托管页

    在需要登录认证的地方启动托管页：
// this is the activity context
AuthFlow.start(this);

通过以上步骤即可简单快速地通过配置 Authing 管理控制台后自动拥有 Google 登录功能，登录入口会在 Guard 内置登录界面的社会化登录按钮列表中体现。

  • 使用 Google 登录按钮

    如果使用我们提供的 Google 登录按钮。

​ 1. 布局文件里面加上（或者代码初始化添加）如下代码：

 <cn.authing.guard.social.GoogleLoginButton
    android:id="@+id/btn_google_login"
    android:background="@drawable/authing_button_background"
    android:textColor="@color/white"
    android:layout_width="match_parent"
    android:layout_height="wrap_content" />

​ 2. 然后在代码里面处理事件：

GoogleLoginButton button = findViewById(R.id.btn_google_login);
button.setOnLoginListener((ok, data) -> {
    if (ok) {
        // 登录成功，data 是用户信息
    } else {
        // 登录失败
    }
});

  • 使用 Google 登录授权类

    如果不想使用我们内置的按钮，想完全自己实现 UI，则可以在按钮的点击事件里面调用 Google 类的授权函数，此类集成了拉起 Google 授权登录的业务逻辑：
Google google = new Google();
google.login(appContext, ((ok, data) -> {
    if (ok) {
        // 登录成功，data 是用户信息
    } else {
        // 登录失败
    }
}));

  • 使用 Google 登录 API

    如果想完全自己实现 Google 登录 UI 以及获取授权码逻辑，拿到授权码后，可以调用下面 API 换取用户信息：
public static void loginByGoogle(String authCode, @NotNull AuthCallback<UserInfo> callback)

参数

authCode Google 授权码

示例

AuthClient.loginByGoogle(authCode, (code, message, userInfo)->{
    if (code == 200) {
        // userInfo：用户信息
    }
});