您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 訊息 >> iOS 相關資訊

在 iOS 工程中集成百度地圖 SDK 的完整步驟

編輯:iOS 相關資訊

百度地圖 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 同時包含兩種架構,真機和模擬器都能直接調試,一勞永逸。

方式三:配置鏈接路徑

  1. 把 SDK 的 libs 文件夾拷貝到工程根目錄下。
  2. 在 Project → Build Settings → Linking → Other Linker Flags 中添加 -ObjC。這一步不可省略,否則運行時會因為 Objective-C 類別(category)未被加載而崩潰。
  3. 在 Search Path → Library Search Paths 中添加靜態庫目錄,例如 "$(SRCROOT)/../libs/Release$(EFFECTIVE_PLATFORM_NAME)"。其中 $(SRCROOT) 代表工程文件所在目錄,$(EFFECTIVE_PLATFORM_NAME) 會自動展開為當前配置的設備或模擬器。

個人實測方式二最省心。

二、確保工程中存在 .mm 文件

百度地圖的靜態庫以 Objective-C++ 實現,因此工程中至少要有一個 .mm 源文件。最簡單的做法是把 AppDelegate.m 重命名為 AppDelegate.mm。

三、添加依賴框架

需要引入以下系統框架:

  • CoreLocation.framework

  • QuartzCore.framework

  • OpenGLES.framework

  • SystemConfiguration.framework

四、在 AppDelegate 中初始化

使用前需要先到百度地圖開放平台申請一個應用 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 匹配,以及是否缺少必要框架。

  • 真機正常模擬器報錯(或反之):說明庫沒有合併,回到方式二處理。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved