使用 Visual Studio Code 扩展

Visual Studio Code 是一个轻量级但功能强大的源代码编辑器,在您的桌面上运行,可用于 Windows、macOS 和 Linux。 它内置了对 JavaScript、TypeScript 和 Node.js 的支持,并为其他语言(如 C++、C#、Java、Python、PHP 和 Go)和运行时(如 .NET 和 Unity)提供丰富的扩展生态系统。 有关详细信息,请参阅 VS Code 入门

Visual Studio Code 允许您通过扩展来扩展您的功能。 Visual Studio Code 扩展可以为整体体验添加更多功能。 随着此功能的发布,您现在可以使用 Visual Studio Code 扩展来处理 Power Pages。

Power Pages 的 Visual Studio Code 扩展

Power Platform Tools 添加了使用 Visual Studio Code 配置网站的功能,使用内置的 Liquid 语言 IntelliSense 在使用 Visual Studio Code 自定义网站界面时启用代码完成、协助和提示方面的帮助。 使用 Visual Studio Code 扩展,您还可以通过 Microsoft Power Platform CLI 配置门户。

备注

  • 您需要确保下载 node.js 并与 Visual Studio Code 安装在同一工作站上,以使 Power Pages 功能正常工作。
  • 确保仅安装 Power Platform Tools,而不是同时安装 Power Platform ToolsPower Platform Tools [预览版]。 有关详细信息,请参阅已知问题

说明如何安装和设置 Power Platform Tools 的动画。

先决条件

在将 Visual Studio Code 扩展用于 Power Pages 之前,您必须:

安装 Visual Studio Code 扩展

安装 Visual Studio Code 后,需要为 Visual Studio Code 安装 Power Platform tools 插件的扩展。

安装 Visual Studio Code 扩展:

  1. 打开 Visual Studio Code。

  2. 从左窗格中选择扩展

    Visual Studio Code 扩展。

  3. 从扩展窗格的右上角选择 设置图标。

  4. 搜索并选择 Power Platform Tools

    选择 Power Platform Tools。

  5. 选择安装

  6. 从状态消息验证扩展是否已成功安装。

下载网站内容

要针对 Microsoft Dataverse 环境进行身份验证和下载网站内容,请参阅教程将 Microsoft Power Platform CLI 与 Power Pages 结合使用 - 下载网站内容

提示

Power Platform Tools 扩展自动启用通过 Visual Studio 集成终端在 Visual Studio Code 中使用 Microsoft Power Platform CLI 命令。

文件图标

Power Pages 的 Visual Studio Code 扩展会自动识别并显示下载的网站内容中的文件和文件夹的图标。

具有特定于网站的文件图标主题的起点模板中的文件列表。

Visual Studio Code 使用默认的文件图标主题,它不显示特定于 Power Pages 的图标。 要查看特定于网站的文件图标,您必须更新 Visual Studio Code 实例来使用特定于 Power Pages 的文件图标主题。

启用特定于门户的文件图标主题:

  1. 打开 Visual Studio Code。

  2. 转到文件>首选项>主题>文件图标主题

  3. 选择 PowerApps 门户图标的主题。

    选择 Power Apps 门户图标的主题。

实时预览

Visual Studio Code 扩展支持实时预览选项,可以在开发体验期间在 Visual Studio Code 界面内查看 Power Pages 内容页面。

要查看预览,在编辑模式下打开 HTML 文件时从右上角选择 “预览”按钮。

页面预览。

预览窗格在正在编辑的页面右侧打开。

显示文件列表的屏幕,在 Visual Studio Code 编辑器中打开文件,右侧显示预览。

预览功能需要其他文件也在同一 Visual Studio Code 会话中打开,这些文件构成要显示的预览的 HTML 标记。 例如,如果只打开 HTML 文件而不使用 Visual Studio Code 打开文件夹结构,您将看到以下消息。

运行提供的命令:“microsoft-powerapps-portals.preview-show”失败。

出现此问题时,使用文件 > 打开文件夹打开文件夹,选择要打开的下载的网站内容文件夹,然后再次尝试预览。

自动完成

Visual Studio Code 扩展中的自动完成功能通过 IntelliSense 显示正在编辑的当前上下文,以及相关的自动完成元素。

页面模板 ID 的自动完成示例。

Liquid 标记

使用 Visual Studio Code 自定义下载的内容时,您现在可以为 Power Pages Liquid 标记使用 IntelliSense。

从键入开始,Liquid 标记列表将出现,您选择标记后,将为其正确设置格式,然后可以进行更多输入。

包含 Liquid 标记完成示例的片段。

Liquid 对象

您可以通过输入 {{ }} 来查看 Liquid 对象代码的完成。 将光标放在括号之间,选择 <CTRL + space> 以显示您可以选择的 Liquid 对象列表。 如果对象具有更多属性,可以输入 .,然后再次选择 <CTRL + space> 查看 Liquid 对象的特定属性。

输入一个 Liquid 对象。

模板标记

您可以将光标放在 {include ' '} 语句中并选择 <CTRL> - space 来查看 Power Pages Web 模板建议。 将显示现有 Web 模板列表供您选择。

模板标记。

创建、删除和重命名网站对象

从 Visual Studio Code 中,您可以创建、删除和重命名以下网站组件:

  • 网页
  • 页面模板
  • Web 模板
  • 内容片段
  • 新资产(Web 文件)

创建操作

您可以使用上下文菜单选项创建新的网站组件,右键选择一个支持的对象,选择 Power Pages,然后选择要创建的网站对象类型。

或者,您可以通过选择 Ctrl + Shift + P 来使用 Visual Studio Code 命令面板。

创建新对象。

您需要指定更多参数来创建对象。

Object 参数设置
网页 名称、页面模板、父页面
页面模板 名称、Web 模板
Web 模板 客户
内容片段 名称,以及片段是 HTML 还是文本。
新资产(Web 文件) 名称、父页面并选择要上载的文件。

重命名和删除操作

从文件导航中,您可以使用上下文菜单重命名或删除 Power Pages 组件。

备注

已删除的对象可以从桌面回收站恢复。

限制

门户的 Power Platform Tools 目前适用以下限制:

另请参见

Microsoft Power Platform CLI 的 Power Pages 支持(预览)