Utilisation de MRTK2 dans de grands projets

  • Article

Cette page contient quelques conseils utiles pour les consommateurs de MRTK qui l’tirent dans de grands projets existants, ou la configuration de quelque chose de nouveau qui sera contrôlé par la source et aura plusieurs développeurs.

Nous vous recommandons de lire toutes les instructions ci-dessous, en les suivant pour éviter certains problèmes délicats lors de l’utilisation de codebases plus volumineuses

gitignore

Le fichier .gitignore suivant est une base recommandée pour extraire lors de la consommation 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 sale’état git local.

Notez que les premières parties de ce sont tirées du 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ées 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

Les paramètres MRTK à l’échelle du projet se trouvent sous l’emplacement Modifier -> Paramètres du projet -> Mixed Reality Toolkit. Ces paramètres seront enregistrés dans un fichier à cet emplacement dans le dossier Assets :

Assets/MixedRealityToolkit.Generated/ProjectPreferences.asset

Si votre projet a 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) : si cette option est désactivée, les profils MRTK par défaut sont globalement modifiables, ce qui rend les mises à niveau MRTK difficiles (cela peut entraîner des conflits de fusion dans l’infrastructure elle-même)

Ignorer 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 explicitement choisi de ne pas activer certains paramètres, l’activation de ce paramètre empêchera 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 option est désactivée, certaines fonctionnalités (par exemple, le 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. Le fait de vérifier ce paramètre protège votre expérience de déploiement d’application contre cette classe de problèmes.