【本文正在参与51CTO HarmonyOS技术社区创作者激励计划-星光计划2.0】

前言

因为鸿蒙系统刚出不久，官方的第三方登录SDK还没出来，下面就介绍下在鸿蒙应用中实现QQ登录的方法（支持唤起QQ安卓客户端进行授权）

前期准备

登录QQ开放平台 > 应用管理 > 创建应用 ，创建一个网站应用。
==注意：要选择网站应用，移动应用和小程序不适用该方案==。

编写代码

判断是否已登录

获取登录状态

在入口AbilitySliceMainAbilitySlice中进行判断。
从数据库获取token的值判断是否已经登录账号 (已登录返回token，未登录返回null)

// 创建数据库(这里使用官方提供的“轻量级数据存储”，相关文档：https://developer.harmonyos.com/cn/docs/documentation/doc-guides/database-preference-guidelines-0000000000030083)
Preferences preferences = new DatabaseHelper(getApplicationContext()).getPreferences("DATA_NAME");
//  从数据库获取token的值判断是否已经登录账号 (已登录返回token，未登录返回null)
String token = preferences.getString("token",null);

进行相应跳转

已登录跳转至个人界面MyAbility，未登录跳转至登录界面LoginAbility.

if(token != null){
            // 已登录，跳转至MyAbility
            Intent myIntent = new Intent();
            myIntent.setParam("token", token);
            Operation myOperation = new Intent.OperationBuilder()
                    .withBundleName("cn.dsttl3.test")
                    .withAbilityName("cn.dsttl3.qqlogin.MyAbility")
                    .build();
            myIntent.setOperation(myOperation);
            startAbility(myIntent);
            terminateAbility();
}else {
            // 未登录，跳转至LoginAbility
            Intent loginIntent = new Intent();
            Operation loginOperation = new Intent.OperationBuilder()
                    .withBundleName("cn.dsttl3.test")
                    .withAbilityName("cn.dsttl3.qqlogin.LoginAbility")
                    .build();
            loginIntent.setOperation(loginOperation);
            startAbility(loginIntent);
            terminateAbility();
}

登录界面的操作

申请网络访问权限

在config.json添加

"reqPermissions": [
      {
        "name": "ohos.permission.INTERNET"
      }
    ]

登录界面布局文件ability_login.xml

在布局文件中添加以后webview组件

<?xml version="1.0" encoding="utf-8"?>
<DirectionalLayout
    xmlns:ohos="http://schemas.huawei.com/res/ohos"
    ohos:height="match_parent"
    ohos:width="match_parent"
    ohos:alignment="center"
    ohos:orientation="vertical">

    <ohos.agp.components.webengine.WebView
        ohos:id="$+id:WebView_qqlogin"
        ohos:height="match_parent"
        ohos:width="match_parent"/>

</DirectionalLayout>

登录界面的AbilitySlice LoginAbilitySlice.java

需要用到的几个常量

String state = UUID.randomUUID().toString();// 唯一标识，成功授权后回调时会原样带回。
String client_id = "101***151";//QQ开放平台 应用 APP ID
String redirect_uri = "https%3A%2F%2Fapi.dsttl3.cn%2FRedis%2FQQLogin"; //应用 网站回调域 需进行url编码，授权成功后会跳转至该链接
String authorize_url = "https://graph.qq.com/oauth2.0/authorize?response_type=code" +
            "&client_id=" + client_id +
            "&redirect_uri=" + redirect_uri +
            "&state="+ state;

WebView的配置

WebView myWebView = (WebView) findComponentById(ResourceTable.Id_WebView_qqlogin);
        myWebView.getWebConfig().setJavaScriptPermit(true);//支持JavaScript
        myWebView.getWebConfig().setUserAgent("android");//将UserAgent设置为安卓，授权页才显示QQ客户端一键登录按钮

自定义WebAgent

