您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS 開發(95)之 百度地圖 API 環境搭建完整教學

編輯:iOS 開發綜合

由於工作需要開始接觸百度地圖 SDK,一開始各種碰壁,最後總算把官方 Demo 跑了起來。這篇把整個環境建置的踩雷過程記錄下來,給新手一個可以少走冤枉路的參考。

本文的目標是幫助新手快速把 iOS 版百度地圖跑起來。官網雖然有教程,但版本偏舊(對應 Xcode 4.3 之前),照著做常常會遇到錯誤。以下流程依序執行,可以用最少的時間進入開發狀態。

環境:Mac OS X 10.8.2 / Xcode 4.6 / iPod Touch 4G(iOS 6.1.2)

【重要】使用百度地圖 SDK 必須先申請 key。申請時需有百度帳號,應用名稱可自訂,請到官網完成。

2 詳細步驟

2.1 下載 SDK

到官網下載最新的 iOS 靜態庫開發包,解壓後可看到 inc、libs、mapapi.bundle 等內容:

2.2 匯入檔案到專案

開啟 Xcode 建立新專案(或沿用既有專案),把 inc、libs、mapapi.bundle 三個資料夾拖入專案:

務必勾選 Copy items into destination group's folder、建立 groups,並確認已加入 target membership。少勾任何一項,後續都會找不到檔案。

2.3 加入相依的系統 Framework

幾乎所有第三方地圖 SDK 都依賴 Apple 自有的 framework,這裡需要加入 CoreLocation.framework 與 QuartzCore.framework:

此時如果在 .h 中引入 BMapKit.h 並嘗試實例化 BMKMapManager 或 BMapView,一定會看到錯誤:

提示找不到 libbaidumapapi.a。這不是路徑寫錯,而是系統無法連結到我們的地圖靜態庫,解法見 2.4。

2.4 設定 Other Linker Flags

選中專案 > target,切換到 Build Settings,找到 Other Linker Flags,加入:

-all_load

這個旗標的作用是強制載入靜態庫中的所有 Objective-C 類別與分類。若不加上,連結器會因為「沒有任何符號被直接引用」而略過靜態庫中的類別,執行期就會出現 class not found。

2.5 設定 Library Search Paths

接著要讓專案找得到 .a 檔。切換到 Build Settings,找到 Library Search Paths:

刪除既有的三筆,改為一行即可(同時涵蓋模擬器與真機):

$(SRCROOT)/libs/Release$(EFFECTIVE_PLATFORM_NAME)

其中 $(SRCROOT) 代表專案檔所在目錄,$(EFFECTIVE_PLATFORM_NAME) 代表當前建置目標是 device 還是 simulator,兩者組起來就能自動指向正確的靜態庫子目錄。

2.6 授權:啟動 BMKMapManager

靜態庫設定完成後剩下程式碼部分。由於需要 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;
}

2.7 在 ViewController 中顯示地圖

#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 即可。

2.8 後續使用

在 AppDelegate 完成授權後,就能在任意 ViewController 中使用 mapView。(授權程式碼也可以寫在其他 ViewController 中,但這樣就只能在該類別使用地圖;換到別的類別時必須重新授權,否則地圖會顯示為黑屏。)

真機執行結果:

問題排查小結:若遇到錯誤,依序檢查 (.1) key 是否正確且與 bundle id 綁定、(2) 是否已加入 .mm 檔、(3) Other Linker Flags 是否設為 -all_load、(4) Library Search Paths 是否正確、(5) 兩個系統 framework 是否已加入。這五項涵蓋了九成以上的建置失敗原因。

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