HarmonyOS NEXT实战:接入QQ SDK

简介: 《HarmonyOS Next实战:集成三方SDK实现QQ登录功能》 本文详解如何在HarmonyOS应用中接入腾讯QQ开放平台SDK,完成QQ登录功能开发。内容涵盖开发者注册、应用申请、鸿蒙项目配置及SDK集成步骤,并提供代码示例与接入流程说明,助力教育类应用快速集成社交登录功能。

HarmonyOS Next实战##三方SDK##教育

参考资料
移动应用接入流程:
https://wiki.connect.qq.com/%e7%a7%bb%e5%8a%a8%e5%ba%94%e7%94%a8%e6%8e%a5%e5%85%a5%e6%b5%81%e7%a8%8b

HarmonyOS_SDK环境搭建:
https://wiki.connect.qq.com/harmonyos_sdk%e7%8e%af%e5%a2%83%e6%90%ad%e5%bb%ba

SDK Demo下载:
https://wiki.connect.qq.com/sdk%e4%b8%8b%e8%bd%bd

移动应用接入流程:
移动应用通过以下几个步骤,即可接入互联开放平台 [ https://connect.qq.com ] :
开发者注册 > 移动应用申请 > 移动应用开发 > 调用OpenAPI

  1. 开发者注册
    在QQ互联开放平台首页 http://connect.qq.com/ ,点击右上角的“登录”按钮,使用QQ账号登录,登录成功后会跳转到开发者注册页面,在注册页面需要提交公司或个人的基本资料。
  2. 移动应用接入申请
    · 移动应用接入前,需首先进行申请,获得对应的appid与appkey,以保证后续流程中可正确对移动应用与用户进行验证与授权。
    · 如果您的PC应用已经接入腾讯开放平台,则不需要重新获得appid与appkey,只需使用接入腾讯开放平台时获得的appid,即可添加为移动应用。
    · 添加移动应用:开发者注册成功后,会跳转到“管理中心”页面。点击“添加移动应用”,填写相应的信息。
    · 移动应用信息填写完成,点击“确定”后,移动应用注册完成,进入管理中心,可以查看到移动应用获取的appid和appkey
  3. 移动应用开发
    进入控制台页面,可以看到移动应用申请处于“开发”状态。移动应用上线,首先需对移动应用进行开发,即完成QQ登录功能并正常放置QQ登录按钮。
  4. 使用QQ互联提供的OpenAPI
    完成移动应用的开发后,即可在“管理中心”的“控制台”页面,点击“当前流程”下的“申请上线”,流程处于“审核”状态。
    提交审核后,腾讯会在两个工作日完成审核,审核通过后,移动应用即正式上线。

开发说明
QQ登录功能使用国际通用的OAuth2.0协议进行验证与授权,可通过以下方式进行移动应用开发:
(1)QQ互联分别提供了iOS和Android的SDK开发包。如果手机安装了QQ,则启动手机QQ进行SSO登录。如没有安装,则通过手机系统的浏览器进行登录。登录的流程已经集成在SDK里,建议开发者使用此方法。详见:SDK下载
(2)根据QQ登录OAuth2.0协议,自主开发,此方法自定义程度较高,需要与现有系统进行整合的移动应用可选用此方法。

鸿蒙项目配置:
添加依赖,执行命令

ohpm i @tencent/qq-open-sdk

运行后在工程级 oh-package.json5 文件中可看到新增依赖库

  "dependencies": {
   
    "@tencent/qq-open-sdk": "^1.0.3"
  }

修改模块配置:
修改entry的module.json5文件,配置skills

        "skills": [
          {
   
            "entities": [
              "entity.system.home",
              "entity.system.browsable"
            ],
            "actions": [
              "action.system.home",
              "ohos.want.action.viewData"
            ],
            "uris": [
              {
   
                "scheme": "qqopenapi", // 接收 QQ 回调数据
                "host": "xxxxxxxxx", // 业务申请的互联 appId,如果填错会导致 QQ 无法回调
                "pathRegex": "\\b(auth|share)\\b",
                "linkFeature": "Login",
              }
            ]
          }
        ]

继续修改entry的module.json5文件,增加querySchemes

    "querySchemes": [
      "https",
      "qqopenapi"
    ]

增加SDK工具类:
添加QQOpenApiHolder

import {
    SdkConfig } from '@heduohao/bases'
import {
    IQQOpenApi, OpenApiConfig, QQOpenApiFactory } from '@tencent/qq-open-sdk'

export class QQOpenApiHolder {
   
  private static qqOpenApi: IQQOpenApi

  private constructor() {
   

  }

  public static create(): IQQOpenApi {
   
    if (!QQOpenApiHolder.qqOpenApi) {
   
      let openApiOption: OpenApiConfig = {
   
        forceEnableWeb: false,
        autoHandleAuthResult: true,
      }

      QQOpenApiHolder.qqOpenApi =
        QQOpenApiFactory.createApi(SdkConfig.QQ_SDK_APP_ID, openApiOption)
    }
    return QQOpenApiHolder.qqOpenApi
  }

  public static getInstance(): IQQOpenApi {
   
    return QQOpenApiHolder.qqOpenApi
  }
}

EntryAbility接入QQOpenApiHolder

  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
   
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');
    QQOpenApiHolder.create()
  }

  onNewWant(want: Want, _launchParam: AbilityConstant.LaunchParam): void {
   
    QQOpenApiHolder.getInstance()?.handleResult(want)
  }
