MRTK2 gebruiken in grote projecten

Deze pagina bevat enkele nuttige tips voor gebruikers van MRTK die het gebruiken voor bestaande grote projecten of het opzetten van iets nieuws dat door de bron wordt beheerd en meerdere ontwikkelaars hebben.

We raden u aan alle onderstaande richtlijnen te lezen. Als u deze volgt, voorkomt u enkele lastige problemen bij het werken aan grotere codebases

gitignore

Het volgende .gitignore-bestand is een aanbevolen basis om op te halen bij het gebruik van MRTK. Er zijn onderdelen van MRTK die de lokale status maken die veilig kunnen worden genegeerd door broncodebeheer, wat anders de lokale Git-status zou vervuilden.

Houd er rekening mee dat de beginonderdelen hiervan zijn overgenomen uit de standaard github Unity .gitignore met later MRTK-specifieke toevoegingen. Houd er ook rekening mee dat sommige van deze regels uitgaan van bepaalde paden en kunnen worden gewijzigd op basis van waar MRTK zich in uw project bevindt.

# 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

Bestand ProjectPreferences.asset

MRTK-instellingen voor het hele project vindt u onder de locatie Bewerken -> Projectinstellingen -> Mixed Reality Toolkit. Deze instellingen worden opgeslagen in een bestand op deze locatie in de map Assets:

Assets/MixedRealityToolkit.Generated/ProjectPreferences.asset

Als uw project meerdere medewerkers heeft, is het raadzaam om dit assetbestand in te checken nadat u de MRTK-instellingen in eerste instantie hebt ingesteld. Overweeg met name de volgende instellingen te controleren:

SDK-profielen vergrendelen : als dit is uitgeschakeld, kunnen de standaard MRTK-profielen globaal worden bewerkt, waardoor MRTK-upgrades lastig zijn (dit kan leiden tot samenvoegingsconflicten in het framework zelf)

MRTK-projectconfigurator negeren : als dit is uitgeschakeld, wordt de projectconfigurator weergegeven als de huidige MRTK-instellingen niet overeenkomen met de standaardinstellingen van MRTK. Omdat uw project er mogelijk expliciet voor heeft gekozen om bepaalde instellingen niet te hebben ingeschakeld, voorkomt u dat andere medewerkers dit dialoogvenster zien en instellingen per ongeluk wijzigen. Deze instellingen moeten worden geconfigureerd door de persoon die het project instelt en vervolgens worden genegeerd door de andere samenwerkers.

UWP-mogelijkheden automatisch inschakelen : als dit is uitgeschakeld, kan bepaalde functionaliteit (bijvoorbeeld ogentracering) op de achtergrond mislukken wanneer deze op een apparaat wordt geïmplementeerd, omdat Unity niet automatisch de vereiste runtimemogelijkheden aan het toepassingsmanifest toevoegt. Als u deze instelling inschakelt, wordt uw toepassingsimplementatie-ervaring beschermd tegen deze klasse problemen.