步驟:
- 注冊百度地圖 成為百度開發(fā)者
2.我的應(yīng)用中創(chuàng)建應(yīng)用
- 設(shè)置應(yīng)用名稱
- 服務(wù)端選擇iOS SDK
安全碼等于項(xiàng)目的Bundle Identifier- 點(diǎn)擊創(chuàng)建應(yīng)用 獲取應(yīng)用的AppKey
3.開發(fā)者可在百度地圖iOS SDK的下載頁面下載到最新版的地圖SDK,下載地址
SDK下載地址
需要注意的配置
靜態(tài)庫中采用ObjectC++實(shí)現(xiàn),因此需要您保證您工程中至少有一個(gè).mm后綴的源文件(您可以將任意一個(gè).m后綴的文件改名為.mm),或者在工程屬性中指定編譯方式,即在Xcode的Project -> Edit Active Target -> Build Setting 中找到 Compile Sources As,并將其設(shè)置為"Objective-C++"如果您只在Xib文件中使用了BMKMapView,沒有在代碼中使用BMKMapView,編譯器在鏈接時(shí)不會鏈接對應(yīng)符號,需要在工程屬性中顯式設(shè)定:在Xcode的Project -> Edit Active Target -> Build Setting -> Other Linker Flags中添加-ObjC由于iOS9改用更安全的https,為了能夠在iOS9中正常使用地圖SDK,請?jiān)?Info.plist"中進(jìn)行如下配置,否則影響SDK的使用。
<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key>
<true/>
</dict>
如果在iOS9中使用了調(diào)起百度地圖客戶端功能,必須在"Info.plist"中進(jìn)行如下配置,否則不能調(diào)起百度地圖客戶端
NSLocationWhenInUseUsageDescription ,允許在前臺使用時(shí)獲取GPS的描述
NSLocationAlwaysUsageDescription ,允許永久使用GPS的描述
在使用Xcode6進(jìn)行SDK開發(fā)過程中,需要在info.plist中添加:Bundle display name ,且其值不能為空(Xcode6新建的項(xiàng)目沒有此配置,若沒有會造成manager start failed)管理地圖的生命周期:自2.0.0起,BMKMapView新增viewWillAppear、viewWillDisappear方法來控制BMKMapView的生命周期,并且在一個(gè)時(shí)刻只能有一個(gè)BMKMapView接受回調(diào)消息,因此在使用BMKMapView的viewController中需要在viewWillAppear、viewWillDisappear方法中調(diào)用BMKMapView的對應(yīng)的方法,并處理delegate,代碼如下
(void)viewWillAppear:(BOOL)animated
{
[_mapView viewWillAppear];
_mapView.delegate = self; // 此處記得不用的時(shí)候需要置nil,否則影響內(nèi)存的釋放
}
-(void)viewWillDisappear:(BOOL)animated
{
[_mapView viewWillDisappear];
_mapView.delegate = nil; // 不用時(shí),置nil
}
配置開發(fā)環(huán)境
- 百度地圖iOS SDK自v2.7.0版本起,向廣大開發(fā)者提供了 .framework形式的SDK開發(fā)包,這種形式的開發(fā)包配置簡單
方式一
- 自動配置.framework形式開發(fā)包(使用CocoaPods)
- 此種方式只支持導(dǎo)入全量包的SDK,包含百度地圖iOS SDK所有功能
- 在當(dāng)前工程文件(.xcodeproj)所在文件夾下,打開termina
touch Podfile
2.編輯Podfile內(nèi)容如
pod 'BaiduMapKit' #百度地圖SDK
3.在Podfile所在的文件夾下輸入命令:
pod install (這個(gè)可能比較慢,請耐心等待……)
成功以后,會出現(xiàn)如下記錄:
Analyzing dependencies
Downloading dependencies
Installing BaiduMapKit (2.9.1)
Generating Pods project
Integrating client project
[!] Please close any current Xcode sessions and use `***.xcworkspace` for this project from now on.
Sending stats
恭喜你已成功導(dǎo)入百度地圖iOS SDK,現(xiàn)在就可以打開xcworkspace文件,在你的項(xiàng)目中使用百度地圖SDK了
手動配置.framework形式開發(fā)包
第一步 根據(jù)需要導(dǎo)入 .framework包
- 百度地圖 iOS SDK 采用分包的形式提供 .framework包,請廣大開發(fā)者使用時(shí)確保各分包的版本保持一致。其中BaiduMapAPI_Base.framework為基礎(chǔ)包,使用SDK任何功能都需導(dǎo)入,其他分包可按需導(dǎo)入。
將所需的BaiduMapAPI_**.framework拷貝到工程所在文件夾下。
第二步 在 TARGETS->Build Phases-> Link Binary With Libaries中點(diǎn)擊“+”按鈕,在彈出的窗口中點(diǎn)擊“Add Other”按鈕,選擇BaiduMapAPI_**.framework添加到工程中
注意:注: 靜態(tài)庫中采用Objective-C++實(shí)現(xiàn),因此需要您保證您工程中至少有一個(gè).mm后綴的源文件(您可以將任意一個(gè).m后綴的文件改名為.mm),或者在工程屬性中指定編譯方式,即在Xcode的Project -> Edit Active Target -> Build Setting 中找到 Compile Sources As,并將其設(shè)置為"Objective-C++"
第三步、引入所需的系統(tǒng)庫
-
百度地圖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)。 (注:紅色標(biāo)識的系統(tǒng)庫為v2.9.0新增的系統(tǒng)庫,使用v2.9.0及以上版本的地圖SDK,務(wù)必增加導(dǎo)入這3個(gè)系統(tǒng)庫。) 添加方式:在Xcode的Project -> Active Target ->Build Phases ->Link Binary With Libraries,添加這幾個(gè)系統(tǒng)庫即可。
第四步、環(huán)境配置
- 在TARGETS->Build Settings->Other Linker Flags 中添加-ObjC。
第五步、引入mapapi.bundle資源文件
- 如果使用了基礎(chǔ)地圖功能,需要添加該資源,否則地圖不能正常顯示mapapi.bundle中存儲了定位、默認(rèn)大頭針標(biāo)注View及路線關(guān)鍵點(diǎn)的資源圖片,還存儲了矢量地圖繪制必需的資源文件。如果您不需要使用內(nèi)置的圖片顯示功能,則可以刪除bundle文件中的image文件夾。您也可以根據(jù)具體需求任意替換或刪除該bundle中image文件夾的圖片文件。
方法:選中工程名,在右鍵菜單中選擇Add Files to “工程名”…,從BaiduMapAPI_Map.framework||Resources文件中選擇mapapi.bundle文件,并勾選“Copy items if needed”復(fù)選框,單擊“Add”按鈕,將資源文件添加到工程中。
第五步、引入頭文件
#import <BaiduMapAPI_Base/BMKBaseComponent.h>//引入base相關(guān)所有的頭文件
#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>//引入計(jì)算工具所有的頭文件
#import <BaiduMapAPI_Radar/BMKRadarComponent.h>//引入周邊雷達(dá)功能所有的頭文件
#import <BaiduMapAPI_Map/BMKMapView.h>//只引入所需的單個(gè)頭文件
開始集成
初始化BMKMapManager
- 在您的AppDelegate.h文件中添加BMKMapManager的定義
@interface AppDelegate ()
@property (nonatomic, strong) BMKMapManager *mapManager;
@end
@implementation AppDelegate
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
//
self.mapManager = [[BMKMapManager alloc] init];
BOOL ret = [self.mapManager start:APPKEY generalDelegate:nil];
if (!ret) {
NSLog(@"manager start failed!");
} else {
NSLog(@"初始化成功??!");
}
return YES;
}
注意:如果有問題,作如下檢查
- 看有沒有核對 Bundle Identifier是否一致
- 是否項(xiàng)目中添加靜態(tài)庫BaiduMapAPI_Map.framework中的Resources
- 如果還有問題 設(shè)置一下Bundle display name
- 位置定位描述
地圖常見使用的類
地圖展示 BMKMapView
POI檢索 BMKPoiSearch
定位 BMKLocationService
地理編碼 BMKGeoCodeSearch
- 詳細(xì)集成參考集成文檔