当WebView即将打开一个链接时调用isNeedLoadUrl方法，当在网页上点击“一键登录”时，打开QQ客户端
wtloginmqq是QQ安卓客户端URL Scheme

 if (request.getRequestUrl().toString().startsWith("wtloginmqq")){
                    // 打开QQ客户端
                    Intent qqIntent = new Intent();
                    Operation qqOperation = new Intent.OperationBuilder()
                            .withAction("android.intent.action.VIEW")
                            .withUri(Uri.parse(request.getRequestUrl().toString()))
                            .build();
                    qqIntent.setOperation(qqOperation);
                    startAbility(qqIntent);
}

==因为目前还找不到网页端唤起鸿蒙应用的方法，所以QQ客户端回调的code放在自己服务器处理。==
授权成功后，会打开之前在QQ开放平台设置的回调域redirect_uri
示例：https://api.dsttl3.cn/Redis/QQLogin?code=********&state=*****
code:QQ授权返回的code，用于申请token
state：在webview请求QQ授权页面时传入的唯一标识，用于判断用户身份，方便后续从服务器请求token
出于安全考虑 ，请求token操作放在服务器上执行。获取到token后将token存入数据库，客户端通过请求https://api.dsttl3.cn/Redis/Get?key= + state来获取到token
客户端请求到token后，将token存储到数据库

 // 将token存入数据库
Preferences preferences = new DatabaseHelper(getApplicationContext()).getPreferences("DATA_NAME");
preferences.putString("token",token);
preferences.flush();

token存储完成后跳转至MyAbility

自定义WebAgent完整代码

myWebView.setWebAgent(new WebAgent(){
            // 当WebView即将打开一个链接时调用该方法
            @Override
            public boolean isNeedLoadUrl(WebView webView, ResourceRequest request) {
                // request.getRequestUrl().toString() WebView即将打开的链接地址
                if (request.getRequestUrl().toString().startsWith("wtloginmqq")){
                    // 打开QQ客户端
                    Intent qqIntent = new Intent();
                    Operation qqOperation = new Intent.OperationBuilder()
                            .withAction("android.intent.action.VIEW")
                            .withUri(Uri.parse(request.getRequestUrl().toString()))
                            .build();
                    qqIntent.setOperation(qqOperation);
                    startAbility(qqIntent);
                    // 向自己的服务器请求token
                    new Thread(new Runnable() {
                        @Override
                        public void run() {
                            while (true){
                                String getTokenURL = "https://api.dsttl3.cn/Redis/Get?key=" + state;
                                try {
                                    OkHttpClient client = new OkHttpClient();
                                    Request request = new Request.Builder().url(getTokenURL).build();
                                    String token = client.newCall(request).execute().body().string();
                                    if (token.length() == 32){
                                        getUITaskDispatcher().asyncDispatch(new Runnable() {
                                            @Override
                                            public void run() {
                                                // 将token存入数据库
                                                Preferences preferences = new DatabaseHelper(getApplicationContext()).getPreferences("DATA_NAME");
                                                preferences.putString("token",token);
                                                preferences.flush();
                                                // 跳转至用户界面
                                                Intent myIntent = new Intent();
                                                Operation myOperation = new Intent.OperationBuilder()
                                                        .withBundleName("cn.dsttl3.test")
                                                        .withAbilityName("cn.dsttl3.qqlogin.MyAbility")
                                                        .build();
                                                myIntent.setOperation(myOperation);
                                                startAbility(myIntent);
                                                terminateAbility();
                                            }
                                        });
                                        break;
                                    }
                                    Time.sleep(1500);
                                } catch (IOException e) {
                                    e.printStackTrace();
                                }
                            }
                        }
                    }).start();
                    return false;
                }
                return true;
            }
        });

加载网页

myWebView.load(authorize_url);

LoginAbilitySlice.java完整代码

import cn.dsttl3.qqlogin.ResourceTable;
import ohos.aafwk.ability.AbilitySlice;
import ohos.aafwk.content.Intent;
import ohos.aafwk.content.Operation;
import ohos.agp.components.webengine.ResourceRequest;
import ohos.agp.components.webengine.WebAgent;
import ohos.agp.components.webengine.WebView;
import ohos.data.DatabaseHelper;
import ohos.data.preferences.Preferences;
import ohos.miscservices.timeutility.Time;
import ohos.utils.net.Uri;
import okhttp3.OkHttpClient;
import okhttp3.Request;
import java.io.IOException;
import java.util.UUID;

