使用 JSON 配置文件
JSON 表示 JavaScript 对象表示法,它是一种轻权的数据交换格式,通常用于存储和传输数据。 AL 扩展包含两个 JSON 文件:app.json 和 launch.json 文件。 当您启动一个新的 AL 扩展并用于存储配置数据时,系统会自动创建这些文件。
Launch.json 文件
Launch.json 是一个配置文件,其中包含将扩展部署到测试和调试的服务器的相关信息。 有两种配置可供使用,具体取决于扩展是发布到本地服务器还是发布到云。
下表说明了 launch.json 文件的重要和必需属性。 但是,请务必首先了解本 launch.json 文件中的 startupObjectId 和 startupObjectType 属性。
无论什么时候您在 Visual Studio Code 中启动扩展,都应查看本 launch.json 文件,以确定需要先使用哪个对象。 上图显示了将从第 22 页开始,该页面是客户列表页面。 如果您开发自己的页面并想要首先使用该页面,请将 startupObjectId 属性替换为您自己的页码。
以下是一个链接,您可以在其中找到有关 Launch.json 文件中的所有设置的详细信息:launch.json 文件。
App.json 文件
app.json 文件包含有关您要构建的扩展的信息,例如发布者信息、名称和支持的最低版本。 app.json 文件通常称为清单。
以下是一个链接,您可以在其中找到有关 App.json 文件中的所有设置的详细信息:app.json 文件。
应用标识
使用 AL 构建的应用将扩展 Business Central 的功能。 当您创建新的 AL 项目时,将会自动生成 app.json 文件和 launch.json 文件。 app.json 文件包含有关您要生成的应用的信息(例如发布者信息),并指定生成扩展所基于的基本应用程序对象的最低版本。 app.json 文件通常称为清单。 app.json 文件包含很多项目设置,但其中一些设置构成您要创建的应用的实际标识。
从 Business Central 2021 年发行版本第 2 波开始,名称和发布者不再被视为应用标识的一部分,因此可以进行更改以反映品牌或收购。 如果名称和/或发布者信息已更改,则版本也必须进行递增。 如果您使用包含多个项目的工作区并在工作区中更改扩展的名称或发布者,则必须使用新的名称和发布者更新 app.json 文件中的依赖项,否则您可能会遇到引用解析问题。
当您创建新应用或使用 AL: Generate manifest 命令时,AL 语言扩展会自动生成应用的 ID。
如果您已从其他应用复制应用或清单,则必须先更改该 ID,然后才能将其作为每租户扩展或 AppSource 应用发布到在线服务。
发布应用后,您只能在打算使用代码库开发新应用时更改该 ID。 您将无法从具有旧 ID 的应用升级到具有新 ID 的应用,因为系统不具备二者之间的通信信息。
如果您已将应用作为每租户扩展发布,但您现在正考虑将其发布到 AppSource,则必须为 AppSource 应用分配一个新 ID,并确保它遵循有关发布到 AppSource 的所有技术要求。
建议您对从 Visual Studio Code 发布或发布到容器的应用使用其他 ID。 一旦您对应用的质量感到满意并准备将其发布到 AppSource,建议您使用其他 ID。 如果您不遵循本方法,当有其他用户尝试安装 AppSource 应用时,从 Visual Studio Code 发布到开发人员沙盒的应用将会自动取消发布。
如果您仅以 Business Central 2021 年发行版本第 2 波或更高版本为目标,也可以在发布应用后随时更改该应用的发布者。 如果名称进行了更改,则版本也必须进行递增。
如果您以 2021 年发行版本第 2 波之前的 Business Central 版本为目标,则无法在发布应用后更改该应用的名称和发布者。
只要将新版本的应用上传到 AppSource 或将其作为每租户扩展上传时,就必须递增版本。 在 Visual Studio Code 中开发应用时,您可以继续使用相同的版本并迭代代码。