Utilização de MRTK em grandes projetos

Esta página contém algumas dicas úteis para os consumidores de MRTK que estão puxando-o para grandes projetos existentes, ou criando algo novo que será controlado pela fonte e tem vários desenvolvedores.

Recomendamos a leitura de todas as diretrizes abaixo, seguindo-as ajudará a evitar alguns problemas complicados ao trabalhar em bases de código maiores

gitignore

O seguinte ficheiro .gitignore é uma base recomendada para puxar quando consumir MRTK - há partes do MRTK que criam um estado local que pode ser ignorado com segurança pelo controlo de fontes, que de outra forma sujaria o estado de git local.

Note que as partes iniciais desta são retiradas do padrão github Unitity .gitignore com adições específicas mrtk mais tarde. Note também que algumas destas regras assumem determinados caminhos, e podem ser modificadas com base no local onde o MRTK está localizado dentro do seu projeto.

# 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

ProjectPreferences.ficheiro de ativos

Project configurações MRTK em toda a escala podem ser encontradas no âmbito da localização do Kit de Ferramentas de > Realidade Mista de Edição - Project Definições - > Misturada. Estas definições serão guardadas num ficheiro nesta localização na pasta Ativos:

Assets/MixedRealityToolkit.Generated/ProjectPreferences.asset

Se o seu projeto tiver vários colaboradores, recomenda-se que este ficheiro de ativos seja feito após a configuração inicial das definições de MRTK. Em especial, considere verificar as seguintes definições:

Bloquear perfis SDK - Se este for desativado, os perfis mrtk predefinidos serão globalmente editáveis, o que tornará as atualizações mrtk desafiantes (pode levar a conflitos de fusão no próprio quadro)

Ignore o configurador do projeto MRTK - Se este for desativado, o configurador do projeto mostrará se as atuais definições mrtk não correspondem às padrão recomendadas pelo MRTK. Uma vez que o seu projeto pode ter optado explicitamente por não ter algumas definições ativadas, tendo esta definição verificada impedirá outros colaboradores de verem este diálogo uma alteração inadvertidamente. Estas configurações devem ser configuradas pela pessoa que cria o projeto e depois ignoradas pelos outros colaboradores.

Capacidades UWP ativadas automaticamente - Se esta for desativada, determinadas funcionalidades (por exemplo, rastreio de olhos) podem falhar silenciosamente quando implementadas num dispositivo porque a Unidade não adicionará automaticamente as capacidades de execução necessárias ao manifesto de aplicação. Tendo esta definição verificada irá salvaguardar a sua experiência de implementação de aplicações a partir desta classe de problemas.