public class LoginAbilitySlice extends AbilitySlice {

    //QQ开放平台登录授权文档 https://wiki.connect.qq.com/%e5%87%86%e5%a4%87%e5%b7%a5%e4%bd%9c_oauth2-0
    String state = UUID.randomUUID().toString();// 唯一标识，成功授权后回调时会原样带回。
    String client_id = "101547151";//QQ开放平台 应用 APP ID
    String redirect_uri = "https%3A%2F%2Fapi.dsttl3.cn%2FRedis%2FQQLogin"; //应用 网站回调域 需进行url编码，授权成功后会跳转至该链接
    String authorize_url = "https://graph.qq.com/oauth2.0/authorize?response_type=code" +
            "&client_id=" + client_id +
            "&redirect_uri=" + redirect_uri +
            "&state="+ state;
    @Override
    public void onStart(Intent intent) {
        super.onStart(intent);
        super.setUIContent(ResourceTable.Layout_ability_login);
        WebView myWebView = (WebView) findComponentById(ResourceTable.Id_WebView_qqlogin);
        myWebView.getWebConfig().setJavaScriptPermit(true);
        myWebView.getWebConfig().setUserAgent("android");
        myWebView.setWebAgent(new WebAgent(){
            // 当WebView即将打开一个链接时调用该方法
            @Override
            public boolean isNeedLoadUrl(WebView webView, ResourceRequest request) {
                // request.getRequestUrl().toString() WebView即将打开的链接地址
                if (request.getRequestUrl().toString().startsWith("wtloginmqq")){
                    // 打开QQ客户端
                    Intent qqIntent = new Intent();
                    Operation qqOperation = new Intent.OperationBuilder()
                            .withAction("android.intent.action.VIEW")
                            .withUri(Uri.parse(request.getRequestUrl().toString()))
                            .build();
                    qqIntent.setOperation(qqOperation);
                    startAbility(qqIntent);
                    // 向自己的服务器请求token
                    new Thread(new Runnable() {
                        @Override
                        public void run() {
                            while (true){
                                String getTokenURL = "https://api.dsttl3.cn/Redis/Get?key=" + state;
                                try {
                                    OkHttpClient client = new OkHttpClient();
                                    Request request = new Request.Builder().url(getTokenURL).build();
                                    String token = client.newCall(request).execute().body().string();
                                    if (token.length() == 32){
                                        getUITaskDispatcher().asyncDispatch(new Runnable() {
                                            @Override
                                            public void run() {
                                                // 将token存入数据库
                                                Preferences preferences = new DatabaseHelper(getApplicationContext()).getPreferences("DATA_NAME");
                                                preferences.putString("token",token);
                                                preferences.flush();
                                                // 跳转至用户界面
                                                Intent myIntent = new Intent();
                                                Operation myOperation = new Intent.OperationBuilder()
                                                        .withBundleName("cn.dsttl3.test")
                                                        .withAbilityName("cn.dsttl3.qqlogin.MyAbility")
                                                        .build();
                                                myIntent.setOperation(myOperation);
                                                startAbility(myIntent);
                                                terminateAbility();
                                            }
                                        });
                                        break;
                                    }
                                    Time.sleep(1500);
                                } catch (IOException e) {
                                    e.printStackTrace();
                                }
                            }
                        }
                    }).start();
                    return false;
                }
                return true;
            }
        });
        myWebView.load(authorize_url);
    }
}

个人界面

获取token信息

Preferences preferences = new DatabaseHelper(getApplicationContext()).getPreferences("DATA_NAME");
String token = preferences.getString("token",null);

更新Text数据

Text text = findComponentById(ResourceTable.Id_text_helloworld);
text.setText(token);

后续操作
获取用户信息请参考QQ开放平台文档 https://wiki.connect.qq.com/get_user_info

其他第三方登录方式

微博第三方登录 https://harmonyos.51cto.com/posts/8640