Использование контроля версий Git для редактирования приложений на основе холста (экспериментальная функция)

[Данная статья посвящена предварительному выпуску и может быть изменена.]

Важно!

• Эта функция в настоящее время развертывается, и в зависимости от вашего региона она может быть пока недоступна для вашего клиента. Проверьте переключатель экспериментальных функций, описанный в Включить управление версиями Git, чтобы узнать, доступна ли эта функция в вашем клиенте.
• Это экспериментальная функция. По умолчанию она отключена и должна быть включен перед использованием.
• Экспериментальные функции не предназначены для использования в производственной среде, а их функциональность может быть ограничена. Они доступны перед официальным выпуском, чтобы клиенты могли досрочно получить доступ и предоставить отзывы.

Вы можете использовать экспериментальную функцию управления версиями Git, чтобы разрешить более чем одному человеку редактировать приложение на основе холста одновременно. Благодаря этой функции приложение не будет заблокировано для других пользователей, пока один человек его редактирует. По мере внесения и синхронизации изменений они автоматически объединяются с другими изменениями и становятся доступными для всех остальных, редактирующих приложение.

Git используется как резервное хранилище для этой функции. После первоначальной настройки с подключением к Git любой пользователь может использовать эту функцию без каких-либо дополнительных действий по настройке, за исключением аутентификации с помощью Git.

Любого поставщика Git можно использовать Power Apps Studio— например, GitHub или Azure DevOps. Используйте существующие инструменты Git, чтобы просматривать историю версий, создавать запросы на извлечение и управлять ими, а также выполнять другие задачи управления версиями.

Примечание

• Прежде чем начать, обязательно узнайте известные ограничения этой функции. Использование Git развивается, принцип работы этой функции может измениться. Чтобы получать обновления и оставлять отзывы об этой функции, посетите форум сообщества Power Apps.
• Управление версиями Git осуществляется отдельно для каждого приложения. Каждое приложение необходимо отдельно добавить в систему управления версиями Git.
• После включения контроля версий git автосохранение вашего приложения будет отключено. Вам придется вручную сохранить или синхронизировать изменения.

Включить управление версиями Git

Выполните следующие действия, чтобы включить управление версиями Git в своем приложении.

1. Создайте новое приложение или откройте существующее приложение, которое вы хотите добавить в систему управления версиями Git.

2. Выберите Параметры в Power Apps Studio.

3. Выберите Предстоящие функции.

4. Выберите Экспериментальные функции.

5. Прокрутите вниз до Показывать параметр "Система управления версиями Git" задайте Вкл.

6. Вы увидите новый элемент Система управления версиями Git в левой части панели настроек.

   

   Совет

   Если у вас возникнут другие проблемы с этой функцией, посетите форум сообщества Power Apps.

Подключение приложения к Git

Чтобы соединить ваше приложение с Git, выполните следующие действия.

1. Выберите Параметры в Power Apps Studio.

2. Выберите Система управления версиями Git.

   

3. Выберите Подключить и введите информацию о подключении Git для этого приложения.

   

   • URL-адрес репозитория Git: URL-адрес, который вы обычно используете с инструментами Git. Для Azure DevOps обязательно включите фрагмент /_git/repo URL-адреса, например https://contoso.visualstudio.com/_git/repo.
   • Ветвь: имя ветви для использования.
   • Каталог: используемый каталог в ветви. Вы не можете хранить приложение на основе холста в корне ветви.

   Вам будет предложено создать ветвь или каталог, если он не существует. Если ветвь и каталог уже содержат приложение на основе холста, текущее приложение будет закрыто, а существующее приложение будет загружено из Git.

   После подключения отобразится информация о подключении.

Аутентификация с Git

Power Apps требует, чтобы вы использовали личный маркер доступа вместо пароля учетной записи поставщика управления версиями.

Примечание

Личный маркер доступа — это не то же самое, что ваш пароль как для Power Apps или вашего поставщика Git. Чтобы использовать эту функцию, вы должны создать личный маркер доступа.

У разных поставщиков управления версиями есть разные методы создания личных маркеров доступа. Следуйте инструкциям ниже, чтобы получить личный маркер доступа.

• GitHub - Создание личного маркера доступа
• Azure DevOps - Использование личных маркеров доступа
• Другие поставщики управления версиями: любого поставщика Git можно использовать с системой управления версиями Git. Изучите документацию вашего поставщика, чтобы узнать, как создать личный маркер доступа.

При редактировании приложений, подключенных к Git, вам будет предложено ввести имя пользователя и пароль. Введите ваши имя пользователя и маркер доступа в этом диалоговом окне для аутентификации с помощью Git.

Примечание

