English
Log In
You can then view all documents
增长参谋/数据接入文档/Applog接入文档(iOS)
Applog接入文档(iOS)
Last updated 2022-04-22 19:33:19

1.环境准备

  • iOS 8.0 及以上
  • Xcode 10.0+

2. 导入SDK

2.1 使用CocoaPods安装SDK

在Podfile中,添加source源:

source https://github.com/volcengine/volcengine-specs.git

source https://github.com/bytedance/cocoapods_sdk_source_repo.git

和SDK引用:

pod RangersAppLog , 6.2.3 ,:subspecs => [ Host/CN , Core , Unique , UITracker , Log , Picker , OneKit ]

执行 pod install --repo-update 更新Pods。注意: 正在使用 5.x 版本的,建议使用 6.x 的最新版本注意: 如果您不想采集 IDFA 的,请去掉 Unique 库。注意: 需要给 GitHub 配置 ssh key。注意: iOS 如果使用 swift 语言,pod 需要自己桥接,<targetname>/Bridging-Header.h。注意: 使用6.2.0及以上版本需添加subspecs => OneKit。

2.2手动安装SDK

注意 6.x 版本开始默认不提供 sdk 包,需要的话请联系技术支持。下载 RangersAppLog iOS SDK 并解压缩。将RangersAppLog-Lite.a、RangersAppLog-Picker.a、RangersAppLog-UITracker.a和 Headers 目录复制到项目文件夹下,并在xcode中依次添加到项目中。

2.3添加依赖

如果您使用CocoaPods安装,请跳过这一步。

  • libz.tbd
  • libsqlite3.tbd
  • CoreFoundation.framework
  • CoreTelephony.framework、(读取运营商名称)
  • SystemConfiguration.framework、(判断网络状态)
  • Security.framework、(APP连接圈选页面SSL连接)
  • Foundation.framework、(不使用全埋点的圈选功能不需要依赖)
  • UIKit.framework、(不使用全埋点的圈选功能不需要依赖)
  • JavaScriptCore.framework、(不使用全埋点的圈选功能不需要依赖)
  • WebKit.framework、(不使用全埋点的圈选功能不需要依赖)
  • AdSupport.framework、(不采集idfa不引入Unique则不需要依赖)

同时需要添加编译项 other linker flags,如下图:

  • -ObjC
  • 或者-force_load $(PROJECT_DIR)/yourpath/[RangersAppLog.framework/Versions/A/RangersAppLog](http://RangersAppLog.framework/Versions/A/RangersAppLog)

3. 添加URL Scheme

在应用信息中找到URL Scheme:

将URL Scheme添加到你的项目中:

如果是iOS 13,重写UISceneDelegate的回调方法:

如果iOS版本低于13,则重写UIApplicationDelegate的回调方法

4.初始化SDK

请在App启动完成的时候,就初始化配置(如果在页面展示完毕之后 才初始化配置,会导致部分事件采集有缺失)。


Contents
Contact us