Usando o MRTK2 em projetos grandes

Esta página contém algumas dicas úteis para os consumidores do MRTK que estão puxando-o para projetos grandes existentes ou configurando algo novo que será controlado pela origem e terá vários desenvolvedores.

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

gitignore

O arquivo .gitignore a seguir é uma base recomendada para efetuar pull ao consumir o MRTK – há partes do MRTK que criam um estado local que pode ser ignorado com segurança pelo controle do código-fonte, o que, de outra forma, sujaria o estado git local.

Observe que as partes inicios disso são retiradas do github Unity .gitignore padrão com adições específicas do MRTK posteriormente. Observe também que algumas dessas regras assumem determinados caminhos e podem ser modificadas com base em onde o MRTK está localizado em 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

Arquivo ProjectPreferences.asset

Project configurações do MRTK em todo o mundo podem ser encontradas no local de Realidade Misturada Toolkit Editar -> Project Configurações.> Essas configurações serão salvas em um arquivo neste local na pasta Ativos:

Assets/MixedRealityToolkit.Generated/ProjectPreferences.asset

Se o projeto tiver vários colaboradores, é recomendável que esse arquivo de ativo seja verificado depois de fazer uma configuração inicial das configurações do MRTK. Em particular, considere ter as seguintes configurações marcadas:

Bloquear perfis do SDK – se isso estiver desabilitado, os perfis padrão do MRTK serão editáveis globalmente, o que tornará as atualizações do MRTK desafiadoras (isso pode levar a conflitos de mesclagem na própria estrutura)

Ignorar o configurador de projeto do MRTK – se isso estiver desabilitado, o configurador do projeto mostrará se as configurações atuais do MRTK não correspondem aos padrões recomendados pelo MRTK. Como seu projeto pode ter explicitamente escolhido não ter algumas configurações habilitadas, ter essa configuração verificada impedirá que outros colaboradores vejam essa caixa de diálogo com uma alteração inadvertidamente. Essas configurações devem ser configuradas pela pessoa que está configurando o projeto e, em seguida, ignoradas pelos outros colaboradores.

Habilitar automaticamente os recursos UWP – se isso estiver desabilitado, determinada funcionalidade (por exemplo, acompanhamento ocular) poderá falhar silenciosamente quando implantada em um dispositivo porque o Unity não adicionará automaticamente os recursos de runtime necessários ao manifesto do aplicativo. Ter essa configuração verificada protegerá sua experiência de implantação de aplicativo dessa classe de problemas.