工程配置

• 注意：集成基础组件库 2.0.0以下及统计SDK 8.0.0以下版本的用户，请参考release1.0.0分支中样例代码集成。

首先需要说明，React Native下载的只是桥接文件，不含最新版本的jar，对应组件的jar请去下载中心下载。 如果对于文档仍有疑问的，请参照我们在github上的demo

Android

初始化

将下载的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，可以为空）。

至此，所有的工程配置已经完成，接下来请按照各个组件的文档进行初始化。

iOS

初始化

• 将已下载的友盟SDK添加到项目

• 添加需要的组件桥接文件

• 添加友盟初始化配置文件

• 在 Appdelegate.m 中设置初始化代码

#import "RNUMConfigure.h"

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
  [UMConfigure setLogEnabled:YES];
  [RNUMConfigure initWithAppkey:@"599d6d81c62dca07c5001db6" channel:@"App Store"];
  ...
}

接口说明

统计

Android

初始化

首先需要找到Activity的生命周期，添加如下代码：

  @Override
    public void onResume() {
        super.onResume();
        MobclickAgent.onResume(this);
    }
    @Override
    protected void onPause() {
        super.onPause();
        MobclickAgent.onPause(this);
    }

并在onCreat中设置统计的场景，以及发送间隔：

MobclickAgent.setSessionContinueMillis(1000*40);

iOS

初始化

在工程的 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

初始化

首先，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 以及 初始化设置部分

iOS

初始化

Push SDK 的平台配置与单独 Native 项目集成相同，请参考 接入Push SDK 以及 初始化设置部分

接口说明

首先需要引入PushUtil文件：

import PushUtil from './PushUtil'

添加tag

 PushUtil.addTag(tag,(code,remain) =>{
            
        })

• tag 此参数为tag
• callback 第一个参数code为错误码，当为0时标记成功。remain为remain值

删除tag

  PushUtil.deleteTag(tag,(code,result) =>{
          
        })

• tag 此参数为tag
• callback 第一个参数code为错误码，当为0时标记成功。remain为remain值

展示tag

  PushUtil.listTag((code,result) =>{
            
        })

• callback 第一个参数code为错误码，当为0时标记成功。result为一个数组类型，内容为所有tag

添加Alias

PushUtil.addAlias(alias,type,(code) =>{
          
        })

• alias 此参数为alias
• type 此参数为alias type

添加额外Alias

PushUtil.addExclusiveAlias(alias,type,(code) =>{
          
        })

• alias 此参数为alias
• type 此参数为alias type

删除Alias

PushUtil.deleteAlias(alias,type,(code) =>{
          
        })

• alias 此参数为alias
• type 此参数为alias type

appinfo

PushUtil.appInfo((result) =>{

        })

• callback result为一个字符串类型，标记结果

Share

Android

初始化

在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);
    }

分享其它工程配置请参照分享工程配置

iOS

初始化

UShare SDK 的平台配置与单独 Native 项目集成相同，请参考 接入U-Share SDK 以及 初始化设置部分

接口说明

首先需要引入ShareUtil文件：

import ShareUtile from './ShareUtil'

授权

授权代码可以直接使用ShareUtile.auth(platform,callback)，其中platform为平台id，callback为回调内容。 平台与id的对应关系如下：

回调示例如下：

  ShareUtile.auth(0,(code,result,message) =>{
            this.setState({result:message});
            if (code == 0){
                this.setState({result:result.uid});
            }
        });

其中code为错误码，当为0时标记为成功。 其中message为错误信息。 其中result属性如下：

分享

分享示例如下：

 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为错误信息