Использование MRTK2 в крупных проектах

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

Мы рекомендуем ознакомиться со всеми приведенными ниже рекомендациями, которые помогут избежать некоторых сложных проблем при работе с более крупными базами кода.

gitignore

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

Обратите внимание, что начальные части этого кода взяты из github Unity .gitignore по умолчанию с добавлением MRTK позже. Также обратите внимание, что некоторые из этих правил предполагают определенные пути и могут быть изменены в зависимости от того, где MRTK находится в проекте.

# This .gitignore file should be placed at the root of your Unity project directory
#
# Get latest from https://github.com/github/gitignore/blob/master/Unity.gitignore
#
/[Ll]ibrary/
/[Tt]emp/
/[Oo]bj/
/[Bb]uild/
/[Bb]uilds/
/[Ll]ogs/

# MemoryCaptures can get excessive in size.
# They also could contain extremely sensitive data
/[Mm]emoryCaptures/

# Asset meta data should only be ignored when the corresponding asset is also ignored
!/[Aa]ssets/**/*.meta

# Uncomment this line if you wish to ignore the asset store tools plugin
# /[Aa]ssets/AssetStoreTools*

# Autogenerated Jetbrains Rider plugin
/[Aa]ssets/Plugins/Editor/JetBrains*

# Visual Studio cache directory
.vs/

# Gradle cache directory
.gradle/

# Autogenerated VS/MD/Consulo solution and project files
ExportedObj/
.consulo/
*.csproj
*.unityproj
*.sln
*.suo
*.tmp
*.user
*.userprefs
*.pidb
*.booproj
*.svd
*.pdb
*.mdb
*.opendb
*.VC.db

# Unity3D generated meta files
*.pidb.meta
*.pdb.meta
*.mdb.meta

# Unity3D generated file on crash reports
sysinfo.txt

# Builds
*.apk
*.unitypackage

# Crashlytics generated file
crashlytics-build.properties

# NuGet Build Process Generated
# This section covers files that are generated when consuming/using MRTK from NuGet
# May not be relevant if consuming via .unitypackages
/NuGet/*
!/NuGet/BuildSource.proj
/MRTKBuild/
/MSBuild/
/PackagesCopy/
!/scripts/Packaging/NuGetRestoreProject.csproj

Файл ProjectPreferences.asset

Параметры MRTK на уровне Project можно найти в разделе "Изменить"> Project Параметры —> Смешанная реальность Toolkit location. Эти параметры будут сохранены в файле в этом расположении в папке Assets:

Assets/MixedRealityToolkit.Generated/ProjectPreferences.asset

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

Профили пакета SDK для блокировки . Если это отключено, профили MRTK по умолчанию будут глобально редактируемыми, что затрудняет обновление MRTK (это может привести к конфликтам слиянием в самой платформе).

Пропустить конфигуратор проекта MRTK . Если этот параметр отключен, конфигуратор проекта покажет, не совпадают ли текущие параметры MRTK с рекомендуемыми значениями по умолчанию MRTK. Так как проект, возможно, явно не включил некоторые параметры, при проверке этого параметра другие участники совместной работы не увидят это диалоговое окно случайно изменяя параметры. Эти параметры должны быть настроены пользователем, который настраивает проект, а затем игнорируется другими участниками совместной работы.

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