虽然百度地图已经用了很多次了,但是每次都浪费很长时间来配置,所以今天把配置百度地图SDK的过程记录下来,也方便日后查看。
第一步、导入百度SDK
百度地图SDK支持手动和使用CocoaPods
自动配置
自动配置.framework形式开发包(使用CocoaPods)
1、进入工程所在根目录执行:
pod init // 初始化后,会自动创建`Podfile`文件
2、搜索百度地图SDK在CocoaPods的版本号:
pod search BaiduMapKit
3、编辑Podfile内容如下:
pod 'BaiduMapKit', '3.3.0' // 3.3.0是当前最新的版本号
4.在Podfile所在的文件夹下输入命令:
pod install
成功以后,会出现如下记录:
Analyzing dependencies
Downloading dependencies
Installing BaiduMapKit (3.3.0)
Generating Pods project
Integrating client project
[!] Please close any current Xcode sessions and useBaiDuPoiSearch.xcworkspace
for this project from now on
手动配置.framework形式开发包
1、根据需要导入 .framework包,将所需要的BaiduMapAPI_**.framework
拷贝到工程所在文件夹下,BaiduMapAPI_Base.framework为基础包,使用SDK任何功能都需导入,其他分包可按需导入
2、在TARGETS
->Build Phases
->Link Binary With Libaries
中点击“+”按钮,在弹出的窗口中点击Add Other
按钮,选择BaiduMapAPI_**.framework
添加到工程中
注意: 静态库中采用Objective-C++实现,因此需要您保证您工程中至少有一个.mm后缀的源文件(您可以将任意一个.m后缀的文件改名为.mm),或者在工程属性中指定编译方式,即在Xcode的
Project
->Edit Active Target
->Build Setting
中找到Compile Sources As
,并将其设置为Objective-C++
第二步、引入所需的系统依赖库
百度地图SDK中提供了定位功能和动画效果,v2.0.0版本开始使用OpenGL渲染因此您需要在您的Xcode工程中引入:
CoreLocation.framework
、QuartzCore.framework
、OpenGLES.framework
、SystemConfiguration.framework
、CoreGraphics.framework
、Security.framework
、libsqlite3.0.tbd
、CoreTelephony.framework
、libstdc++.6.0.9.tbd
添加方法:在Xcode的Project
-> Active Target
->Build Phases
->Link Binary With Libraries
,添加这几个系统库即可
第三步、引入所需的第三方openssl库
添加支持HTTPS所需的penssl静态库:libssl.a
和libcrypto.a
(SDK打好的包存放于thirdlib目录下
添加方法: 在 TARGETS
->Build Phases
->Link Binary With Libaries
中点击“+”按钮,在弹出的窗口中点击Add Other
按钮,选择libssl.a和libcrypto.a添加到工程中
第四步、环境配置
在TARGETS
->Build Settings
->Other Linker Flags
中添加-ObjC
。
第五步、引入mapapi.bundle资源文件
如果使用了基础地图功能,需要添加该资源,否则地图不能正常显示mapapi.bundle
中存储了定位、默认大头针标注View及路线关键点的资源图片,还存储了矢量地图绘制必需的资源文件。如果您不需要使用内置的图片显示功能,则可以删除bundle
文件中的image
文件夹。您也可以根据具体需求任意替换或删除该bundle
中image
文件夹的图片文件。
添加方法:选中工程名,在右键菜单中选择Add Files to …
,从BaiduMapAPI_Map.framework
||Resources
文件中选择mapapi.bundle
文件,并勾选Copy items if needed
复选框,单击Add
按钮,将资源文件添加到工程中。
第六步、引入头文件
在使用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>//只引入所需的单个头文件
第七步、调用客户端
如果在iOS9中使用了调起百度地图客户端功能,必须在Info.plist
中进行如下配置,否则不能调起百度地图客户端。
<key>LSApplicationQueriesSchemes</key>
<array>
<string>baidumap</string>
</array>
第八步、开启定位提醒
自iOS SDK v2.5.0起,为了对iOS8的定位能力做兼容,做了相应的修改,开发者在使用过程中注意事项如下:
需要在info.plist里添加(以下二选一,两个都添加默认使用NSLocationWhenInUseUsageDescription
):
NSLocationWhenInUseUsageDescription
// 允许在前台使用时获取GPS的描述NSLocationAlwaysUsageDescription
// 允许永久使用GPS的描述
第九步、验证key和应用名称是否相符
在使用Xcode6进行SDK开发过程中,需要在info.plist中添加:Bundle display name
,且其值不能为空(Xcode6新建的项目没有此配置,若没有会造成manager start failed)
第十步、APPDelegate配置
.h文件
#import <BaiduMapAPI_Base/BMKBaseComponent.h>
@interface AppDelegate : UIResponder <UIApplicationDelegate,BMKGeneralDelegate>
@property (nonatomic,strong) BMKMapManager* mapManager;
.m文件
-(void)setUpBaiMap {
//百度地图
if ([[UIDevice currentDevice].systemVersion floatValue] >= 8) {
//由于IOS8中定位的授权机制改变 需要进行手动授权
CLLocationManager *locationManager = [[CLLocationManager alloc] init];
//获取授权认证
[locationManager requestAlwaysAuthorization];
[locationManager requestWhenInUseAuthorization];
[locationManager startUpdatingLocation];
}
_mapManager = [[BMKMapManager alloc]init];
// 如果要关注网络及授权验证事件,请设定 generalDelegate参数
BOOL ret = [_mapManager start:BaiDu_MapKey generalDelegate:self];
if (!ret) {
DLog(@"manager start failed!");
}
}
#pragma mark - 百度地图
- (void)onGetNetworkState:(int)iError {
if (0 == iError) {
NSLog(@"联网成功");
} else{
NSLog(@"onGetNetworkState %d",iError);
}
}
- (void)onGetPermissionState:(int)iError {
if (0 == iError) {
NSLog(@"授权成功");
self.isMapPermission = YES;
} else {
NSLog(@"onGetPermissionState %d",iError);
}
}
第十一步、管理地图的生命周期
自2.0.0起,BMKMapView新增viewWillAppear、viewWillDisappear方法来控制BMKMapView的生命周期,并且在一个时刻只能有一个`BMKMapView接受回调消息,因此在使用BMKMapView的viewController中需要在viewWillAppear、viewWillDisappear方法中调用BMKMapView的对应的方法,并处理delegate,代码如下:
-(void)viewWillAppear:(BOOL)animated
{
[_mapView viewWillAppear];
_mapView.delegate = self; // 此处记得不用的时候需要置nil,否则影响内存的释放
}
-(void)viewWillDisappear:(BOOL)animated
{
[_mapView viewWillDisappear];
_mapView.delegate = nil; // 不用时,置nil
}
总结
本文借鉴百度地图SDK-配置开发环境,只是对百度地图的配置进行了一下总结,仅供开发百度地图参考使用,如有侵权行为,请联系我并及时删除。