ShareSDK HarmonyOS NEXT集成指南

集成前准备

注册账号

使用MobSDK之前,需要先在MobTech官网注册开发者账号,并获取MobTech提供的AppKey和AppSecret,详情可以点击查看注册流程
ShareSDK流程图

集成配置

添加依赖

在Terminal窗口中,执行如下命令进行安装

复制代码
ohpm install @mobsdk/mobcore
ohpm install @mobsdk/sharesdk
ohpm install @yyz116/jsbn 

权限配置

ShareSDK需要 INTERNET权限才可正常使用,请在工程中entry模块的 module.json5文件中,新增 requestPermissions,如下所示:

复制代码
"module": {
  "name": "xxx",
  "type": "entry",
  "description": "xxx",
  "mainElement": "xxx",
  "deviceTypes": [],
  "pages": "xxx",
  "abilities": [],
  // 配置如下
  "requestPermissions":[
    {
      "name": "ohos.permission.INTERNET"
    }
  ]
}

配置华为Client ID(可选)

如您需要使用华为授权,则需要配置client_id才可正常使用授权功能。

  1. 登录AppGallery Connect平台,在"我的项目"中选择目标应用,获取"项目设置 > 常规 > 应用"的Client ID。

  2. 在工程中entry模块的 module.json5文件中,新增
    metadata,配置name为client_id,value为上一步获取的Client ID的值,如下所示:

    "module": {
    "name": "xxx",
    "type": "entry",
    "description": "xxx",
    "mainElement": "xxx",
    "deviceTypes": [],
    "pages": "xxx",
    "abilities": [],
    "metadata": [ // 配置信息如下
    {
    "name": "client_id",
    "value": "xxx"
    }
    ]
    }

如果应用需要使用用户的手机号或其他更为精细化的配置,可参考华为官方文档进行配置。

方法调用

使用ShareSDK前,需调用以下代码初始化 MobSDK,该方法务必在使用SDK功能之前调用

复制代码
MobSDK.init(context, "您的AppKey", "您的AppSecret")

初始化完毕,且当用户主动同意您应用隐私协议后,需调用以下代码回传隐私协议授权状态

复制代码
MobSDK.submitPolicyGrantResult(true)

设置UIAbilityContext使用分享/授权功能,先设置需要的UIAbilityContext

复制代码
await mobShare.ShareSDK.getInstance().setUIAbilityContext(getContext() as common.UIAbilityContext)

调用以下代码,可快速实现分享功能

复制代码
let records: Array<mobShare.SharedParam> = new Array()
records.push({utd: mobShare.ShareType.TEXT,content: "测试分享文本",})
let receive: mobShare.PlatformActionListener = {
    onComplete: (platform: mobShare.IPlatform, action: number, res: Map<string, Object>) => {
       //成功回调
    },
    onError: (platform: mobShare.IPlatform, action: number, error: Error) => {
       //异常回调  
    },
    onCancel: (platform: mobShare.IPlatform, action: number) => {
       //取消回调
    }
}
let plat = mobShare.ShareSDK.getInstance().getPlatformAsync(mobShare.Platform.SYSTEM)
plat.setPlatformActionListener(receive)
plat.share(records, getContext(), {
           previewMode: mobShare.SharePreviewMode.DEFAULT,
           selectionMode: mobShare.SelectionMode.SINGLE
})

调用以下代码,可快速实现华为授权功能第三方平台授权

复制代码
let plat = mobShare.ShareSDK.getInstance().getPlatform(mobShare.Platform.HUAWEI)
let receive: mobShare.PlatformActionListener = {
    onComplete: (platform: mobShare.IPlatform, action: number, res: Map<string, Object>) => {
        //成功回调
    },
    onError: (platform: mobShare.IPlatform, action: number, error: Error) => {
        //异常回调  
    },
    onCancel: (platform: mobShare.IPlatform, action: number) => {
        //取消回调
    }
}
plat.setPlatformActionListener(receive)
plat.authorize(params)

获取指定账号的用户信息

复制代码
let plat = await mobShare.ShareSDK.getInstance().getPlatformAsync(mobShare.Platform.HUAWEI)
mobShare.ShareSDK.getInstance().getPlatformAsync(mobShare.Platform.SYSTEM).then((plat) => {})
let receive: mobShare.PlatformActionListener = {
    onComplete: (platform: mobShare.IPlatform, action: number, res: Map<string, Object>) => {
        //成功回调,获取用户信息:platform.getDb().exportData()
    },
    onError: (platform: mobShare.IPlatform, action: number, error: Error) => {
        //异常回调
    },
    onCancel: (platform: mobShare.IPlatform, action: number) => {
        //取消回调
    }
}
plat.setPlatformActionListener(receive)
plat.showUser()

判断是否已经存在授权状态

复制代码
mobShare.ShareSDK.getInstance().getPlatformAsync(mobShare.Platform.HUAWEI).then((plat) => {
  plat.isAuthValid().then((isAuth) => {
    //返回结果:isAuth true是已授权,false是未授权
  })
})

移除授权状态和本地缓存,下次授权会重新授权获取新的授权信息

复制代码
mobShare.ShareSDK.getInstance().getPlatform(mobShare.Platform.HUAWEI).removeAccount()

至此,ShareSDK已经集成完毕且已实现最基础的分享和授权功能,可以参考其他文档继续使用ShareSDK的其他功能。

相关推荐
愿你天黑有灯下雨有伞19 分钟前
枚举策略模式实战:优雅消除支付场景的if-else
java·开发语言·策略模式
Dcs1 小时前
gRPC性能陷阱:低延迟网络下的客户端瓶颈揭秘
java
xx.ii1 小时前
4.Linux 应用程序的安装和管理
linux·服务器·网络
探索java1 小时前
深入解析 Spring 获取 XML 验证模式的过程
xml·java·spring
找不到、了1 小时前
Java设计模式之<装饰器模式>
java·设计模式·装饰器模式
java叶新东老师1 小时前
解决windows系统下 idea、CLion 控制台中文乱码问题
java·windows·intellij-idea
岁忧2 小时前
(LeetCode 面试经典 150 题 ) 155. 最小栈 (栈)
java·c++·算法·leetcode·面试·go
奋斗的蛋黄2 小时前
解析分区、挂载与块设备:Linux 存储管理核心命令详解
linux·服务器·网络
yourkin6662 小时前
为什么现在 Spring Boot 默认使用 CGLIB 了?
java·开发语言·jvm
墨迹的陌离2 小时前
【Linux】重生之从零开始学习运维之Mysql
linux·运维·服务器·数据库·学习·mysql