入门指南 最后更新时间: 2021年01月22日
第 1 步：获取最新版本的 Xcode
要想使用 高德 AMap SDK for iOS 开发项目，您需要 8.0 版或更高版本的 Xcode。（注：下载地址为Apple官方网站）
第 2 步：获取 CocoaPods
高德 iOS SDK 以 CocoaPods pod 形式提供。 CocoaPods 是一种用于 Swift 和 Objective-C Cocoa 项目的开源依赖项管理器。
如果您尚未安装 CocoaPods 工具，请在 OS X 上从终端运行以下命令进行安装。 如需了解详情，请参阅 CocoaPods 入门指南。
$ sudo gem install cocoapods
第 3 步：使用 CocoaPods 安装 SDK
为 高德 iOS 地图 SDK 创建一个 Podfile，并使用它来安装 SDK。
1、创建Podfile文件
在您当前工程文件（.xcodeproj）所在文件夹下创建一个名为 Podfile 的文件。如果您尚未创建 Xcode 项目，请立即创建一个并将其保存到您的本地计算机。 （如果您第一次接触 iOS 开发，请创建一个Single View Application。）
$ touch Podfile
2、编辑 Podfile 文件
Podfile文件内容如下：
platform :ios, '7.0' #手机的系统
target 'YourProjectTarget' do
pod 'AMap3DMap' #3D地图SDK
#pod 'AMap2DMap' #2D地图SDK (2D和3D不能同时使用)
pod 'AMapSearch' #搜索功能
end
注意：使用任何SDK都会自动引入基础 SDK ，涉及到提交AppStore成功与否，请点我查看基础 SDK 的介绍。
3、运行 pod install 命令安装SDK
$pod install --repo-update
1.1.0版本的pod，运行pod install 不会自动更新repo，如果下载的不是最新版，可使用pod install —repo-update 更新 或 先运行 pod repo update.
4、更新 SDK
如果您安装的SDK不是最新版，请执行下面的代码进行更新。
pod repo update
5、重启 Xcode
关闭Xcode，然后打开（双击）您项目的 .xcworkspace 文件以启动 Xcode。 从此刻开始，您必须使用 .xcworkspace 文件打开项目。
第 4 步：获取高德Key
请前往高德开放平台控制台申请 iOS Key。
第 5 步：Hello AMap
1.配置Info.plist 文件
iOS9为了增强数据访问安全，将所有的http请求都改为了https，为了能够在iOS9中正常使用地图SDK，请在"Info.plist"中进行如下配置，否则影响SDK的使用。
<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key>
<true></true>
</dict>
2.配置高德Key至AppDelegate.m文件
将上面步骤获取的高德Key，配置到代码中，以保证地图功能的正常运行。代码如下：
#import <AMapFoundationKit/AMapFoundationKit.h>
//需要引入AMapFoundationKit.h头文件
……
(BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
[AMapServices sharedServices].apiKey = @"您的Key";
……
}
3.加载地图
在ViewController.m文件相应的方法中进行地图初始化，初始化的步骤：
- import MAMapKit.h 头文件；
- 构造MAMapView对象；
- 将MAMapView添加到Subview中。
对于3D矢量地图，在 viewDidLoad 方法中添加代码：
#import <MAMapKit/MAMapKit.h>
-(void) viewDidLoad
{
[super viewDidLoad];
// Do any additional setup after loading the view, typically from a nib.
///初始化地图
MAMapView *_mapView = [[MAMapView alloc] initWithFrame:self.view.bounds];
///把地图添加至view
[self.view addSubview:_mapView];
}
第 6 步：连接 iOS 设备
了解您的应用实际运行情况的最简单方法是将 iOS 设备与计算机相连。在手机上信任您的开发者证书，并开启定位。
此外，您也可以使用 iOS 模拟器来运行您的应用。 Xcode 中自带了多种模拟器，您可以选择一种模拟器来构建和运行您的应用。
第 7 步：构建和运行您的应用
在 Xcode 中，点击 Product 菜单中 Run 选项（或 Run 按钮图标）运行您的应用。
您可以看到在您的项目里有地图展示。如果您未看到地图，那请检查您是否联网，如果您看到了地图，但是不能使用POI搜索和路径规划等相关功能，请确认是否添加了您的高德Key。
后续步骤
您可能想观摩一些示例代码。您可以在开发者指南中阅读更多有关导航的内容。
