配置工程

鹰眼iOS SDK支持的iOS7及以上版本。鹰眼SDK及其文档会随着Xcode和iOS版本的升级进行更新,以保证您升级到新版的Xcode或iOS时,SDK功能依旧可用,且能顺利地配置和使用鹰眼SDK。下面的所有工程配置都是在Xcode Version 7.1.1上进行演示的。

1、打开Xcode,选择新建一个新的工程。

conf1.png

2、 鹰眼SDK包括了轨迹的采集上传和查询功能,这里不妨创建一个含有两个Tab的应用程序。在本文档中只介绍最简单的使用,详细的使用,请下载对应的DEMO代码示例。

conf2.png

3、下图中的Bundle Idntifier 即为前文我们提到过的安全码,其组成方式为Organization Identifier + Product Name。语言选择objective-C.鹰眼SDK采用swift语言编写,如果您的APP基于swift语言,可以方便地使用鹰眼SDK的功能。考虑到大多数开发者现在仍然使用objective-C作为自己的主要开发语言,这里先提供Objective-C版本的DEMO,swift版本的DEMO将于近期提供。

conf3.png

创建好的工程如下: conf4.png

4、导入鹰眼SDK的Framework。选择您的Target,在general选项卡中,找到Embedded Binaries这一项,将您下载的BaiduTraceSDK.framework文件拖到该项下的空白处。

conf5.png

单击Finish按钮,导入Framework后工程截图如下:

conf6.png

5、鹰眼SDK需要使用后台定位功能,另外由于iOS9改用更安全的https,为了能够在iOS9中正常使用鹰眼SDK,请在"Info.plist"中进行如下配置,否则影响SDK的使用。在工程的文件目录下,找到info.plist,按下图所示的方式以源码形式打开。

conf7.png

在其中添加如下XML代码

<key>NSAppTransportSecurity</key>
	<dict>
		<key>NSAllowsArbitraryLoads</key>
		<true/>
	</dict>
<key>NSLocationAlwaysUsageDescription</key>
	<string>需要持续定位</string>
	<key>UIBackgroundModes</key>
		<array>
			<string>location</string>
		</array>

6、 在您工程的.h头文件中添加如下内容:

#import <BaiduTraceSDK/BaiduTraceSDK-Swift.h>

7、在您工程的Target->Build Settings->Search Paths中找到Framework Search Paths选项,添加$(PROJECT_DIR)/ BaiduTraceSDK.framework/ 在其下方的Header Search Paths选项中,添加$(PROJECT_DIR)/BaiduTraceSDK.framework/Headers/ .

conf8.png

conf9.png

conf10.png

11.png

8、鹰眼SDK中,所有的查询信息返回的都是NSDATA类型的Json格式,在OC中,大家可能会用JSONKit这个开源库进行JSON的解析。由于该库很久没有人维护,不支持ARC模式,如果有需要可以使用我们维护的版本,您可以在鹰眼SDK的Objective-C版本的DEMO中找到JSONKit.h和JSONKit.m文件。强调一下,这两个文件版权不归百度鹰眼所有,遵循BSD协议,JSONKit库的原作者为John Engelhart,具体的版权规定请看这两个文件上方的版权注释。另外,在您导入这两个文件之后,您还需要在您的Target->Build Phases->Compile Sources选项中找到JSONKit.m,增加-fno-objc-arc 参数。

conf12.png

9、鹰眼SDK由swift语言编写, 请在Build Settings-> Build Options-> Embedded Content Contains Swift Code 选项设置成Yes, 以保证您的工程可以使用swift编写的SDK.

conf10.png

10、经过以上配置后,即可正常使用鹰眼轨迹 iOS SDK。