目录
相关文章
|
4月前
|
容器
HarmonyOS NEXT仓颉开发语言实战案例:外卖App
仓颉语言实战分享,教你如何用仓颉开发外卖App界面。内容包括页面布局、导航栏自定义、搜索框实现、列表模块构建等,附完整代码示例。轻松掌握Scroll、List等组件使用技巧,提升HarmonyOS应用开发能力。
|
3月前
|
移动开发 前端开发 JavaScript
鸿蒙NEXT时代你所不知道的全平台跨端框架:CMP、Kuikly、Lynx、uni-app x等
本篇基于当前各大活跃的跨端框架的现状,对比当前它们的情况和未来的可能,帮助你在选择框架时更好理解它们的特点和差异。
312 0
|
4月前
|
安全 API 开发工具
【HarmonyOS NEXT】一键扫码功能
这些Kit为我们应用开发提升了极大地效率。很多简单的功能,如果不需要太深的定制化需求,直接调用kit提供的API就可以实现,在android或者ios上需要很多代码才能实现的功能效果。
119 0
HarmonyOS NEXT仓颉开发语言实战案例:电影App
周末好!本文分享使用仓颉语言重构ArkTS实现的电影App案例,对比两者在UI布局、组件写法及语法差异。内容包括页面结构、列表分组、分类切换与电影展示等。通过代码演示仓颉在HarmonyOS开发中的应用。##仓颉##ArkTS##HarmonyOS开发
|
4月前
|
容器
HarmonyOS NEXT仓颉开发语言实战案例:健身App
本期分享一个健身App首页的布局实现,顶部采用Stack容器实现重叠背景与偏移效果,列表部分使用List结合Scroll实现可滚动内容。代码结构清晰,适合学习HarmonyOS布局技巧。
HarmonyOS NEXT仓颉开发语言实战案例:小而美的旅行App
本文分享了一个旅行App首页的设计与实现,使用List容器搭配Row、Column布局完成个人信息、功能列表及推荐模块的排版,详细展示了HarmonyOS下的界面构建技巧。
|
18天前
|
存储 缓存 5G
鸿蒙 HarmonyOS NEXT端云一体化开发-云存储篇
本文介绍用户登录后获取昵称、头像的方法,包括通过云端API和AppStorage两种方式,并实现上传头像至云存储及更新用户信息。同时解决图片缓存问题,添加上传进度提示,支持自动登录判断,提升用户体验。
90 0
|
18天前
|
存储 负载均衡 数据库
鸿蒙 HarmonyOS NEXT端云一体化开发-云函数篇
本文介绍基于华为AGC的端云一体化开发流程,涵盖项目创建、云函数开通、应用配置及DevEco集成。重点讲解云函数的编写、部署、调用与传参,并涉及环境变量设置、负载均衡、重试机制与熔断策略等高阶特性,助力开发者高效构建稳定云端服务。
178 0
鸿蒙 HarmonyOS NEXT端云一体化开发-云函数篇
|
18天前
|
存储 JSON 数据建模
鸿蒙 HarmonyOS NEXT端云一体化开发-云数据库篇
云数据库采用存储区、对象类型、对象三级结构,支持灵活的数据建模与权限管理,可通过AGC平台或本地项目初始化,实现数据的增删改查及端侧高效调用。
50 0
|
18天前
|
存储 开发者 容器
鸿蒙 HarmonyOS NEXT星河版APP应用开发-ArkTS面向对象及组件化UI开发使用实例
本文介绍了ArkTS语言中的Class类、泛型、接口、模块化、自定义组件及状态管理等核心概念,并结合代码示例讲解了对象属性、构造方法、继承、静态成员、访问修饰符等内容,同时涵盖了路由管理、生命周期和Stage模型等应用开发关键知识点。
150 0
鸿蒙 HarmonyOS NEXT星河版APP应用开发-ArkTS面向对象及组件化UI开发使用实例