百度地圖 SDK 的集成步驟比較瑣碎,尤其是靜態庫的真機與模擬器問題,第一次做很容易卡住。下面把整個流程梳理一遍。
把下載包中的 inc 文件夾、mapapi.bundle 和 libbaidumapapi.a 加入工程。注意 .a 有兩份,分別對應真機與模擬器,處理方式有三種:
方式一:直接拖拽
把對應平台的 .a 拖進 Xcode 左側的 Groups & Files。缺點很明顯:每次在真機與模擬器之間切換編譯,都得重新換一次庫文件。
方式二:用 lipo 合併成通用庫(推薦)
lipo -create Release-iphoneos/libbaidumapapi.a \
Release-iphonesimulator/libbaidumapapi.a \
-output libbaidumapapi.a
合併後的 fat binary 同時包含兩種架構,真機和模擬器都能直接調試,一勞永逸。
方式三:配置鏈接路徑
libs 文件夾拷貝到工程根目錄下。-ObjC。這一步不可省略,否則運行時會因為 Objective-C 類別(category)未被加載而崩潰。"$(SRCROOT)/../libs/Release$(EFFECTIVE_PLATFORM_NAME)"。其中 $(SRCROOT) 代表工程文件所在目錄,$(EFFECTIVE_PLATFORM_NAME) 會自動展開為當前配置的設備或模擬器。個人實測方式二最省心。
百度地圖的靜態庫以 Objective-C++ 實現,因此工程中至少要有一個 .mm 源文件。最簡單的做法是把 AppDelegate.m 重命名為 AppDelegate.mm。
需要引入以下系統框架:
CoreLocation.framework
QuartzCore.framework
OpenGLES.framework
SystemConfiguration.framework
使用前需要先到百度地圖開放平台申請一個應用 Key。頭文件:
#import <UIKit/UIKit.h>
#import "TestViewController.h"
#import "BMapKit.h"
#define BaiduMapKey @"你的API Key"
@interface AppDelegate : UIResponder <UIApplicationDelegate> {
BMKMapManager *_mapManager;
}
@property (strong, nonatomic) UIWindow *window;
@end
實現文件:
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
_mapManager = [[BMKMapManager alloc] init];
BOOL ret = [_mapManager start:BaiduMapKey generalDelegate:nil];
if (!ret) {
NSLog(@"BMKMapManager start failed!");
}
self.window = [[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]];
self.window.backgroundColor = [UIColor whiteColor];
TestViewController *root = [[TestViewController alloc] init];
self.window.rootViewController = root;
[self.window makeKeyAndVisible];
return YES;
}
核心就是 start:generalDelegate: 這一語句,它會用你申請的 Key 完成鑑權。返回值為 NO 通常意味著 Key 配置有誤,此時地圖無法正常顯示,記得留意控制台輸出。
編譯通過但運行崩潰、報 unrecognized selector:多半是漏了 -ObjC。
地圖空白:檢查 Key 是否與當前 bundle identifier 匹配,以及是否缺少必要框架。
真機正常模擬器報錯(或反之):說明庫沒有合併,回到方式二處理。