【本文正在参与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
https://harmonyos.51cto.com/#bkwz
::: hljs-center
:::