在大型專案中使用 MRTK

此頁面包含一些實用的秘訣,適用于 MRTK 的取用者,這些取用者會將其提取至現有的大型專案,或設定將會受到原始檔控制且擁有多個開發人員的新專案。

建議您閱讀下列所有指導方針,並遵循這些指導方針,以協助避免在使用較大的程式碼基底時遇到一些棘手的問題

gitignore

使用 MRTK 時,建議使用下列 .gitignore 檔來提取-有一些 MRTK 的部分會建立可由原始檔控制安全地忽略的本機狀態,而這種情況會導致本機 git 狀態變更。

請注意,這的開頭部分是取自預設的 github Unity. .gitignore,稍後會有 MRTK 特定的新增專案。 也請注意,其中有些規則會採用特定路徑,而且可以根據 MRTK 在專案中的位置加以修改。

# 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 資產檔案

您可以在編輯 > 專案設定下找到整個專案的 MRTK 設定-> Mixed Reality 工具組位置。 這些設定會儲存至 [資產] 資料夾中位於此位置的檔案:

Assets/MixedRealityToolkit.Generated/ProjectPreferences.asset

如果您的專案將會有多個共同作業者,建議您在初始設定 MRTK 設定之後,簽入此資產檔案。 特別是,請考慮 選取下列設定

鎖定 SDK 設定檔 -如果停用此功能,預設的 MRTK 設定檔將可供全域編輯,使 MRTK 升級變得很具挑戰性, (可能會導致架構本身的合併衝突)

略過 MRTK 專案 設定程式-如果已停用,則專案設定程式會顯示目前的 MRTK 設定是否與 MRTK 的建議預設值不符。 因為您的專案可能已明確選擇不啟用某些設定,所以核取此設定可防止其他共同作業者不慎看到此對話方塊的變更設定。 這些設定應該由設定專案的人員來設定,然後由其他共同作業者略過。

自動啟用 UWP 功能 -如果停用此功能,某些功能 (例如,當部署至裝置時) ,會以無訊息方式失敗,因為 Unity 不會自動將所需的執行時間功能新增至應用程式資訊清單。 核取此設定可保護您的應用程式部署體驗,使其不受這個類別的問題。