跳转到主要内容
PRODUCT DOCUMENTS

快速找到所需文档,高效完成接入与排障

浏览产品文档与友盟 Skill,展开目录并阅读正文。

快速开始

一、安装SDK

在项目的根目录下执行如下命令

注:当前支持微信好友、微信朋友圈、微博、QQ好友、QQ空间、钉钉的分享和登录功能。

ohpm install @umeng/common --registry=https://ohpm.openharmony.cn/ohpm
ohpm install @umeng/analytics --registry=https://ohpm.openharmony.cn/ohpm
ohpm install @umeng/share --registry=https://ohpm.openharmony.cn/ohpm

注 @umeng/common要在v1.0.24版本及以上。

二、集成SDK

  1. 在项目的AppScope/resources/rawfile目录下新增一个配置文件umconfig.json,

image.jpg

文件内容如下

{
  "appKey": "你的apppkey",  
  "channel": "你的渠道",
}

  1. 在应用模块目录下,添加abilityStage工程文件,例如entry/src/main/ets/abilityStage/MyAbilityStage.ets,具体位置如下图

1

文件内容如下

// entry/src/main/ets/abilityStage/MyAbilityStage.ets
import AbilityStage from '@ohos.app.ability.AbilityStage';
import { init, preInit, InternalPlugin } from '@umeng/analytics';
import { SharePlugin } from "@umeng/share";
     
export default class MyAbilityStage extends AbilityStage {
  onCreate() {
    preInit({
      context: this.context.getApplicationContext(),
      enableLog: true,  // 开发时,打开调试日志,可观察sdk是否集成成功
      plugins: [
        new InternalPlugin(),
        new SharePlugin({
          // 微信配置,可选
          WX_APPID: 'wx167efce1c3229999', // 微信开放平台审核通过的APPID
          WX_AppSecret: 'wxwxwxwxwxwxxx', // 微信开放平台审核通过的AppSecret
          // 微博配置,可选(v1.1.5版本及以上支持)
          Weibo_Config: { 
            appkey: "3313904948", // 必选,微博开放平台的appkey
            redirect_url: "https://api.weibo.com/oauth2/default.html", // 可选,开放平台的授权回调页
            scope: "email,direct_messages_read,direct_messages_write,"
              + "friendships_groups_read,friendships_groups_write,statuses_to_me_read,"
              + "follow_app_official_microblog," + "invitation_write", // 可选,注意:scope为"",表示没有申请的高级权限,则走快捷授权流程
            logEnable: true, // 可选,微博sdk的日志,调试时可以打开log开关 默认是false
          },
          // qq配置,可选(v1.1.8版本及以上支持)
          QQ_Config: { 
            appId: 1112396455, // qq互联平台应用的APPID
            appkey: "xq66VShoCDSUsALB", // qq互联平台应用的appkey
          }
          // 钉钉配置,可选(v1.1.10版本及以上支持)
          DingTalk_Config: { 
            appId: "dingf5sxbvfp2guwbd6s", // 钉钉平台的 Client ID
            redirectUri: "https://bbs-img-coloros-net.oss-cn-beijing.aliyuncs.com/", // 钉钉登陆 授权回调页
          }
        })
      ],
    });
    init(); // 初始化,在用户同意隐私政策后再调用此方法
  }
}

2.1 微信平台创建应用 微信开放平台获取APPID和AppSecret,需要审核通过后可用,参见下图 imgpng

2.2 微博平台创建应用 微博开放平台获取appkey,需要先调用sdk的Weibo.getSign()方法得到应用的签名(也可以用户自行通过bundleManager.getBundleInfoForSelf获取到bundleInfo.signatureInfo.appIdentifier的值,再md5加密得到签名),再前往微博开放平台创建应用输入签名,待审核通过后即可使用分享功能。参见下图

image

2.3 QQ互联平台创建应用 QQ互联平台获取APPID和APPKey,需要审核通过后可用,参见下图 

image

2.4 钉钉平台创建应用 获取Client ID 和 redirectUri (登录后台配置中添加此回调地址),可参考钉钉的分享与登录配置。 钉钉分享后台适配,钉钉登录后台配置。

image

  1. 在模块的的module.json5文件中添加 srcEntry ,指向abilityStage文件的地址

2

  1. 在模块的module.json5文件中添加权限声明

"requestPermissions": [
  {
    "name": "ohos.permission.INTERNET"
  },
  {
    "name": "ohos.permission.GET_NETWORK_INFO"
  }
],

参考下图

3

  1. 注意在适当位置(preInit方法调用之后),经用户授权同意隐私政策后调用init方法,才会开始日志的采集和传输。

  1. 完成以上步骤后,即可按照集成文档中方式调用使用。