Uso di MRTK2 in progetti di grandi dimensioni

Questa pagina contiene alcuni suggerimenti utili per gli utenti di MRTK che lo eseguono il pull in progetti di grandi dimensioni esistenti o la configurazione di qualcosa di nuovo che sarà controllato dal codice sorgente e avrà più sviluppatori.

È consigliabile leggere tutte le linee guida riportate di seguito, per evitare problemi complessi quando si usano codebase più grandi

gitignore

Il file con estensione gitignore seguente è una base consigliata da eseguire durante l'utilizzo di MRTK, ovvero alcune parti di MRTK che creano uno stato locale che può essere ignorato in modo sicuro dal controllo del codice sorgente, che altrimenti sporcherebbe lo stato git locale.

Si noti che le parti iniziali sono tratte dal file con estensione gitignore unity predefinito di github con aggiunte specifiche di MRTK in un secondo momento. Si noti inoltre che alcune di queste regole presuppongono determinati percorsi e possono essere modificate in base alla posizione di MRTK all'interno del progetto.

# 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

File ProjectPreferences.asset

Le impostazioni MRTK a livello di progetto sono disponibili nella posizione Modifica -> Impostazioni progetto -> Realtà mista Toolkit. Queste impostazioni verranno salvate in un file in questo percorso nella cartella Asset:

Assets/MixedRealityToolkit.Generated/ProjectPreferences.asset

Se il progetto avrà più collaboratori, è consigliabile che questo file di asset venga archiviato dopo aver eseguito una configurazione iniziale delle impostazioni MRTK. In particolare, valutare la possibilità di controllare le impostazioni seguenti:

Lock SDK Profiles (Blocca profili SDK ): se questa opzione è disabilitata, i profili MRTK predefiniti saranno modificabili a livello globale, il che renderà difficili gli aggiornamenti di MRTK (può causare conflitti di merge nel framework stesso)

Ignora configuratore di progetto MRTK : se questa impostazione è disabilitata, il configuratore del progetto mostrerà se le impostazioni MRTK correnti non corrispondono alle impostazioni predefinite consigliate di MRTK. Poiché il progetto potrebbe aver scelto in modo esplicito di non avere alcune impostazioni abilitate, se questa impostazione è selezionata, gli altri collaboratori non vedranno questa finestra di dialogo inavvertitamente una modifica delle impostazioni. Queste impostazioni devono essere configurate dalla persona che configura il progetto e quindi ignorate dagli altri collaboratori.

Abilitare automaticamente le funzionalità UWP : se questa opzione è disabilitata, alcune funzionalità (ad esempio, il tracciamento oculare) potrebbero non riuscire quando vengono distribuite in un dispositivo perché Unity non aggiunge automaticamente le funzionalità di runtime necessarie al manifesto dell'applicazione. Se questa impostazione è selezionata, l'esperienza di distribuzione dell'applicazione verrà protetta da questa classe di problemi.