Использование расширения 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.

Расширение Visual Studio Code для Power Pages

Power Platform Tools добавляет возможность настраивать веб-сайты с помощью Visual Studio Code и использовать встроенный язык Liquid IntelliSense для упрощения завершения кода, с подсказками и помощью при настройке интерфейса веб-сайтов с помощью Visual Studio Code. Используя расширение Visual Studio Code, вы также можете настраивать порталы через поддержку интерфейса командной строки Microsoft Power Platform.

Заметка

  • Вам необходимо убедиться, что node.js загружен и установлен на той же рабочей станции, что и Visual Studio Code, чтобы работали функции Power Pages.
  • Убедитесь, что установлены только Power Platform Tools, а не оба параметра: Power Platform Tools и Power Platform Tools [ПРЕДВАРИТЕЛЬНАЯ ВЕРСИЯ]. Дополнительная информация об известных проблемах.

Анимация, объясняющая, как установить и настроить Power Platform Tools.

Предварительные условия

Перед использованием расширения Visual Studio VS Code для Power Pages необходимо:

Установка расширения Visual Studio Code

После установки Visual Studio Code необходимо установить расширение для подключаемого модуля Power Platform Tools для Visual Studio Code.

Для установки расширения 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 с Power Pages — загрузка содержимого веб-сайта.

Совет

Расширение Power Platform Tools автоматически позволяет использовать команды интерфейса командной строки Microsoft Power Platform из Visual Studio Code через встроенный терминал Visual Studio.

Значки файла

Расширение Visual Studio Code для Power Pages автоматически определяет и отображает значки файлов и папок внутри загруженного содержимого веб-сайта.

Список файлов в начальном шаблоне с темой значков файлов для конкретного веб-сайта.

Visual Studio Code использует тему значка файла по умолчанию, которая не показывает значки, относящиеся к Power Pages. Чтобы просмотреть значки файлов, специфичные для ваших веб-сайтов, вам придется обновить экземпляр Visual Studio Code, чтобы использовать тему значков файлов, специфичную для Power Pages.

Для включения темы значков файлов, специфичных для порталов:

  1. Откройте Visual Studio Code.

  2. Перейдите Файл>Параметры>Тема>Тема значка файла

  3. Выберите тему для значков порталов PowerApps.

    Выберите тему для значков порталов Power Apps.

Предварительная версия в реальном времени

Расширение Visual Studio Code включает возможность предварительного просмотра в реальном времени для просмотра страницы с содержимым Power Pages внутри интерфейса Visual Studio Code прямо во время разработки.

Чтобы открыть предварительный просмотр, выберите Кнопка «Просмотр». справа вверху, когда HTML-файл открыт в режиме редактирования.

Предварительный просмотр страницы.

Область предварительного просмотра открывается с правой стороны редактируемой страницы.

Экран со списком файлов, открытым файлом в редакторе Visual Studio Code и предварительным просмотром справа.

Функция предварительного просмотра требует, чтобы другие файлы также были открыты в той же сессии Visual Studio Code, которые составляют HTML-разметку для отображаемого предварительного просмотра. Например, если открыт только файл HTML, а структура папок не открыта с помощью Visual Studio Code, вы увидите следующее сообщение.

Выполнение добавленной команды: 'microsoft-powerapps-portals.preview-show' failed.' не удалось.

Когда эта проблема возникает, откройте папку с помощью команды Файл > Открыть папку и выберите загруженную папку содержимого веб-сайта, чтобы открыть ее, прежде чем пытаться снова открыть предварительный просмотр.

Автозавершение

Возможность автозавершения в расширении Visual Studio Code показывает текущий редактируемый контекст и соответствующие элементы авторазрешения через IntelliSense.

Пример автозавершения для идентификатора шаблона страницы.

Теги Liquid

При настройке загруженного контента с помощью Visual Studio Code теперь вы можете использовать IntelliSense для тегов Liquid в Power Pages.

Начните с ввода текста, и появится список тегов Liquid. Как только вы выберете тег, он будет правильно отформатирован и готов к дальнейшему вводу.

Фрагмент кода с примером завершения тега Liquid.

Объекты Liquid

Вы можете увидеть завершения кода Объект Liquid, когда введете {{ }}. Поместив курсор между скобками, выберите <CTRL + space>, чтобы отобразить список объектов Liquid, которые вы можете выбрать. Если у объекта больше свойств, вы можете ввести ., а затем снова выбрать <CTRL + space>, чтобы увидеть определенные свойства объекта Liquid.

Вход объекта Liquid.

Теги шаблонов

Вы можете просмотреть предложения веб-шаблонов Power Pages, поместив курсор в оператор {include ' '} и выбрав <CTRL> - space. Появится список существующих веб-шаблонов для выбора.

Теги шаблона.

Создание, удаление и переименование объектов веб-сайта

Изнутри Visual Studio Code вы можете создавать, удалять и переименовывать следующие компоненты веб-сайта:

  • Веб-страницы
  • Шаблоны страниц
  • Веб-шаблоны
  • Фрагменты содержимого
  • Новые активы (веб-файлы)

Создание операций

Вы можете использовать параметры контекстного меню для создания новых компонентов веб-сайта. Для этого нажмите правой кнопкой мыши на один из поддерживаемых объектов, выберите Power Pages и выберите тип объекта веб-сайта, который вы хотите создать.

В качестве альтернативы вы можете использовать палитру команд Visual Studio Code, выбрав Ctrl + Shift + P.

Создание нового объекта.

Вам потребуется указать дополнительные параметры для создания объекта.

Object Параметры
Веб-страницы Имя, шаблон страницы, родительская страница
Шаблоны страниц Имя, веб-шаблон
Веб-шаблоны Полное имя
Фрагменты содержимого Имя и будет ли фрагмент кодом HTML или текстом.
Новые активы (веб-файлы) Имя, родительская страница и выберите файл для отправки.

Удаление и переименование операций

Из навигации по файлам вы можете использовать контекстное меню для переименования или удаления компонентов Power Pages.

Заметка

Удаленные объекты можно восстановить из корзины рабочего стола.

Ограничения

Следующие ограничения в настоящее время применяются к Power Platform Tools для порталов:

См. также

Поддержка Power Pages для интерфейса командной строки Microsoft Power Platform (предварительная версия)