Verwenden von MRTK2 in großen Projekten

Diese Seite enthält einige nützliche Tipps für Verbraucher von MRTK, die es in vorhandene große Projekte ziehen oder etwas Neues einrichten, das quellgesteuert und mehrere Entwickler hat.

Es wird empfohlen, alle nachstehenden Richtlinien zu lesen, indem sie ihnen helfen, einige schwierige Probleme beim Arbeiten an größeren Codebasen zu vermeiden.

gitignore

Die folgende GITignore-Datei ist eine empfohlene Basis, die beim Verbrauch von MRTK abgerufen werden soll – es gibt Teile von MRTK, die den lokalen Zustand erstellt, der von der Quellcodeverwaltung sicher ignoriert werden kann, was andernfalls den lokalen Git-Zustand verdreckt.

Beachten Sie, dass die Anfangsteile dieser Elemente später von der standardmäßigen github Unity .gitignore mit MRTK-spezifischen Ergänzungen übernommen werden. Beachten Sie außerdem, dass einige dieser Regeln bestimmte Pfade annehmen und basierend darauf geändert werden können, wo MRTK sich in Ihrem Projekt befindet.

# 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-Datei

Project-breiten MRTK-Einstellungen finden Sie unter dem Speicherort "Edit -> Project Einstellungen -> Mixed Reality Toolkit". Diese Einstellungen werden an diesem Speicherort im Ordner "Assets" in einer Datei gespeichert:

Assets/MixedRealityToolkit.Generated/ProjectPreferences.asset

Wenn Ihr Projekt über mehrere Mitarbeiter verfügt, empfiehlt es sich, diese Ressourcendatei nach der ersten Einrichtung von MRTK-Einstellungen einchecken zu lassen. Beachten Sie insbesondere, dass die folgenden Einstellungen überprüft werden:

Lock SDK-Profile – Wenn dies deaktiviert ist, werden die standardmäßigen MRTK-Profile global bearbeitbar, wodurch MRTK-Upgrades schwierig werden (es kann zu Zusammenführungskonflikten im Framework selbst führen)

MrTK-Projektkonfigurator ignorieren - Wenn dies deaktiviert ist, zeigt der Projektkonfigurator an, ob die aktuellen MRTK-Einstellungen nicht den empfohlenen MRTK-Standardwerten entsprechen. Da Ihr Projekt möglicherweise nicht für einige Einstellungen aktiviert wurde, hindert diese Einstellung daran, dass andere Mitarbeiter dieses Dialogfeld versehentlich ändern. Diese Einstellungen sollten von der Person konfiguriert werden, die das Projekt eingerichtet hat und dann von den anderen Mitarbeitern ignoriert wird.

Automatische Aktivierung von UWP-Funktionen – Wenn dies deaktiviert ist, können bestimmte Funktionen (z. B. Eye Tracking) beim Bereitstellen auf einem Gerät automatisch fehlschlagen, da Unity die erforderlichen Laufzeitfunktionen nicht automatisch zum Anwendungsmanifest hinzufügt. Wenn sie diese Einstellung überprüft haben, wird die Anwendungsbereitstellung von dieser Problemklasse geschützt.