Uso de MRTK2 en proyectos grandes

Esta página contiene algunas sugerencias útiles para los consumidores de MRTK que lo están extrayendo a proyectos grandes existentes, o configurando algo nuevo que se controlará de origen y tendrá varios desarrolladores.

Se recomienda leer todas las instrucciones que se indican a continuación, lo que les ayudará a evitar algunos problemas complicados al trabajar en bases de código más grandes.

gitignore

El siguiente archivo .gitignore es una base recomendada para extraer al consumir MRTK: hay partes de MRTK que crean un estado local que se puede omitir de forma segura mediante el control de código fuente, lo que de otro modo desfasaría el estado de Git local.

Tenga en cuenta que las partes iniciales de esto se toman del github predeterminado Unity .gitignore con adiciones específicas de MRTK más adelante. Tenga en cuenta también que algunas de estas reglas asumen ciertas rutas de acceso y se pueden modificar en función de dónde se encuentra MRTK en el proyecto.

# 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

Archivo ProjectPreferences.asset

La configuración de MRTK para todo el proyecto se puede encontrar en la ubicación Editar -> Configuración del proyecto -> Mixed Reality Toolkit. Esta configuración se guardará en un archivo en esta ubicación de la carpeta Assets:

Assets/MixedRealityToolkit.Generated/ProjectPreferences.asset

Si el proyecto tendrá varios colaboradores, se recomienda que este archivo de recursos se proteja después de realizar una configuración inicial de la configuración de MRTK. En concreto, considere la posibilidad de comprobar la siguiente configuración:

Bloquear perfiles del SDK : si se deshabilita, los perfiles de MRTK predeterminados serán editables globalmente, lo que hará que las actualizaciones de MRTK sean difíciles (puede provocar conflictos de combinación en el propio marco).

Omitir el configurador de proyectos de MRTK : si está deshabilitado, el configurador del proyecto se mostrará si la configuración actual de MRTK no coincide con los valores predeterminados recomendados de MRTK. Dado que es posible que el proyecto haya elegido explícitamente no tener habilitada alguna configuración, si esta configuración está activada, impedirá que otros colaboradores vean este cuadro de diálogo de forma involuntaria. Esta configuración debe ser configurada por la persona que configura el proyecto y, a continuación, ignorada por los demás colaboradores.

Habilitar automáticamente las funcionalidades de UWP : si está deshabilitada, ciertas funcionalidades (por ejemplo, seguimiento ocular) pueden producir errores silenciosamente cuando se implementan en un dispositivo porque Unity no agregará automáticamente las funcionalidades de tiempo de ejecución necesarias al manifiesto de aplicación. Si se activa esta configuración, se protegerá la experiencia de implementación de la aplicación de esta clase de problemas.