RangersAppLog 4.4.4

RangersAppLog 4.4.4

×

由chenyi、dwbbytedance维护。

RangersAppLog 4.4.4

  • by
  • duanwenbin

RangersAppLog

Demo演示

  1. git clone [email protected]:bytedance/RangersAppLog.git
  2. cd RangersAppLog/Eample
  3. pod install
  4. open RangersAppLog.xcworkspace

要求

特别说明，仅支持Xcode 11打包开发，Xcode 11以下，请单独联系开发提供SDK包

  • iOS 8.0+
  • Xcode 11

版本说明

  1. Lite版，埋点版本，即 subspecs => ['Core']
  2. 无埋点版本，即 subspecs => ['UITracker']
  3. 圈选版本，即 subspecs => ['Picker']

集成方式

或者参照Demo工程的Podfile

source 'https://cdn.cocoapods.org/'
source 'https://github.com/CocoaPods/Specs.git'

# 接入无埋点版本
target 'YourTarget' do
  pod 'RangersAppLog', '>= 4.4.1'
end

# 接入埋点版本 
target 'YourTarget' do
  pod 'RangersAppLog', '>= 4.4.1',:subspecs => ['Core']
end

集成指南

更多接口请参阅头文件和Demo工程。

初始化SDK

#import <RangersAppLog/RangersAppLogUITrack.h>

+ (void)startAppLog {
    BDAutoTrackConfig *config = [BDAutoTrackConfig new];
    config.appID = @"159486";
    config.channel = @"App Store";
    config.appName = @"dp_tob_sdk_test2";
	 config.autoTrackEnabled = YES;
    /// show debug log
    config.showDebugLog = YES;
    config.logger = ^(NSString * _Nullable log) {
        NSLog(@"%@",log);
    };

    [BDAutoTrack setABTestFinishBlock:^(BOOL ABTestEnabled, NSDictionary * allConfigs) {
        NSLog(@"-- ABTestEnabled(%tu)",ABTestEnabled);
    }];
    /// change to your UserUniqueID if now is loged in
    NSString *uniqueID = @"12345";
    BDAutoTrack *track = [BDAutoTrack trackWithConfig:config];
    /// change to your UserUniqueID if now is loged in
    NSString *uniqueID = @"12345";
    [track setCurrentUserUniqueID:uniqueID];
    [track startTrack];
}

用户态变化

+ (void)logout {
    [track clearUserUniqueID];
}

+ (void)login {
    /// change to your UserUniqueID
    NSString *uniqueID = @"12345";
    [track setCurrentUserUniqueID:uniqueID];
}

埋点事件上报

+ (void)eventV3:(NSString *)event params:(NSDictionary *)params {
    [track eventV3:event params:params];
}

Scheme上报

#import <RangersAppLog/RangersAppLogCore.h>

/// 如果是iOS 13中重写UISceneDelegate的回调，则按照i以下code
- (void)scene:(UIScene *)scene openURLContexts:(NSSet<UIOpenURLContext *> *)URLContexts {
    for (UIOpenURLContext *context in URLContexts) {
        NSURL *URL = context.URL;
        if ([[BDAutoTrackSchemeHandler sharedHandler] handleURL:URL appID:@"appid" scene:scene]) {
            continue;
        }

        /// your handle code for the URL
    }
}

/// 如果是iOS 13一下，重写UIApplicationDelegate的回调方法，则参考以下code
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options {
    if ([[BDAutoTrackSchemeHandler sharedHandler] handleURL:url appID:@"appid" scene:nil]) {
        return YES;
    }

    /// your handle code

    return NO;
}

版本更新记录

4.4.0

  • 解决无埋点hook与ReSwift、RxCocoa、RxDataSources等第三方SDK的冲突
  • 移除ABVersion相关接口
  • 优化OOM问题

4.3.0

  • 调整游戏预置埋点，接口与上一个版本不兼容

4.1.1

  • 通过Scheme启动圈选开关
  • 默认subspec集成所有功能
  • 移除did接口，新增BytedanceDeviceID接口
  • 安装包 795.99 KB

证书

本项目采用MIT证书。详细信息请参阅证书文件。