1 前言
由於工作需要,要開始搗騰百度地圖了,今天上午初始牛刀,各種碰壁,無奈之下,中午睡了一覺,養精蓄銳,以備下午大戰三百回合,所幸下午中午把百度地圖Demo搗騰出來了,在此與大家分享,環境搭建教程,菜鳥專用,大神勿噴!
本文旨在幫助新手快速搭建ios版百度地圖,官網有相關教程,可是太舊了,現在的xcode都更新到了4.6,他的教程應該是在4.3之前吧。估計新手在搭建的時候一定會遇到錯誤,按照我的教程一步一步,保證你花最少的時間,快速進行地圖開發。
機器環境:mac os x 10.8.2
開發環境:xcode4.6
真機環境:iPod Touch4G 版本:6.1.2
【注】:使用百度地圖的SDK需要申請key,應用名稱可隨意寫,前提是有百度賬號,詳情官網查看。
2 詳述
2.1 官網下載最新的SDK開發包_iOS靜態庫文件 http://developer.baidu.com/map/sdkiosdev-download.htm
解壓後如下圖所示:
2.2 打開xcode,新建一個demo工程(或是在你現有的工程下),創建好後把下載的的inc,libs,mapapi.bundle三個文件夾導入到工程內,注意需要copy+destination,看我如下截圖:
一定要勾選copy和create group 同時要添加到target。
2.3 幾乎所有的第三方地圖sdk都是依賴於apple自有的幾個framework,所以這一步需要我們導入:CoreLocation.framework和QuartzCore.framework。導入方法如下:
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
此時如果.h導入BMapKit.h頭文件,實例化BMKMapManager或是BMapView,一定會有如下的錯誤:
貌似提示:libbaidumapapi.a找不到,那麼是路徑的問題麼?這就是大家常遇到的BMKMapManager錯誤。其實原理是系統無法鏈接到我們的地圖靜態庫,解決辦法如下文:
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
2.4 上邊是個小嘗試和插曲,我們繼續下一步,選中工程,target,切換到Build Setting標簽,定位到other link flag,
輸入:-all_load
2.5 現在需要設置一下鏈接庫的環境變量,好讓項目能順利找到目錄下的.a文件,選中工程,target,切換到build setting標簽,定位到Library search Path ,如下圖所示:
刪除已有的三個,添加一個足矣(模擬器+真機):$(SRCROOT)/libs/Release$(EFFECTIVE_PLATFORM_NAME)
簡單解釋一下:
$(SRCROOT)宏代表您的工程文件目錄,$(EFFECTIVE_PLATFORM_NAME)宏代表當前配置是OS還是simulator,這個涉及環境變量的相關知識,我也不太懂,全是自己嘗試出來的,大家直接copy我這行就行了。如下:
2.6 這個時候,靜態庫文件已經設置完畢,剩下的就只有代碼工作了,由於需要key的驗證,所以我們先需要使用BMKMapManager類,配置申請到的key,以得到授權。選中AppDelegate.h
[plain] #import "BMapKit.h" //導入BMapKit.h
@interface AppDelegate : UIResponder <UIApplicationDelegate>{
BMKMapManager* _mapManager; //實例化
}
#import "BMapKit.h" //導入BMapKit.h
@interface AppDelegate : UIResponder <UIApplicationDelegate>{
BMKMapManager* _mapManager; //實例化
}選中AppDelegate.m,修改成.mm,(注:靜態庫中采用ObjectC++實現,因此需要您保證您工程中至少有一個.mm後綴的源文件(您可以將任意一個.m後綴的文件改名為.mm))
【注意:如果沒有mm,運行會大量報錯的】
在AppDelegate.mm中的didFinishLaunchingWithOptions,加入如下代碼:
[plain] - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
// 要使用百度地圖,請先啟動BaiduMapManager
_mapManager = [[BMKMapManager alloc]init];
// 如果要關注網絡及授權驗證事件,請設定generalDelegate參數
BOOL ret = [_mapManager start:@"3830003D1DAFE904D7226E48F2F488262D5B23D2" generalDelegate:nil];
if (!ret) {
NSLog(@"manager start failed!");
}
self.window = [[[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]] autorelease];
// Override point for customization after application launch.
self.viewController = [[[ZYViewController alloc] initWithNibName:@"ZYViewController" bundle:nil] autorelease];
self.window.rootViewController = self.viewController;
[self.window makeKeyAndVisible];
return YES;
}
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
// 要使用百度地圖,請先啟動BaiduMapManager
_mapManager = [[BMKMapManager alloc]init];
// 如果要關注網絡及授權驗證事件,請設定generalDelegate參數
BOOL ret = [_mapManager start:@"3830003D1DAFE904D7226E48F2F488262D5B23D2" generalDelegate:nil];
if (!ret) {
NSLog(@"manager start failed!");
}
self.window = [[[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]] autorelease];
// Override point for customization after application launch.
self.viewController = [[[ZYViewController alloc] initWithNibName:@"ZYViewController" bundle:nil] autorelease];
self.window.rootViewController = self.viewController;
[self.window makeKeyAndVisible];
return YES;
}
2.7 在需要顯示地圖的viewcontroller.m中加入如下代碼:
[plain] #import "ViewController.h"
#import "BMKMapView.h"
@interface ViewController ()
@end
@implementation ViewController
- (void)viewDidLoad
{
[super viewDidLoad];
BMKMapView* mapView = [[BMKMapView alloc]initWithFrame:CGRectMake(0, 0, 320, 460)];
self.view = mapView;
}
#import "ViewController.h"
#import "BMKMapView.h"
@interface ViewController ()
@end
@implementation ViewController
- (void)viewDidLoad
{
[super viewDidLoad];
BMKMapView* mapView = [[BMKMapView alloc]initWithFrame:CGRectMake(0, 0, 320, 460)];
self.view = mapView;
}
導入BMKMapView.h後,實例化BMKMapView類。
2.8 在AppDelegate中授權過後,可以隨意在任意的Viewcontroller中使用Mapview了。
(當然,BMKMapManager授權也可以寫到任意的ViewController中,但是這樣的話,只能在這個ViewController中使用MapView,換其它類使用地圖的話,還需再來授權,否則地圖view會是黑屏):
真機截圖: