Korzystanie z zestawu NARZĘDZI MRTK2 w dużych projektach

Ta strona zawiera kilka przydatnych wskazówek dla użytkowników zestawu narzędzi MRTK, które ściągają je do istniejących dużych projektów lub konfigurują coś nowego, które będą kontrolowane przez źródło i mają wielu deweloperów.

Zalecamy zapoznanie się ze wszystkimi poniższymi wytycznymi, co pomoże uniknąć pewnych trudnych problemów podczas pracy nad większymi bazami kodu

gitignore

Poniższy plik .gitignore jest zalecaną bazą do ściągania podczas korzystania z zestawu NARZĘDZI MRTK — istnieje część zestawu NARZĘDZI MRTK, która tworzy stan lokalny, który może być bezpiecznie ignorowany przez kontrolę źródła, co w przeciwnym razie spowoduje brudne lokalnego stanu git.

Należy pamiętać, że początkowe części tego elementu są pobierane z domyślnego rozszerzenia github Unity .gitignore z dodatkami specyficznymi dla zestawu NARZĘDZI MRTK później. Należy również pamiętać, że niektóre z tych reguł zakładają pewne ścieżki i można je modyfikować w oparciu o lokalizację zestawu narzędzi MRTK w projekcie.

# 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

Plik ProjectPreferences.asset

Ustawienia zestawu narzędzi MRTK dla całego projektu można znaleźć w lokalizacji Edytuj —> Ustawienia projektu —> Mixed Reality Toolkit. Te ustawienia zostaną zapisane w pliku w tej lokalizacji w folderze Assets:

Assets/MixedRealityToolkit.Generated/ProjectPreferences.asset

Jeśli projekt będzie miał wielu współpracowników, zaleca się zaewidencjonować ten plik zawartości po wstępnej konfiguracji ustawień zestawu narzędzi MRTK. W szczególności rozważ sprawdzenie następujących ustawień:

Blokowanie profilów zestawu SDK — jeśli jest to wyłączone, domyślne profile zestawu NARZĘDZI MRTK będą globalnie edytowalne, co sprawi, że uaktualnienia zestawu MRTK będą trudne (może to prowadzić do konfliktów scalania w samej strukturze)

Ignoruj konfigurator projektu MRTK — jeśli jest to wyłączone, konfigurator projektu pokaże, czy bieżące ustawienia zestawu narzędzi MRTK nie są zgodne z zalecanymi ustawieniami domyślnymi zestawu narzędzi MRTK. Ponieważ projekt mógł jawnie nie mieć włączonego ustawienia, to sprawdzenie tego ustawienia uniemożliwi innym współpracownikom wyświetlanie tego okna dialogowego przypadkowo zmieniających się ustawień. Te ustawienia należy skonfigurować przez osobę konfigurując projekt, a następnie ignorowaną przez innych współpracowników.

Automatyczne włączanie funkcji platformy UWP — jeśli jest to wyłączone, niektóre funkcje (na przykład śledzenie oczu) mogą dyskretnie zakończyć się niepowodzeniem po wdrożeniu na urządzeniu, ponieważ aparat Unity nie doda automatycznie wymaganych funkcji środowiska uruchomieniowego do manifestu aplikacji. Po sprawdzeniu tego ustawienia środowisko wdrażania aplikacji zostanie zabezpieczone przed tą klasą problemów.