Участие в разработке MRTK

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

Если у вас возникнут вопросы, вы можете обратиться к каналу смешанной реальности-Toolkit на временной резерв. Вступить в сообщество Slack можно с помощью автоматической рассылки приглашений.

Процесс отправки

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

Select Issue Type

Отсюда файл:

  • сообщение об ошибке — проблема с функциональностью одного из компонентов набор средств смешанной реальности
  • документация . проблемы с документацией по смешанной реальности набор средств
  • запрос функции — предложение для новой функции набор средств смешанной реальности

Предложенные запросы на функции

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

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

Примечание

Если вы хотите работать с объектом, который уже существует в невыполненной работе, можно использовать этот рабочий элемент в качестве предложения. Не забудьте также добавить комментарий к задаче, которая будет уведомлять вас об обслуживании, к которой вы работаете.

Процесс вклада

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

  1. Создайте вилку репозитория. Нажмите кнопку "вилка" в правом верхнем углу страницы и следуйте последовательности.
  2. Создайте ветвь в вилке (вне основной ветви), чтобы упростить изолирование любых изменений, пока они не будут готовы к отправке. Чтобы устранить ошибки в течение периода выпуска стабилизации, найдите последнюю prerelease/* ветвь. Новые функции всегда должны приступать к main .

Если вы не знакомы с рабочим процессом Git, Ознакомьтесь с этим введением из GitHub.

При добавлении исправления или компонента ошибки выполните следующие действия.

  1. Реализуйте исправление ошибки или функцию. Инструкции по созданию и развертыванию МРТК развертываются на устройствах Hololens и ВМР. Не забывайте следовать рекомендациям по написанию кода.
  2. При добавлении функции также добавьте пример сцены, демонстрирующий эту функцию.
  3. При добавлении экспериментальной функции написание тестов и документации не требуется. Вместо этого следуйте экспериментальным рекомендациям.
  4. Добавьте тесты для проверки исправления или компонента ошибки. Инструкции по написанию и выполнению тестов находятся на сайте UnitTests.
  5. Убедитесь, что код и функции документированы, как описано в руководстве по документации.
  6. Убедитесь, что код работает так, как задумано на всех платформах. Список поддерживаемых платформ см. в заметках о выпуске . для Windows проектов UWP код должен соответствовать требованиям WACK. для этого создайте Visual Studio решение, щелкните правой кнопкой мыши проект. Магазин > Создание пакетов приложений. Следуйте инструкциям на экране и выполните тесты WACK. Убедитесь, что все они выполнены.
  7. Следуйте инструкциям в запросах на вытягивание при выполнении запроса на вытягивание.