1 Star 0 Fork 0

北京易观智库网络科技有限公司 / ans-ReactNative-sdk

Create your Gitee Account
Explore and code with more than 5 million developers,Free private repositories !:)
Sign up
Clone or download
Cancel
Notice: Creating folder will generate an empty file .keep, because not support in Git
Loading...
README.md

Analysys ReactNative SDK

易观方舟react-native-analysys模块,封装了易观 Android & iOS SDK 常用 API ,使用此模块,可以在 React Native 开发的 App 中完成埋点的统计上报。

npm模块安装

模块安装

npm install react-native-analysys

模块link

react-native link react-native-analysys

注意:React Native 0.60 及以上版本会 autolinking,不需要执行下边的 react-native link 命令。

Android端

SDK远程引入

dependencies
 { 
			//默认使用最新版本SDK,如需要使用特别版本请指定版本号 
			implementation('cn.com.analysys:analysys-arkanalysys:latest.release')') 
}

SDK初始化

public class AnalysysApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        
        //  设置 打开 debug 模式,上线时请屏蔽
        AnalysysAgent.setDebugMode(this, 2);
        //  对SDK开始初始化
        AnalysysConfig config = new AnalysysConfig();
        // 设置key,77a52s552c892bn442v721为样例数据,请根据实际情况替换相应内容
        config.setAppKey("77a52s552c892bn442v721");
        // 设置渠道
        config.setChannel("豌豆荚");
        // 设置控件点击自动上报总开关
        config.setAutoTrackClick(true);
        // 调用SDK初始接口
        AnalysysAgent.init(this, config);
        //  设置上传地址,http://example.com:port为您上报地址
        AnalysysAgent.setUploadURL(mContext,"http://example.com:port");

    }
}

RNAnalysysAgentPackage添加

    public class AnalysysApplication extends Application implements ReactApplication {
...
    @Override
    protected List<ReactPackage> getPackages() {
      return Arrays.<ReactPackage>asList(
            new RNAnalysysAgentPackage()
      );
    }
...
}

iOS端

集成方舟SDK

参考:方舟集成配置

方式一:CocoaPods 集成

  1. 工程目录下创建Podfile文件,并添加pod 'AnalysysAgent',示例如下:
platform :ios, '8.0'
use_frameworks!

target 'YourApp' do
    pod 'AnalysysAgent'
end
  1. 关闭Xcode,在工程目录下执行pod install或pod install --verbose --no-repo-update,完成后打开xxx.xcworkspace工程

方式二:手动引入

  1. 下载方舟最新版本SDK
  2. 选择 工程 - 右键 - Add Files to "ProjectName"
  3. 选择 AnalysysAgent.framework文件
  4. 勾选 Copy items if needed、Create groups- Add 完成添加类库
  5. 添加AnalysysAgent.bundle资源文件:Targets->ProjectName -> Build Phases -> Copy Bundle Resources -> 添加文件

2.2 初始化SDK

在Xcode工程文件~AppDelegate.m 中导入头文件"#import <AnalysysAgent/AnalysysAgent.h>",配置 SDK 相关内容。

#import <AnalysysAgent/AnalysysAgent.h>

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    //  设置key,77a52s552c892bn442v721为样例数据,请根据实际情况替换相应内容
    //  AnalysysAgent 配置信息
    AnalysysConfig.appKey = @"77a52s552c892bn442v721";
    // 设置渠道
    AnalysysConfig.channel = @"App Store";
    // 设置追踪新用户的首次属性
    AnalysysConfig.autoProfile = YES;
    // 设置上传数据使用AES加密,需添加加密模块
    //  AnalysysConfig.encryptType = AnalysysEncryptAES;
    //  使用配置初始化SDK
    [AnalysysAgent startWithConfig:AnalysysConfig];
    
    #if DEBUG
    [AnalysysAgent setDebugMode:AnalysysDebugButTrack];
#else
    [AnalysysAgent setDebugMode:AnalysysDebugOff];
#endif
    //  设置上报地址
    [AnalysysAgent setUploadURL:@"https://url:port""];
    
    ...
  return YES;
}

@end

React Native 中 JS 使用

在 js 中获取 RNAnalysysAgentModule 模块

//  易观统计模块
import { NativeModules } from "react-native";

const RNAnalysysAgentModule = NativeModules.RNAnalysysAgentModule;

接口调用

在相关需要进行统计的部分进行埋点。以点击购买事件为例:

//  事件名称为:buy(购买)  事件附加属性为:ptype(产品分类): iPhone; model(型号): iPhone X
var properties = {
    'ptype': 'iPhone',
    'model': 'Apple iPhoneX'
}
RNAnalysysAgentModule.track('buy',properties)

讨论

License

gpl-3.0

Comments ( 0 )

Sign in for post a comment

About

Cancel

Releases

No release

Contributors

All

Activities

load more
can not load any more
1
https://gitee.com/Analysys/ans-ReactNative-sdk.git
git@gitee.com:Analysys/ans-ReactNative-sdk.git
Analysys
ans-ReactNative-sdk
ans-ReactNative-sdk
master

Search