一、開發(fā)環(huán)境
xcode7+ios9
二叔锐、準(zhǔn)備工作
1.下載百度地圖SDK见秽。直接點(diǎn):相關(guān)SDK下載 解取,地址失效的話,百度搜索百度地圖api蔓肯,進(jìn)入百度開發(fā)平臺振乏,進(jìn)行下載。目前最新版本 iOS SDK 2.10.2调限。
百度官方SDK文檔:官方SDK文檔 。文檔很詳細(xì)了秦躯,不過有些說明是很多年前寫的了裆装,不太適用,容易多走一些彎路茎活,本文的出發(fā)點(diǎn)也是個人總結(jié)妙色,也留個備份慧耍,免得以后有需要的時候,自己一些細(xì)節(jié)又忘了煌珊。
2.申請密鑰appKey.
百度開發(fā)平臺,進(jìn)去點(diǎn)擊申請密鑰按鈕,接著點(diǎn)擊創(chuàng)建應(yīng)用定庵。
注意:安全碼和你項目的info.plist的Bundle Identifier值保持一致蔬浙。
三、配置開發(fā)環(huán)境
1.新建一個項目畴博,配置info.plist
1.1修改項目的info.plist的Bundle Identifier值和你創(chuàng)建應(yīng)用的安全碼保持一致俱病。
1.2由于iOS9改用更安全的https亮隙,為了能夠在iOS9中正常使用地圖SDK,請在"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包,請廣大開發(fā)者使用時確保各分包的版本保持一致题翰。其中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++實現(xiàn)况毅,因此需要您保證您工程中至少有一個.mm后綴的源文件(您可以將任意一個.m后綴的文件改名為.mm),或者在工程屬性中指定編譯方式么鹤,即在Xcode的Project -> Edit Active Target -> Build Setting 中找到 Compile Sources As母债,并將其設(shè)置為"Objective-C++"
4.引入所需的系統(tǒng)庫
百度地圖全部api一共有7個,另外導(dǎo)入系統(tǒng)自帶的12個迅皇,共19個登颓。
注:用Finder打開顯示你的工程框咙,在工程目錄下新建一個文件夾BaiduMapAPI,
把你需要的包拷貝到這個目錄下喇嘱,一共7個者铜,我就全部拷貝作烟,然后拖到這個文件夾到xcode工程中。然后在TARGETS->Build Settings->Headers search paths中添加路徑:$(SRCROOT)/BaiduMapAPI/
TARGETS->Build Phases-> Link Binary With Libaries中點(diǎn)擊“+”按鈕添加另外的12個衣厘,最后在xcode工程目錄下新建文件夾framework影暴,把12個拖進(jìn)里面涎显,讓項目整潔。
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 {
// 要使用百度地圖早歇,請先啟動BaiduMapManager箭跳。(XXX是你去百度開放平臺創(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)錯誤%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; // 此處記得不用的時候需要置nil,否則影響內(nèi)存的釋放
}
- (void)viewWillDisappear:(BOOL)animated
{
[_mapView viewWillDisappear];
_mapView.delegate = nil; // 不用時刨晴,置nil
}
因為百度地圖依賴的靜態(tài)庫中采用Objective-C++實現(xiàn)狈癞,所有
工程中至少有一個.mm后綴的源文件(可以將任意一個.m后綴的文件改名為.mm,最好不要選AppDelegate.m因為整個項目都有用到它慨绳,我是改了ViewController.m文件后綴為.mm)
四脐雪、遇到的問題及注意事項
1.Undefined symbols for architecture x86_64錯誤
單獨(dú)項目移除BaiduMapAPI_Map.framework,編譯成功战秋,導(dǎo)入后編譯報錯获询。
因為XCode默認(rèn)使用的C++標(biāo)準(zhǔn)庫是蘋果自己的libc++(LLVM C++ standard library with c++11 support)吉嚣,而百度地圖SDK中使用的C++標(biāo)準(zhǔn)庫是GNU C++的蹬铺。
解決方法甜攀,在target的build settings中搜索“c++ standard library”规阀,將其設(shè)置為“l(fā)ibstdc++(GNU C++ standard library)”
2.地圖所需資源文件不完整,請根據(jù)開發(fā)指南正確添加mapapi.bundle文件
以下引用官方文檔:
確認(rèn)項目中添加mapapi.bundle文件以及添加方法正確,不能刪除或隨意更改其中files文件夾下的內(nèi)容:注:mapapi.bundle中存儲了定位歧胁、默認(rèn)大頭針標(biāo)注View及路線關(guān)鍵點(diǎn)的資源圖片喊巍,還存儲了矢量地圖繪制必需的資源文件崭参。如果您不需要使用內(nèi)置的圖片顯示功能,則可以刪除bundle文件中的image文件夾铐殃。您也可以根據(jù)具體需求任意替換或刪除該bundle中image文件夾的圖片文件。添加方式:將mapapi.bundle拷貝到您的工程目錄贰军,直接將該bundle文件托拽至Xcode工程左側(cè)的Groups&Files中即可俯树。若您需要替換定位许饿、指南針的圖標(biāo),請保留原文件名稱瓦糟,否則不顯示替換的新圖片劲蜻,默認(rèn)大頭針標(biāo)注與路線關(guān)鍵點(diǎn)的新圖片名稱可自定義名稱。
坑考余,自v2.9.0 起先嬉,采用分包的形式提供 .framework 包,一共7個包楚堤,目錄下都沒有mapapi.bundle文件疫蔓,最后還是在Demo工程中拖過來的。
3.授權(quán)錯誤200
app不存在钾军,appkey錯誤鳄袍。
解決方案:確保info.plist中的Bundle display name的值和百度后臺創(chuàng)建的應(yīng)用名稱一致。Bundle identifier和創(chuàng)建應(yīng)用的安全碼一致吏恭。百度提供的appkey和項目AppDelegate代碼中的appkey保持一致哀九。