iOS 百度地图SDK-配置开发环境

虽然百度地图已经用了很多次了,但是每次都浪费很长时间来配置,所以今天把配置百度地图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 use BaiDuPoiSearch.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.frameworkQuartzCore.frameworkOpenGLES.frameworkSystemConfiguration.frameworkCoreGraphics.frameworkSecurity.frameworklibsqlite3.0.tbdCoreTelephony.frameworklibstdc++.6.0.9.tbd

添加方法:在Xcode的Project -> Active Target ->Build Phases ->Link Binary With Libraries,添加这几个系统库即可

第三步、引入所需的第三方openssl库

添加支持HTTPS所需的penssl静态库:libssl.alibcrypto.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文件夹。您也可以根据具体需求任意替换或删除该bundleimage文件夹的图片文件。

添加方法:选中工程名,在右键菜单中选择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-配置开发环境,只是对百度地图的配置进行了一下总结,仅供开发百度地图参考使用,如有侵权行为,请联系我并及时删除。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,590评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 86,808评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,151评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,779评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,773评论 5 367
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,656评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,022评论 3 398
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,678评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 41,038评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,659评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,756评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,411评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,005评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,973评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,203评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,053评论 2 350
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,495评论 2 343

推荐阅读更多精彩内容