iOS小明开发笔记(十八) (百度地图框架配置)

1. 配置info.plist文件

a. 模拟器联网配置(Xcode7之后需要配置) "iOS9改用更安全的https的缘故"

    <key>NSAppTransportSecurity</key>

    <dict>

    <key>NSAllowsArbitraryLoads</key>

    <true/>

    </dict>

b. 如果在iOS9中使用了调起百度地图客户端功能，必须在"Info.plist"中进行如下配置，否则不能调起百度地图客户端

    <key>LSApplicationQueriesSchemes</key>

    <array>

    <string>baidumap</string>

    </array>

c. iOS8的定位能力做兼容 以下二选一，两个都添加默认使用第一个

    (1) NSLocationWhenInUseUsageDescription ，允许在前台使用时获取GPS的描述

    (2) NSLocationAlwaysUsageDescription ，允许永久使用GPS的描述 "推荐使用这个"

    也可以在info.plist中添加该行代码

    <key>NSLocationAlwaysUsageDescription</key>

    <true/>

d. 添加：Bundle display name ，且其值不能为空（Xcode6新建的项目没有此配置，若没有会造成manager start failed）

    这里对应的值可以随意取值

    <key>CFBundleDisplayName</key>

    <string>Bundle display name</string>

2. 申请密钥: "网址 http://lbsyun.baidu.com/apiconsole/key" 保证填写的安全码跟工程中的Bundle identifier的值一致, 否则无效

3. 在Xcode的Project -> Edit Active Target -> Build -> Linking -> Other Linker Flags中添加-ObjC "若只在xib文件中使用BMKMapView但是在代码中没有实现, 需要配置该选项"

4. "建议选用任意一个.m文件改名为.mm文件"静态库中采用Objective-C++实现，因此需要您保证您工程中至少有一个.mm后缀的源文件(您可以将任意一个.m后缀的文件改名为.mm)，或者在工程属性中指定编译方式，即将Xcode的Project -> Edit Active Target -> Build -> GCC4.2 - Language -> Compile Sources As设置为"Objective-C++"

"使用cocoaPod导入百度地图SDK"

    使用CocoaPods导入地图SDK

    在当前工程文件（.xcodeproj）所在文件夹下，打开terminal

    1. vim Podfile

    2.编辑Podfile内容如下：

        platform :ios, '9.2'

        pod 'Baidu-Maps-iOS-SDK', '~>2.8.1'

    3.在Podfile所在的文件夹下输入命令：

    pod install "如果终端出现updating local specs repositories,那么请用ctrl+c强制结束命令进程,然后执行 pod install --verbose --no-repo-update 或者 pod install --no-repo-update"

    成功以后，会出现如下记录：

    Analyzing dependencies

    Downloading dependencies

    Installing Baidu-Maps-iOS-SDK (2.8.1)

    Generating Pods project

    Integrating client project

    [!] Please close any current Xcode sessions and use `***.xcworkspace` for this project from now on.

    Sending stats

    恭喜你已成功导入百度地图iOS SDK，现在就可以打开xcworkspace文件，在你的项目中使用百度地图SDK了

"如果在使用cocoaPod中出现什么问题, 请参照我的cocoaPod使用说明"

"如果导入成功, 则5~7无需执行"

5. 根据需求导入对应的.framework包

    百度地图 iOS SDK 采用分包的形式提供 .framework包，请广大开发者使用时确保各分包的版本保持一致。其中BaiduMapAPI_Base.framework为基础包，使用SDK任何功能都需导入，其他分包可按需导入。

    将所需的BaiduMapAPI_**.framework拷贝到工程所在文件夹下。

    在 TARGETS->Build Phases-> Link Binary With Libaries中点击“+”按钮，在弹出的窗口中点击“Add Other”按钮，选择BaiduMapAPI_**.framework添加到工程中。

6. 引入所需的系统库

    百度地图SDK中提供了定位功能和动画效果，v2.0.0版本开始使用OpenGL渲染，因此您需要在您的Xcode工程中引入

    CoreLocation.framework和QuartzCore.framework、OpenGLES.framework、SystemConfiguration.framework、CoreGraphics.framework、Security.framework、"libsqlite3.0.tbd（xcode7以前为 libsqlite3.0.dylib）、CoreTelephony.framework 、libstdc++.6.0.9.tbd（xcode7以前为libstdc++.6.0.9.dylib）"。

    （注：红色标识的系统库为v2.9.0新增的系统库，使用v2.9.0及以上版本的地图SDK，务必增加导入这3个系统库。）

    添加方式：在Xcode的Project -> Active Target ->Build Phases ->Link Binary With Libraries，添加这几个系统库即可。

7. 引入mapapi.bundle资源文件

    如果使用了基础地图功能，需要添加该资源，否则地图不能正常显示mapapi.bundle中存储了定位、默认大头针标注View及路线关键点的资源图片，还存储了矢量地图绘制必需的资源文件。如果您不需要使用内置的图片显示功能，则可以删除bundle文件中的image文件夹。您也可以根据具体需求任意替换或删除该bundle中image文件夹的图片文件。

    方法：选中工程名，在右键菜单中选择Add Files to “工程名”…，从BaiduMapAPI_Map.framework||Resources文件中选择mapapi.bundle文件，并勾选“Copy items if needed”复选框，单击“Add”按钮，将资源文件添加到工程中。

8. 头文件解释

    在使用SDK的类 按需 引入下边的头文件：

    #import <BaiduMapAPI_Base/BMKBaseComponent.h>//引入base相关所有的头文件

    #import <BaiduMapAPI_Map/BMKMapComponent.h>//引入地图功能所有的头文件

    #import <BaiduMapAPI_Search/BMKSearchComponent.h>//引入检索功能所有的头文件

    #import <BaiduMapAPI_Cloud/BMKCloudSearchComponent.h>//引入云检索功能所有的头文件

    #import <BaiduMapAPI_Location/BMKLocationComponent.h>//引入定位功能所有的头文件

    #import <BaiduMapAPI_Utils/BMKUtilsComponent.h>//引入计算工具所有的头文件

    #import <BaiduMapAPI_Radar/BMKRadarComponent.h>//引入周边雷达功能所有的头文件

    #import < BaiduMapAPI_Map/BMKMapView.h>//只引入所需的单个头文件

10. 常见错误

    在使用地图定位的时候, 如果重复定义BMKLocationService的对象的话, 会发生定位失败

    构建定位服务的时候, 用property "weak"定义BMKLocationService对象, 会出现弹框闪一下消失的情况

    定位的时候出现: :Error Domain=kCLErrorDomain Code=0 "(null)" 错误

        解决方法: 1.模拟器Debug->Location->CustomLocation给经纬度 2.Xcode->Scheme->EditScheme->Options->勾选CoreLocation设置DefaultLocation为中国北京

    Error Domain=kCLErrorDomain Code=1 "(null)" 错误

        解决方法:系统授权问题