iOS陆哥开发笔记(二十一) (百度地图框架配置)
2016-04-14 18:02
537 查看
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)" 错误
解决方法:系统授权问题
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)" 错误
解决方法:系统授权问题
相关文章推荐
- iOS陆哥开发笔记(二十) (Quartz2D屏幕截图)
- 分析iOS Crash文件:符号化iOS Crash文件的3种方法
- iOS陆哥开发笔记(十九) (Quartz2D图片剪切)
- iOS开发中的小Tips
- ios Method Swizzling学习笔记
- iOS陆哥开发笔记(十八) (Quartz2D矩阵操作)
- iOS陆哥开发笔记(十六) (Quartz2D简单使用二)
- iOS陆哥开发笔记(十五) (Quartz2D简单使用一)
- iOS陆哥开发笔记(十四) (Quartz2D简单介绍)
- iOS陆哥开发笔记(十三) (Xcode统计代码行数)
- iOS开发小技巧--高斯模糊框架的应用
- nagios云监控
- Xamarin.iOS - Handing Keyboard
- iOS陆哥开发笔记(十二) (tableViewCell侧滑显示多个按钮)
- iOS开发之MBProgressHUD的使用
- iOS 项目审核悲剧原因
- iOS陆哥开发笔记(十一) (容易造成循环引用的三种场景)
- iOS陆哥开发笔记(十) (iOS设计模式—单例模式)
- ios7之后的动画
- iOS开发小技巧--键盘处理以及解决block造成循环引用的小技巧