配置工程

简介

鹰眼iOS SDK支持的iOS 8及以上版本。鹰眼SDK及其文档会随着Xcode和iOS版本的升级进行更新,以保证您升级到新版的Xcode或iOS时,SDK功能依旧可用,且能顺利地配置和使用鹰眼SDK。


与V2版SDK相比,V3版SDK不再区分开发版和上架版,而只提供一个版本,支持所有的模拟器和真机CPU架构,开发者可以使用lipo命令,根据自身的需要合成自己所需的SDK。同时与V2版相比,V3版SDK的导入过程也简化了很多。

合成自己需要的CPU架构(可选)

可以直接使用鹰眼iOS SDK进行开发测试,但是上架到APP STORE时,由于苹果公司的要求,只能使用真机对应CPU架构的SDK,所以需要开发者需要使用lipo命令合成自身需要的CPU架构版本的SDK。lipo命令的使用方法如下:


第1步:检查当前库支持的CPU架构

输入命令:

lipo -info ./BaiduTraceSDK.framework/BaiduTraceSDK

终端回显:

Architectures in the fat file: ./BaiduTraceSDK.framework/BaiduTraceSDK are: i386 x86_64 armv7 armv7s arm64


第2步:剥离所需的CPU架构,这里以需要arm64和armv7为例:

输入命令:

mkdir armv7
mkdir arm64
lipo ./BaiduTraceSDK.framework/BaiduTraceSDK -thin arm64 -output ./arm64/BaiduTraceSDK
lipo ./BaiduTraceSDK.framework/BaiduTraceSDK -thin armv7 -output ./armv7/BaiduTraceSDK


第3步:检查上一步剥离出来的库支持的CPU架构是否符合要求:

输入命令:

lipo -info ./arm64/BaiduTraceSDK

终端回显:

Non-fat file: ./arm64/BaiduTraceSDK is architecture: arm64

输入命令:

lipo -info ./armv7/BaiduTraceSDK

终端回显:

Non-fat file: ./armv7/BaiduTraceSDK is architecture: armv7


第4步:将剥离出来的库合并成所需要的库,并替换framework中的库

输入命令:

lipo -create ./armv7/BaiduTraceSDK ./arm64/BaiduTraceSDK -output ./BaiduTraceSDK.framework/BaiduTraceSDK


第5步:清理中间产物

输入命令:

rm -rf ./arm64
rm -rf ./armv7


第6步:检查framework中的库支持的CPU架构

输入命令:

lipo -info ./BaiduTraceSDK.framework/BaiduTraceSDK

终端回显:

Architectures in the fat file: ./BaiduTraceSDK.framework/BaiduTraceSDK are: armv7 arm64


第7步:完成

导入 SDK

选择需要的Target,将 BaiduTracekSDK.framework 拖入其General选项卡中的Embedded Binaries栏即可。拖入之后Linked Framework and Libraries栏也会显示 BaiduTraceSDK.framework 项,同时检查 Build Phases 选项卡中的 Embed Frameworks 栏和 Link Binary With Libraries 栏也都显示成功导入 BaiduTraceSDK.framework 项。

plist文件设置

鹰眼iOS SDK需要使用后台定位权限,因此请在APP 的info.plist文件源码中增加以下声明,


并且为了 适配iOS11,在APP的info.plist文件中除了NSLocationAlwaysUsageDescription 字段,还需要配置上NSLocationAlwaysAndWhenInUseUsageDescription 和 NSLocationWhenInUseUsageDescription 字段

<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
    <string>鹰眼DEMO需要后台定位</string>
    <key>NSLocationWhenInUseUsageDescription</key>
    <string>鹰眼DEMO需要前台定位</string>
    <key>NSLocationAlwaysUsageDescription</key>
    <string>鹰眼DEMO需要后台定位</string>
    <key>UIBackgroundModes</key>
    <array>
        <string>location</string>
    </array>

编译选项设置

鹰眼iOS SDK目前暂不支持Bitcode,请确保 Build Settings 选项卡中的 Enable Bitcode 项设置为No。

鹰眼iOS SDK最低支持iOS 8.0系统,请确保 Build Settings 选项卡中的 iOS Deployment Target 不低于iOS8.0。