Utilisation de MRTK2 dans les grands projets

Cette page contient quelques conseils utiles pour les consommateurs de MRTK qui l’extrayent dans des projets volumineux existants ou qui configurent quelque chose de nouveau qui sera contrôlé par la source et ont plusieurs développeurs.

Nous vous recommandons de lire toutes les instructions ci-dessous, les suivre vous aidera à éviter certains problèmes délicats lors de l’utilisation de bases de code plus volumineuses

gitignore

Le fichier .gitignore suivant est une base recommandée pour extraire lors de l’utilisation de MRTK : il existe des parties de MRTK qui créent un état local qui peut être ignoré en toute sécurité par le contrôle de code source, qui serait autrement sale d’état git local.

Notez que les parties de début de cette opération sont extraites de github Unity .gitignore par défaut avec des ajouts spécifiques à MRTK ultérieurement. Notez également que certaines de ces règles supposent certains chemins d’accès et peuvent être modifiés en fonction de l’emplacement de MRTK dans votre projet.

# 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

Fichier ProjectPreferences.asset

Vous trouverez les paramètres MRTK Project à l’échelle de l’emplacement Edit -> Project Paramètres -> Mixed Reality Toolkit. Ces paramètres seront enregistrés dans un fichier à cet emplacement dans le dossier Ressources :

Assets/MixedRealityToolkit.Generated/ProjectPreferences.asset

Si votre projet aura plusieurs collaborateurs, il est recommandé d’enregistrer ce fichier de ressources après avoir effectué une configuration initiale des paramètres MRTK. En particulier, envisagez de vérifier les paramètres suivants :

Verrouiller les profils du KIT de développement logiciel (SDK) : s’il est désactivé, les profils MRTK par défaut sont modifiables globalement, ce qui rend les mises à niveau MRTK difficiles (cela peut entraîner des conflits de fusion dans l’infrastructure elle-même)

Ignorez le configurateur de projet MRTK : s’il est désactivé, le configurateur de projet s’affiche si les paramètres MRTK actuels ne correspondent pas aux valeurs par défaut recommandées par MRTK. Étant donné que votre projet a peut-être choisi explicitement de ne pas activer certains paramètres, le fait que ce paramètre soit activé empêche d’autres collaborateurs de voir cette boîte de dialogue modifier les paramètres par inadvertance. Ces paramètres doivent être configurés par la personne qui configure le projet, puis ignorés par les autres collaborateurs.

Activation automatique des fonctionnalités UWP : si cette fonctionnalité est désactivée, certaines fonctionnalités (par exemple, suivi oculaire) peuvent échouer en mode silencieux lorsqu’elles sont déployées sur un appareil, car Unity n’ajoute pas automatiquement les fonctionnalités d’exécution requises au manifeste de l’application. Ce paramètre est vérifié pour protéger votre expérience de déploiement d’application à partir de cette classe de problèmes.