- 注意:集成基础组件库 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
:
private final ReactNativeHost mReactNativeHost = new ReactNativeHost(this) {
@Override
public boolean getUseDeveloperSupport() {
return BuildConfig.DEBUG;
}
@Override
protected List<ReactPackage> getPackages() {
return Arrays.<ReactPackage>asList(
new MainReactPackage(),
new DplusReactPackage()
);
}
};
并在onCreate()
中进行初始化:
@Override
public void onCreate() {
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为错误信息