什么是应用程序项目?

AppStudio 应用程序以项目形式存储在 ArcGIS 中。无论您是新建应用程序还是从模板创建应用程序,所有应用程序都由相同的核心文件和您自己的自定义内容组成。您可以在自己的设备之间或与他人共享应用程序项目,或者向 Esri 云端构建服务发送请求以生成操作系统特定安装文件。下面将介绍您的应用程序项目中包含的文件。

Appinfo

Appinfo 是一个配置文件,包含用于定义应用程序操作的信息。如果您的应用程序包含已在应用程序设置中定义的所有属性,则这些属性将存储在 Appinfo 文件中,其中包括:

  • 功能,例如使用音频、蓝牙、照相机、位置传感器、麦克风、网络和存储。
  • 部署平台选择。
  • 最小显示尺寸、纵向和横向规格。
  • 自定义属性。
  • 资源,例如背景和应用程序图标图像。
  • 翻译文件及其位置。

Appschema

Appschema 是一个配置文件,可在 AppStudio 设置中定义如何将应用程序的自定义属性呈现给用户。“设置”工具的第二个选项卡(默认情况下标记为“属性”,但是可进行自定义)可显示所有自定义属性。根据 Appschema 中的定义,每个属性可与 UI 结合显示,从而帮助用户更改属性或作为属性的简单列表进行编辑。

例如,如果将属性定义为“图像”类型,将出现一个图像浏览器并显示该图像的预览。

属性类型包括:

  • 注释 - 要显示在屏幕上的文本,对于描述一组属性非常有用。
  • 字符串 - 包括占位符(占位符文本)、regex(验证正则表达式模式)和错误(值无效时显示的错误消息)的属性。
  • 数值 - 包括占位符(占位符文本)、最小值(允许的最小值)、最大值(允许的最大值)、精度(小数点后的最大位数)和错误(值无效时显示的错误消息)的属性。
  • 布尔 - 向用户提供布尔控制。
  • Richtext - 包括占位符(占位符文本)的属性。
  • 选项 - 包含标注和值属性的对象数组。
  • 颜色 - 向用户提供颜色选取器。
  • 文件 - 包括文件夹(文件夹名称)和过滤器(包含文件过滤器的字符串数组)的属性。
  • 图像 - 包括文件夹(文件夹名称)和过滤器(包含文件过滤器的字符串数组)的属性。

对于每个属性,可以定义以下内容:

  • 类型 - 上述任一类型。
  • 名称 - 属性的名称。不能包含空格。
  • 标注 - 属性的标注。可以包含空格。
  • 提示 - 帮助用户定义属性的提示文本。
  • 值 - 属性的默认值。

可对属性进行分类,从而以组的形式提供给用户。例如,类别可显示为选项卡。属性选项卡和类别选项卡的标题都可以自定义。

Iteminfo

Iteminfo 是一个配置文件,包含用于定义 ArcGIS 项目的信息。其中包括:

  • 访问信息和权限。
  • 缩略图、项目名称、摘要和描述。
  • 所有者、组织和群组信息。
  • 标签和关键字。

QML/JavaScript

应用程序的结构由.qml 和 .js 文件构成。如果使用专题模板来创建应用程序,则将显示大量 .qml 文件。如果您已在 AppStudio 中创建新应用程序,则将仅显示一个 .qml 文件,但是您的应用程序可使用任意数量的 .qml 文件。可以在您的 .qml 文件(如专题应用程序中所示)中写入 JavaScript,或者从外部 .js 文件通过 QML 引用 JavaScript。

资产

资产包括背景、按钮和徽标图像,以及要包括在应用程序中的任何其他数据。 这些资产必须位于要包括在您的 ArcGIS 项目中的工程文件夹以及任何后续分发或安装文件中。