友盟+ React Native官方集成示例，覆盖U-App、U-Push、U-Share以及Android/iOS原生桥接。
为保持历史链接、Clone地址和开发流程稳定，本仓库继续保留历史名称
React_Native_Compent；对外文案统一使用正确拼写React Native Component。
- 注意：集成基础组件库 2.0.0以下及统计SDK 8.0.0以下版本的用户，请参考release1.0.0分支中样例代码集成。
首先需要说明，React Native下载的只是桥接文件，不含最新版本的jar，对应组件的jar请去下载中心下载。 如果对于文档仍有疑问的，请参照我们在github上的demo
将下载的jar放入app下的libs中：
首先需要拷贝common_android文件夹中的文件拷贝到你的工程中：
然后再将对应平台的桥接文件拷入你的工程：
需要注意如果你拷入的路径不是com.umeng.soexample.invokenative请将桥接文件中的路径修改为你工程的路径：
打开Application文件，添加DplusReactPackage：
privatefinalReactNativeHostmReactNativeHost = newReactNativeHost(this) {
@OverridepublicbooleangetUseDeveloperSupport() {
returnBuildConfig.DEBUG;
}
@OverrideprotectedList<ReactPackage> getPackages() {
returnArrays.<ReactPackage>asList(
newMainReactPackage(),
newDplusReactPackage()
);
}
};
并在onCreate()中进行初始化：
@OverridepublicvoidonCreate() {
super.onCreate();
SoLoader.init(this, /* native exopackage */false);
RNUMConfigure.init(this, "59892f08310c9307b60023d0", "Umeng", UMConfigure.DEVICE_TYPE_PHONE,
"669c30a9584623e70e8cd01b0381dcb4");
}
RNUMConfture.init接口一共五个参数，其中第一个参数为Context，第二个参数为友盟Appkey，第三个参数为channel，第四个参数为应用类型（手机或平板），第五个参数为push的secret（如果没有使用push，可以为空）。
至此，所有的工程配置已经完成，接下来请按照各个组件的文档进行初始化。
- 将已下载的友盟SDK添加到项目
- 添加需要的组件桥接文件
- 添加友盟初始化配置文件
- 在 Appdelegate.m 中设置初始化代码
#import "RNUMConfigure.h"
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
[UMConfigure setLogEnabled:YES];
[RNUMConfigure initWithAppkey:@"599d6d81c62dca07c5001db6" channel:@"App Store"];
...
}
首先需要找到Activity的生命周期，添加如下代码：
@Override
public void onResume() {
super.onResume();
MobclickAgent.onResume(this);
}
@Override
protected void onPause() {
super.onPause();
MobclickAgent.onPause(this);
}
并在onCreat中设置统计的场景，以及发送间隔：
MobclickAgent.setSessionContinueMillis(1000*40);
在工程的 AppDelegate.m 文件中引入相关组件头文件 ，且在 application:didFinishLaunchingWithOptions: 方法中添加如下代码：
[MobClick setScenarioType:E_UM_NORMAL];
如果需要引入多个场景：
[MobClick setScenarioType:E_UM_E_UM_GAME|E_UM_DPLUS];
js部分首先需要引入AnalyticsUtil文件：
import AnalyticsUtil from './AnalyticsUtil'
AnalyticsUtil.onPageStart(pageName);
- pageName 页面名称
AnalyticsUtil.onPageEnd(pageName);
- pageName 页面名称
AnalyticsUtil.onEvent(eventId);
AnalyticsUtil.onEventWithLable(eventId,eventLabel);
AnalyticsUtil.onEventWithMap(eventId,eventData);
AnalyticsUtil.onEventWithMapAndCount(eventId,eventData,eventNum);
AnalyticsUtil.onEventObject(eventId,eventData);
- eventId 为当前统计的事件ID
- eventLabel 为分类标签
- eventData 为当前事件的属性和取值（键值对），不能为空，如：{name:"umeng",sex:"man"}
- eventNum 用户每次触发的数值的分布情况，如事件持续时间、每次付款金额等
AnalyticsUtil.profileSignInWithPUID(puid);
- puid 用户账号ID.长度小于64字节
AnalyticsUtil.profileSignInWithPUIDWithProvider(provider,puid);
- provider： 账号来源。 puid： 用户账号ID。长度小于64字节.
AnalyticsUtil.profileSignOff()；
- 账号登出时需调用此接口，调用之后不再发送账号相关内容
AnalyticsUtil.registerPreProperties(property);
- 注册预置事件属性。property 事件的超级属性（可以包含多对“属性名-属性值”）,如：{name:"umeng",sex:"man"}
AnalyticsUtil.unregisterPreProperty(propertyName);
- 注销预置事件属性。propertyName，要注销的预置事件属性名。
AnalyticsUtil.getPreProperties(context);
- 获取预置事件属性, 返回包含所有预置事件属性的JSONObject。
AnalyticsUtil.clearPreProperties();
- 清空全部预置事件属性。
AnalyticsUtil.setFirstLaunchEvent(eventList);
- eventList 只关注eventList前五个合法eventID.只要已经保存五个,此接口无效,如：["list1","list2","list3"]
首先，Android push需要让Android app依赖我们提供的push module，再根据文档进行相应的初始化。 找到React Native使用的Activity，添加初始化代码：
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
PushModule.initPushSDK(this);
PushAgent.getInstance(this).onAppStart();
}
Push SDK 的平台配置与单独 Native 项目集成相同，请参考 接入Push SDK 以及 初始化设置部分
Push SDK 的平台配置与单独 Native 项目集成相同，请参考 接入Push SDK 以及 初始化设置部分
首先需要引入PushUtil文件：
import PushUtil from './PushUtil'
PushUtil.addTag(tag,(code,remain) =>{
})
- tag 此参数为tag
- callback 第一个参数code为错误码，当为0时标记成功。remain为remain值
PushUtil.deleteTag(tag,(code,result) =>{
})
- tag 此参数为tag
- callback 第一个参数code为错误码，当为0时标记成功。remain为remain值
PushUtil.listTag((code,result) =>{
})
- callback 第一个参数code为错误码，当为0时标记成功。result为一个数组类型，内容为所有tag
PushUtil.addAlias(alias,type,(code) =>{
})
- alias 此参数为alias
- type 此参数为alias type
PushUtil.addExclusiveAlias(alias,type,(code) =>{
})
- alias 此参数为alias
- type 此参数为alias type
PushUtil.deleteAlias(alias,type,(code) =>{
})
- alias 此参数为alias
- type 此参数为alias type
PushUtil.appInfo((result) =>{
})
- callback result为一个字符串类型，标记结果
在Application中设置使用的三方平台的appkey：
{
PlatformConfig.setWeixin("wxdc1e388c3822c80b", "3baf1193c85774b3fd9d18447d76cab0");
//豆瓣RENREN平台目前只能在服务器端配置
PlatformConfig.setSinaWeibo("3921700954", "04b48b094faeb16683c32669824ebdad", "http://sns.whalecloud.com");
PlatformConfig.setYixin("yxc0614e80c9304c11b0391514d09f13bf");
PlatformConfig.setQQZone("100424468", "c7394704798a158208a74ab60104f0ba");
}
找到React Native使用的Activity，添加初始化代码：
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
ShareModule.initSocialSDK(this);
}
并添加回调所需代码：
@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
UMShareAPI.get(this).onActivityResult(requestCode, resultCode, data);
}
分享其它工程配置请参照分享工程配置
UShare SDK 的平台配置与单独 Native 项目集成相同，请参考 接入U-Share SDK 以及 初始化设置部分
首先需要引入ShareUtil文件：
import ShareUtile from './ShareUtil'
授权代码可以直接使用ShareUtile.auth(platform,callback)，其中platform为平台id，callback为回调内容。
平台与id的对应关系如下：
| id | 平台 | 备注 |
|---|---|---|
| 0 | ||
| 1 | SINA | |
| 2 | 微信 | |
| 3 | 朋友圈 | |
| 4 | QQ空间 | |
| 5 | 电子邮件 | |
| 6 | 短信 | |
| 7 | ||
| 8 | ||
| 9 | 微信收藏 | |
| 10 | google+ | |
| 11 | 人人 | |
| 12 | 腾讯微博 | |
| 13 | 豆瓣 | |
| 14 | facebook messager | |
| 15 | 易信 | |
| 16 | 易信朋友圈 | |
| 17 | ||
| 18 | ||
| 19 | 印象笔记 | |
| 20 | ||
| 21 | ||
| 22 | FOURSQUARE | |
| 23 | 有道云笔记 | |
| 24 | ||
| 25 | LINE | |
| 26 | FLICKR | |
| 27 | TUMBLR | |
| 28 | 支付宝 | |
| 29 | KAKAO | |
| 30 | DROPBOX | |
| 31 | VKONTAKTE | |
| 32 | 钉钉 | |
| 33 | 系统菜单 |
回调示例如下：
ShareUtile.auth(0,(code,result,message) =>{
this.setState({result:message});
if (code == 0){
this.setState({result:result.uid});
}
});
其中code为错误码，当为0时标记为成功。 其中message为错误信息。 其中result属性如下：
| 属性 | 含义 |
|---|---|
| uid | uid |
| screen_name | 用户名 |
| iconurl | 头像 |
| accessToken | accessToken |
| refreshToken | refreshToken |
| gender | gender |
| unionid | unionid |
| openid | openid |
| expires_in | 过期时间 |
分享示例如下：
ShareUtile.share(text,img,url,title,platform,(code,message) =>{
this.setState({result:message});
});
- text 为分享内容
- img 为图片地址，可以为链接，本地地址以及res图片（如果使用res,请使用如下写法：
res/icon.png） - url 为分享链接，可以为空
- title 为分享链接的标题
- platform为平台id，id对照表与授权相同
- callback中code为错误码，当为0时，标记成功。message为错误信息
分享面板示例如下：
ShareUtile.shareboard(text,img,url,title,list,(code,message) =>{
this.setState({result:message});
});
- text 为分享内容
- img 为图片地址，可以为链接，本地地址以及res图片（如果使用res,请使用如下写法：
res/icon.png） - url 为分享链接，可以为空
- title 为分享链接的标题
- list 为分享平台数组，如：
var list = [0,1,2] - callback中code为错误码，当为0时，标记成功。message为错误信息
遇到 SDK 接入、消息推送、崩溃分析、小程序统计或 AI 工具问题，可访问：