由於工作需要開始接觸百度地圖 SDK,一開始各種碰壁,最後總算把官方 Demo 跑了起來。這篇把整個環境建置的踩雷過程記錄下來,給新手一個可以少走冤枉路的參考。
本文的目標是幫助新手快速把 iOS 版百度地圖跑起來。官網雖然有教程,但版本偏舊(對應 Xcode 4.3 之前),照著做常常會遇到錯誤。以下流程依序執行,可以用最少的時間進入開發狀態。
環境:Mac OS X 10.8.2 / Xcode 4.6 / iPod Touch 4G(iOS 6.1.2)
【重要】使用百度地圖 SDK 必須先申請 key。申請時需有百度帳號,應用名稱可自訂,請到官網完成。
到官網下載最新的 iOS 靜態庫開發包,解壓後可看到 inc、libs、mapapi.bundle 等內容:
開啟 Xcode 建立新專案(或沿用既有專案),把 inc、libs、mapapi.bundle 三個資料夾拖入專案:
務必勾選 Copy items into destination group's folder、建立 groups,並確認已加入 target membership。少勾任何一項,後續都會找不到檔案。
幾乎所有第三方地圖 SDK 都依賴 Apple 自有的 framework,這裡需要加入 CoreLocation.framework 與 QuartzCore.framework:
此時如果在 .h 中引入 BMapKit.h 並嘗試實例化 BMKMapManager 或 BMapView,一定會看到錯誤:
提示找不到 libbaidumapapi.a。這不是路徑寫錯,而是系統無法連結到我們的地圖靜態庫,解法見 2.4。
選中專案 > target,切換到 Build Settings,找到 Other Linker Flags,加入:
-all_load
這個旗標的作用是強制載入靜態庫中的所有 Objective-C 類別與分類。若不加上,連結器會因為「沒有任何符號被直接引用」而略過靜態庫中的類別,執行期就會出現 class not found。
接著要讓專案找得到 .a 檔。切換到 Build Settings,找到 Library Search Paths:
刪除既有的三筆,改為一行即可(同時涵蓋模擬器與真機):
$(SRCROOT)/libs/Release$(EFFECTIVE_PLATFORM_NAME)
其中 $(SRCROOT) 代表專案檔所在目錄,$(EFFECTIVE_PLATFORM_NAME) 代表當前建置目標是 device 還是 simulator,兩者組起來就能自動指向正確的靜態庫子目錄。
靜態庫設定完成後剩下程式碼部分。由於需要 key 驗證,必須先透過 BMKMapManager 帶入申請到的 key 取得授權。在 AppDelegate.h 中:
#import "BMapKit.h"
@interface AppDelegate : UIResponder <UIApplicationDelegate> {
BMKMapManager* _mapManager; // 實例化
}
接著把 AppDelegate.m 改名為 AppDelegate.mm。這是因為靜態庫以 Objective-C++ 實作,專案中至少要有一個 .mm 副檔名的原始檔,否則執行時會大量報錯——這是最容易忽略的一步。
在 didFinishLaunchingWithOptions 中加入授權程式碼:
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// 使用百度地圖前,必須先啟動 BaiduMapManager
_mapManager = [[BMKMapManager alloc] init];
// 若需關注網路及授權驗證事件,可設定 generalDelegate
BOOL ret = [_mapManager start:@"你的API_KEY" generalDelegate:nil];
if (!ret) {
NSLog(@"manager start failed!");
}
self.window = [[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]];
self.viewController = [[[ZYViewController alloc] initWithNibName:@"ZYViewController"
bundle:nil] autorelease];
self.window.rootViewController = self.viewController;
[self.window makeKeyAndVisible];
return YES;
}
#import "ViewController.h"
#import "BMKMapView.h"
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
BMKMapView* mapView = [[BMKMapView alloc] initWithFrame:CGRectMake(0, 0, 320, 460)];
self.view = mapView;
}
引入 BMKMapView.h 後實例化 BMKMapView,並指定為 controller 的 view 即可。
在 AppDelegate 完成授權後,就能在任意 ViewController 中使用 mapView。(授權程式碼也可以寫在其他 ViewController 中,但這樣就只能在該類別使用地圖;換到別的類別時必須重新授權,否則地圖會顯示為黑屏。)
真機執行結果:
問題排查小結:若遇到錯誤,依序檢查 (.1) key 是否正確且與 bundle id 綁定、(2) 是否已加入 .mm 檔、(3) Other Linker Flags 是否設為 -all_load、(4) Library Search Paths 是否正確、(5) 兩個系統 framework 是否已加入。這五項涵蓋了九成以上的建置失敗原因。