Учетные данные Git не хранятся в Power Apps между сеансами. При желании вы можете использовать настройки браузера, чтобы сохранить информацию формы для повторного использования, чтобы избежать частого ввода учетных данных.

Внесите изменения в приложение

После подключения приложения к Git все, что вам нужно сделать, это пройти аутентификацию с учетными данными Git, чтобы открыть и отредактировать приложение. Вам не нужно разбираться в концепциях Git при использовании этой функции для загрузки, редактирования, сохранения, публикации и совместного использования приложения.

Используйте новую кнопку синхронизации в верхней части экрана студии (между кнопками Средство проверки приложений и Отмена), чтобы объединить все текущие изменения с тем, что находится в Git, и перенести результат в студию для дальнейшего редактирования.

Важно!

Приложение нужно будет загружать каждый раз при объединении. Если приложение большое, эта загрузка может занять некоторое время.

После подключения к Git изменения сохраняются в Git, а не в Power Apps. Неопубликованные версии не будут отображаться на портале создателя Power Apps.

Результаты объединения

В настоящее время нет возможности разрешить конфликты объединения. Студия попытается объединить и исправить конфликты автоматически, используя семантические сведения о приложении (например, типы объектов и другие изменения приложения). Поскольку все изменения по-прежнему хранятся в Git, вы всегда можете получить изменения приложения для повторного применения, если автоматическое объединение не соответствует вашим бизнес-требованиям.

Публикация приложения

Приложения, подключенные к Git, продолжают нормально работать для публикации и взаимодействия с пользователем без каких-либо изменений в этом процессе. Когда вы публикуете приложение, версия приложения сохраняется в Power Apps, поскольку для Power Apps требуется работающая копия приложения, которой можно поделиться с пользователями.

Запросы на извлечение, просмотр истории, обвинение и другие функции Git

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

Каждое сохранение или синхронизация, включающая изменения, приведет к фиксации в Git. Если в Git произошли другие изменения, например, другими разработчиками, будут сделаны дополнительные фиксации, чтобы объединить результаты всех изменений. Никакие изменения не будут потеряны, даже если объединение переопределит редактирование. Изменения, внесенные каждым создателем, сохраняются в Git посредством фиксаций.

Известные ограничения

Поскольку эта функция является экспериментальной, мы приветствуем ваши отзывы. Ниже перечислены известные ограничения. Мы планируем снять большинство этих ограничений в будущих версиях.

• Эта функция несовместима с компонентами кода. Не используйте эту функцию с приложениями, в которых используются компоненты кода.
• Эта функция несовместима с локальными репозиториями Git. Репозиторий Git должен быть размещен в Интернете и доступен по имени пользователя и личному маркеру доступа.
• Изменения одного и того же свойства в одном и том же элементе управления не объединяются. Последняя сделанная правка получит приоритет.
• Вы не можете восстановить приложение на основе холста до предыдущей версии с помощью шагов, описанных в статье Восстановление приложения. Вместо этого вам придется использовать Git для восстановления приложения до предыдущей версии. Дополнительные сведения см. на следующих ресурсах:
  • git-revert
  • Отмена фиксации
  • Отменить изменения
• Подключение нескольких приложений к одному и тому же каталогу git может вызвать проблемы. Это включает в себя создание копий вашего приложения, а также их экспорт и импорт.
• Любые существующие в репозитории файлы с именами, длина которых превышает 180 символов, могут вызвать проблемы при подключении. Мы рекомендуем использовать выделенный репозиторий для приложений, подключенных к Git.
• Если нажать кнопку Закрыть в меню Файл, ваши настройки в приложении могут быть удалены. Однако настройки не удаляются. Обновите страницу, чтобы снова увидеть все настройки.
• Если вы открываете приложение, не подключенное к git (например, Приложение А), из приложения, подключенного к git (например, Приложения Б), (Файл > Открыть) и пробуете подключить Приложение А к репозиторию, параметры элемента управления версиями Приложения А в git будут такими же, как Приложения Б. Когда это произойдет, обновите страницу и попытайтесь снова подключить Приложение А к репозиторию.
• Эта функция не поддерживает переименование пользовательских компонентов.
• Если вы видите сообщение о том, что приложение открыто для редактирования другим пользователем, попросите указанного пользователя обновить приложение. После этого обновите приложение, чтобы снять блокировку.
• Эта функция несовместима с тестами Test Studio и пользовательскими страницами для приложений на основе модели
• Эта функция не поддерживает использование личных маркеров доступа, авторизованных для использования с единым входом SAML.

Отзывы на форуме сообщества

Расскажите, что вы думаете! Эта функция — первый шаг на долгом пути к созданию отличного взаимодействия командной разработки. Посетите форум сообщества Power Apps для получения обновлений и обратной связи.