ArcGIS Runtime Toolkit for iOS
ArcGIS Runtime SDK for iOS Toolkit 包含了一些组件,它们将简化您的 iOS 应用开发。查看 示例 项目,以查看这些组件的功能,或者阅读 文档 以获取更多相关信息。
要在项目中使用 Toolkit:
- 使用 Swift 包管理器安装 - 将
https://github.com/Esri/arcgis-runtime-toolkit-ios
添加为包存储库 URL。 - 使用 CocoaPods 安装 - 将
pod 'ArcGIS-Runtime-Toolkit-iOS'
添加到您的 podfile。 - 手动构建 - 如果您想自定义或扩展工具集,则手动构建和包含。
工具组件
- 增强现实(AR) - 通过与 ARKit 集成将场景视图与增强现实(AR)相结合。
- 书签 - 从地图、场景或列表中显示书签。
- 指南针 - 在地图旋转时显示指南针方向。当地图指向北时自动隐藏。
- 楼层过滤器 - 允许通过网站、场地内的建筑或建筑物中的楼层对地理视图中的楼层规划数据进行筛选。
- 作业管理器 - 当应用处于后台、终止和重新启动时,挂起和恢复 ArcGIS Runtime 任务。
- 图例视图控制器 - 在包含在
AGSGeoView
中的地图或场景的所有层上显示图例。 - 测量工具栏 - 允许在地图视图中测量距离和面积。
- PopupController - 显示详细信息和中媒介,编辑属性、几何形状和相关信息,以及管理特性和图形的附件(弹出窗口定义在特性和图形的“弹出”属性中)。
- 标尺 - 显示当前比例参考。
- 模板选择控制器 - 允许用户在创建新特性时从
AGSFeatureTemplate
列表中选择模板。 - 时间滑块 - 允许交互式定义时间范围(即时间范围),并向前或向后动画时间移动。可用于在MapView或SceneView中操作时间范围。
需求
- ArcGIS iOS运行时SDK 100.15.0(或更高版本)
- Xcode 13.0(或更高版本)
ArcGIS Runtime Toolkit for iOS的目标SDK版本为14.0,这意味着它可以在带有iOS 14.0或更高版本的设备上运行。
说明
Swift包管理器
- 在Xcode中打开您的项目
- 转到《文件》>《Swift包》>《添加包依赖项》选项
- 将
https://github.com/Esri/arcgis-runtime-toolkit-ios
作为包存储库URL输入 - 选择版本100.15.0或更高版本。点击下一步。
注意:工具包Swift包将ArcGIS SDK Swift包作为依赖项添加,因此不需要单独添加。如果您已经添加了ArcGIS SDK Swift包,请将其删除并仅添加工具包Swift包。
初次使用Swift包管理器?访问swift.org/package-manager/。
CocoaPods
- 在您的podfile中添加
pod 'ArcGIS-Runtime-Toolkit-iOS'
- 运行
pod install
。这将下载工具包以及它所依赖的ArcGIS Runtime SDK for iOS,然后配置您的项目以引用这两个组件 - 在您的源代码中添加
import ArcGISToolkit
并开始使用工具包组件
初识cocoapods?请访问 cocoapods.org
手册
- 克隆或下载此仓库
- 通过Xcode项目导航面板拖放
arcgis-runtime-toolkit-ios
文件夹到您的项目中 - 通过将 ArcGISToolkit 库添加到您的应用目标“通用”面板的“框架、库和嵌入内容”部分中,在您的应用中添加 ArcGISToolkit 库。由于 ArcGISToolkit 库包含 ArcGIS Runtime SDK for iOS 库,因此您不需要单独添加。
- 在您的源代码中添加
import ArcGIS
和import ArcGISToolkit
并开始使用工具包组件
注意:手动安装方法还允许您通过修改 swift package 进行微调来使用本地的ArcGIS Runtime SDK for iOS安装。
配置API密钥
一些工具包组件和示例使用了可即时使用的ArcGIS平台服务集,包括底图,因此需要在 AppDelegate.swift
中设置API密钥。请参阅 设置指南 了解更多信息。
SwiftLint
工具包和示例应用都支持SwiftLint。您可以从 这里 安装SwiftLint。虽然为了构建并不需要安装它,但是不安装将会有警告。在 Toolkit
和 Examples
目录中的 swiftlint.yml
文件中可以找到lint使用具体规则。
其他资源
问题
发现了一个错误或想请求新功能?请通过提交问题来告诉我们。
贡献
Esri欢迎所有人做出贡献。请参阅我们的贡献指南。
许可
版权所有 2017 - 2022 Esri
本文件依据Apache License,版本2.0(以下简称“许可”)许可;除非符合适用的法律规定或书面同意,不得使用此文件。您可以在以下位置获得许可的副本:
https://apache.ac.cn/licenses/LICENSE-2.0
除非法律要求或书面同意,否则在许可下分发的软件按照“现状”分发,不提供任何形式的明示或默示保证。有关权限和限制的具体内容,请参阅许可。
许可副本存储在存储库的LICENSE文件中。