使用英语阅读

通过


你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

创建 iOS 应用(预览版)

本文介绍如何将 Azure Maps 添加到 iOS 应用。 本文演示如何完成以下基本步骤:

  • 设置开发环境。
  • 创建自己的 Azure Maps 帐户。
  • 获取主 Azure Maps 密钥以在应用中使用。
  • 从项目中引用 Azure Maps 库。
  • 将 Azure Maps 控件添加到应用。

备注

Azure Maps iOS SDK 停用

适用于 iOS 的 Azure Maps 本机 SDK 现已弃用,并将于 2025 年 3 月 31 日停用。 为了避免服务中断,请在 2025 年 3 月 31 日之前迁移到 Azure Maps Web SDK。 有关详细信息,请参阅 Azure Maps iOS SDK 迁移指南

先决条件

如果没有 Azure 订阅,请在开始之前创建一个免费帐户

备注

有关 Azure Maps 中身份验证的详细信息,请参阅在 Azure Maps 中管理身份验证

创建 Azure Maps 帐户

通过以下步骤创建新的 Azure Maps 帐户:

  1. Azure 门户的左上角选择“创建资源”。

  2. 在“在市场中搜索”框中,键入“Azure Maps”。

  3. 在“结果”中,选择“Azure Maps”,然后选择地图下方显示的“创建”按钮 。

  4. 在“创建 Maps 帐户”页上,输入以下值 :

    • 要用于此帐户的订阅。
    • 此帐户的资源组名称。 可以选择新建或使用现有的资源组。
    • 新帐户的名称。
    • 此帐户的定价层 。
    • 阅读许可证和隐私声明,并选择复选框接受这些条款 。
    • 选择“创建”按钮。

    创建 Azure Maps 帐户。

获取帐户的订阅密钥

成功创建 Maps 帐户后,检索查询 Maps API 的主密钥。

  1. 在门户中打开 Maps 帐户。

  2. 在设置部分中,选择“身份验证” 。

  3. 将“主密钥”复制到剪贴板。 本地保存它以便稍后在本教程中使用。

备注

本快速入门使用共享密钥身份验证进行演示,但适用于任何生产环境的首选方法是使用 Microsoft Entra 身份验证

屏幕截图显示 Azure 门户中的 Azure Maps 订阅密钥。

在 Xcode 中创建项目

首先,创建新的 iOS 应用项目。 请完成以下步骤来创建 Xcode 项目:

  1. 在“文件”下,选择“新建”->“项目”。

  2. 在“iOS”选项卡上,依次选择“应用”和“下一步” 。

  3. 输入应用名称、捆绑 ID,然后选择“下一步”。

请参阅为应用创建 Xcode 项目,获取有关创建新项目的更多帮助。

创建第一个 iOS 应用程序。

安装 Azure Maps iOS SDK

生成应用程序的下一步是安装 Azure Maps iOS SDK。 请完成以下步骤来安装该 SDK:

  1. 在“项目导航器”中选择了所需的 Xcode iOS 项目后,选择 + 按钮以“添加包依赖项”。

    添加包依赖项。

  2. 在生成的对话框中输入以下值:

    • 在右上角出现的搜索栏中输入 https://github.com/Azure/azure-maps-ios-sdk-distribution.git
    • 在“依赖项规则”字段中选择 Up to Next Major Version
    • 1.0.0-pre.3 输入“依赖项规则”版本字段中。

    将依赖项规则添加到 iOS 项目。

  3. 解析包及其依赖项后,选择“添加包”按钮以完成依赖项设置。

    将包添加到 iOS 项目。

添加 MapControl 视图

  1. 添加自定义 UIView 以查看控制器

  2. AzureMapsControl 模块中选择 MapControl

    添加 Azure Maps 控件。

  3. AppDelegate.swift 文件中:

    • 添加 Azure Maps SDK 的导入
    • 设置 Azure Maps 身份验证信息

使用 AzureMaps.configure(subscriptionKey:)AzureMaps.configure(aadClient:aadAppId:aadTenant:) 在 AzureMaps 类上全局设置身份验证信息后,无需在每个视图上添加身份验证信息。

  1. 如下图所示,选择“运行”按钮(或按 CMD + R)来生成应用程序。

    运行 iOS 应用程序。

Xcode 将花费几秒钟时间来生成应用程序。 生成完成后,可在 iOS 仿真设备中测试应用程序。 应会看到如下所示的地图:

iOS 应用程序上的第一个地图。

访问地图功能

可通过在 mapView.onReady 处理程序中保留 AzureMap 实例,开始自定义地图功能。 添加 MapControl 视图后,示例 ViewController 应类似于以下代码:

class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        let mapView = self.view.subviews.first as? MapControl;
        mapView?.onReady({ map in
            // customize your map here
            // map.sources.add()
            // map.layers.insertLayer()
        })
    }
}

对于一个此类示例,请继续到在 iOS SDK 中将多边形层添加到地图

清理资源

执行以下步骤清理本快速入门中创建的资源:

  1. 关闭 Xcode 并删除创建的项目。

  2. 如果在外部设备上测试了应用程序,请从该设备上卸载它。

如果不打算继续使用 Azure Maps iOS SDK 进行开发,请执行以下操作:

  1. 导航到 Azure 门户页面。 选择门户主页中的“所有资源”。 或者,选择左上角的菜单图标,然后选择“所有资源”。

  2. 选择你的 Azure Maps 帐户。 在页面顶部,选择“删除”。

  3. 如果不打算继续开发 iOS 应用,请卸载 Xcode。

其他信息

有关更多代码示例,请参阅以下文章: