一、開發(fā)環(huán)境
xcode7+ios9
二、準(zhǔn)備工作
1.下載百度地圖SDK。直接點(diǎn):相關(guān)SDK下載 ，地址失效的話，百度搜索百度地圖api，進(jìn)入百度開發(fā)平臺(tái)，進(jìn)行下載。目前最新版本 iOS SDK 2.10.2。
百度官方SDK文檔：官方SDK文檔 。文檔很詳細(xì)了，不過有些說明是很多年前寫的了，不太適用，容易多走一些彎路，本文的出發(fā)點(diǎn)也是個(gè)人總結(jié)，也留個(gè)備份，免得以后有需要的時(shí)候，自己一些細(xì)節(jié)又忘了。
2.申請(qǐng)密鑰appKey.
百度開發(fā)平臺(tái),進(jìn)去點(diǎn)擊申請(qǐng)密鑰按鈕,接著點(diǎn)擊創(chuàng)建應(yīng)用。
注意：安全碼和你項(xiàng)目的info.plist的Bundle Identifier值保持一致。
三、配置開發(fā)環(huán)境
1.新建一個(gè)項(xiàng)目，配置info.plist
1.1修改項(xiàng)目的info.plist的Bundle Identifier值和你創(chuàng)建應(yīng)用的安全碼保持一致。
1.2由于iOS9改用更安全的https，為了能夠在iOS9中正常使用地圖SDK，請(qǐng)?jiān)?Info.plist"中進(jìn)行如下配置，否則影響SDK的使用。
<key>NSAppTransportSecurity</key>
<dict> <key>NSAllowsArbitraryLoads</key>
<true/>
</dict>
2.適配iOS8.0以上的定位，需要在info.plist里添加
<key>NSLocationAlwaysUsageDescription</key>
<true/>
<key>NSLocationWhenInUseUsageDescription</key>
<true/>
3.根據(jù)需要導(dǎo)入 .framework包
百度地圖 iOS SDK 采用分包的形式提供 .framework包，請(qǐng)廣大開發(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)庫(kù)中采用Objective-C++實(shí)現(xiàn)，因此需要您保證您工程中至少有一個(gè).mm后綴的源文件(您可以將任意一個(gè).m后綴的文件改名為.mm)，或者在工程屬性中指定編譯方式，即在Xcode的Project -> Edit Active Target -> Build Setting 中找到 Compile Sources As，并將其設(shè)置為"Objective-C++"
4.引入所需的系統(tǒng)庫(kù)
百度地圖全部api一共有7個(gè)，另外導(dǎo)入系統(tǒng)自帶的12個(gè)，共19個(gè)。
注：用Finder打開顯示你的工程，在工程目錄下新建一個(gè)文件夾BaiduMapAPI，
把你需要的包拷貝到這個(gè)目錄下，一共7個(gè)，我就全部拷貝，然后拖到這個(gè)文件夾到xcode工程中。然后在TARGETS->Build Settings->Headers search paths中添加路徑：$(SRCROOT)/BaiduMapAPI/
TARGETS->Build Phases-> Link Binary With Libaries中點(diǎn)擊“+”按鈕添加另外的12個(gè)，最后在xcode工程目錄下新建文件夾framework，把12個(gè)拖進(jìn)里面，讓項(xiàng)目整潔。
5.AppDelegate.h文件代碼
#import <BaiduMapAPI_Base/BMKBaseComponent.h>
@interface AppDelegate : UIResponder <UIApplicationDelegate>
{
UINavigationController *navigationController;
BMKMapManager* _mapManager;
}
6.AppDelegate.m文件代碼
#import <BaiduMapAPI_Map/BMKMapComponent.h>
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// 要使用百度地圖，請(qǐng)先啟動(dòng)BaiduMapManager。（XXX是你去百度開放平臺(tái)創(chuàng)建的應(yīng)用appKey）
_mapManager = [[BMKMapManager alloc]init];
BOOL ret = [_mapManager start:@"XXX" generalDelegate:self];
if (!ret) {
NSLog(@"manager start failed!");
}
[self.window addSubview:navigationController.view];
[self.window makeKeyAndVisible];
return YES;
}
//網(wǎng)絡(luò)檢查
- (void)onGetNetworkState:(int)iError
{
if (iError) {
NSLog(@"%d", iError);
} else {
NSLog(@"網(wǎng)絡(luò)連接成功");
}
}
- (void)onGetPermissionState:(int)iError
{
if (iError) {
NSLog(@"授權(quán)錯(cuò)誤%d", iError);
} else {
NSLog(@"授權(quán)狀態(tài)");
}
}
7.ViewController.mm文件
- (void)loadView
{
BMKMapView* mapView = [[BMKMapView alloc]initWithFrame:[UIScreen mainScreen].applicationFrame];
self.view = mapView;
self.mapView = mapView;
}
- (void)viewWillAppear:(BOOL)animated
{
[_mapView viewWillAppear];
_mapView.delegate = self; // 此處記得不用的時(shí)候需要置nil，否則影響內(nèi)存的釋放
}
- (void)viewWillDisappear:(BOOL)animated
{
[_mapView viewWillDisappear];
_mapView.delegate = nil; // 不用時(shí)，置nil
}
因?yàn)榘俣鹊貓D依賴的靜態(tài)庫(kù)中采用Objective-C++實(shí)現(xiàn)，所有
工程中至少有一個(gè).mm后綴的源文件(可以將任意一個(gè).m后綴的文件改名為.mm，最好不要選AppDelegate.m因?yàn)檎麄€(gè)項(xiàng)目都有用到它，我是改了ViewController.m文件后綴為.mm)
四、遇到的問題及注意事項(xiàng)
1.Undefined symbols for architecture x86_64錯(cuò)誤
單獨(dú)項(xiàng)目移除BaiduMapAPI_Map.framework，編譯成功，導(dǎo)入后編譯報(bào)錯(cuò)。
因?yàn)閄Code默認(rèn)使用的C++標(biāo)準(zhǔn)庫(kù)是蘋果自己的libc++(LLVM C++ standard library with c++11 support)，而百度地圖SDK中使用的C++標(biāo)準(zhǔn)庫(kù)是GNU C++的。
解決方法，在target的build settings中搜索“c++ standard library”，將其設(shè)置為“l(fā)ibstdc++(GNU C++ standard library)”
2.地圖所需資源文件不完整,請(qǐng)根據(jù)開發(fā)指南正確添加mapapi.bundle文件
以下引用官方文檔：
確認(rèn)項(xiàng)目中添加mapapi.bundle文件以及添加方法正確，不能刪除或隨意更改其中files文件夾下的內(nèi)容：注：mapapi.bundle中存儲(chǔ)了定位、默認(rèn)大頭針標(biāo)注View及路線關(guān)鍵點(diǎn)的資源圖片，還存儲(chǔ)了矢量地圖繪制必需的資源文件。如果您不需要使用內(nèi)置的圖片顯示功能，則可以刪除bundle文件中的image文件夾。您也可以根據(jù)具體需求任意替換或刪除該bundle中image文件夾的圖片文件。添加方式：將mapapi.bundle拷貝到您的工程目錄，直接將該bundle文件托拽至Xcode工程左側(cè)的Groups&Files中即可。若您需要替換定位、指南針的圖標(biāo)，請(qǐng)保留原文件名稱，否則不顯示替換的新圖片，默認(rèn)大頭針標(biāo)注與路線關(guān)鍵點(diǎn)的新圖片名稱可自定義名稱。
坑，自v2.9.0 起，采用分包的形式提供 .framework 包，一共7個(gè)包，目錄下都沒有mapapi.bundle文件，最后還是在Demo工程中拖過來的。
3.授權(quán)錯(cuò)誤200
app不存在，appkey錯(cuò)誤。
解決方案：確保info.plist中的Bundle display name的值和百度后臺(tái)創(chuàng)建的應(yīng)用名稱一致。Bundle identifier和創(chuàng)建應(yīng)用的安全碼一致。百度提供的appkey和項(xiàng)目AppDelegate代碼中的appkey保持一致。
五、工程截圖
