Profile variables are generic key/value combinations that you can use to quickly alter Addressables configurations for different development situations.

譯：Profile變量是通用的鍵/值組合，可用于快速更改Addressables配置以適應(yīng)不同的開發(fā)情況。

There are two types of Profile Variables - standard, and path pairs. Standard variables are standalone key/value pairs. Path pairs use a special naming convention to connect sets of variables together.

譯：Profile變量有兩種類型：標(biāo)準(zhǔn)變量和路徑對(duì)。標(biāo)準(zhǔn)變量是獨(dú)立的鍵/值對(duì)。路徑對(duì)使用特殊的命名約定將一組變量連接在一起。

Path pairs are typically used to switch between different build and load paths for different development situations. For example, you could use path pairs to modify the build and load paths for your Addressable content for various platforms.

譯：路徑對(duì)通常用于在不同的開發(fā)情況下切換不同的構(gòu)建和加載路徑。例如，您可以使用路徑對(duì)來修改Addressable內(nèi)容的構(gòu)建和加載路徑以適應(yīng)各種平臺(tái)。

Adding a new standard variable

You can add two kinds of variables to your profiles:

譯：您可以將兩種類型的變量添加到您的profiles中：

• A basic variable, which defines a single value譯：基本變量，定義單個(gè)值

• A path pair, which defines a set of two path values. One value is for the build path and one is for the load path譯：路徑對(duì)，定義一組兩個(gè)路徑值。一個(gè)值用于構(gòu)建路徑，另一個(gè)值用于加載路徑

You can use basic variables as components of your path values (for example,?BuildTarget) and you can use them in your own build scripts. Use path pair variables to set the?Build & Local Paths?setting of your Addressables [Groups] and [remote catalog].

譯：您可以使用基本變量作為您路徑值的組件（例如BuildTarget），并將它們用于自己的構(gòu)建腳本。使用路徑對(duì)變量來設(shè)置Addressables [Groups]和[remote catalog]的Build＆Local Paths設(shè)置。

To add a new Profile variable, select either?Variable?or?Build Load Path Variable?from the?Create?menu. Assign the new variable a name and value, then select?Save. Addressables then adds the new variable to all profiles.

譯：要添加新的Profile變量，請(qǐng)從Create菜單中選擇Variable或Build Load Path Variable。為新變量分配名稱和值，然后選擇Save。然后，Addressables將新變量添加到所有profiles中。

Right-click (macOS: cmd + click) on the variable name to rename or delete the variable.

譯：右鍵單擊（macOS：cmd +單擊）變量名稱以重命名或刪除變量。

Path Pairs

Path pairs define a matched set of?BuildPath?and?LoadPath?variables. When you create a path pair, you can use the pair name to assign the [path setting] of an Addressable [Group] or remote catalog as a unit.

譯：路徑對(duì)定義匹配的BuildPath和LoadPath變量集。創(chuàng)建路徑對(duì)時(shí)，您可以使用對(duì)名稱將Addressable [Group]或遠(yuǎn)程目錄的[path setting]分配為一個(gè)單位。

To create a path pair, go to?Create?and select?Build Load Path Variables. Assign the path pair a prefix name and assign path strings to the individual fields.

譯：要?jiǎng)?chuàng)建路徑對(duì)，請(qǐng)轉(zhuǎn)到Create并選擇Build Load Path Variables。為路徑對(duì)分配一個(gè)前綴名稱，并將路徑字符串分配給各個(gè)字段。

The new path pair uses the?Custom?setting for the?Bundle Location?property with your initial values. You can change to a different?Bundle Location?if needed.

譯：新的路徑對(duì)使用Custom設(shè)置為Bundle Location屬性與您的初始值。如果需要，可以更改為其他Bundle Location。

TIP

You can convert two regular variables for the build and load paths into a path pair by renaming them in the Profile window. Set one to?VariableName.BuildPath?and the other to?VariableName.LoadPath.

譯：您可以通過在Profile窗口中重命名它們將兩個(gè)常規(guī)變量轉(zhuǎn)換為構(gòu)建和加載路徑的路徑對(duì)。將一個(gè)設(shè)為VariableName.BuildPath，將另一個(gè)設(shè)為VariableName.LoadPath。

Default path values

The default values for the build and load paths are:

譯：構(gòu)建和加載路徑的默認(rèn)值為：

• Local build path:?[UnityEditor.EditorUserBuildSettings.activeBuildTarget]譯：本地構(gòu)建路徑：[UnityEditor.EditorUserBuildSettings.activeBuildTarget]

• Local load path:?[UnityEngine.AddressableAssets.Addressables.BuildPath]/[BuildTarget]譯：本地加載路徑：[UnityEngine.AddressableAssets.Addressables.BuildPath]/[BuildTarget]

• Remote build path:?ServerData/[BuildTarget]譯：遠(yuǎn)程構(gòu)建路徑：ServerData/[BuildTarget]

• Remote load path:?http://localhost/[BuildTarget]譯：遠(yuǎn)程加載路徑：http://localhost/[BuildTarget]

In most cases, you should not change the local path values. The Unity build system expects the AssetBundles and other files to exist in the default location. If you change the local paths, you must copy the files from the build path to the load path before making your Player build. The load path must always be within the Unity?StreamingAssets?folder.

譯：在大多數(shù)情況下，您不應(yīng)更改本地路徑值。Unity構(gòu)建系統(tǒng)期望AssetBundles和其他文件存在于默認(rèn)位置。如果您更改了本地路徑，則必須在創(chuàng)建Player構(gòu)建之前將文件從構(gòu)建路徑復(fù)制到加載路徑。加載路徑必須始終在Unity StreamingAssets文件夾內(nèi)。

If you distribute content remotely, you must modify the the remote load path to reflect the URL at which you host your remote content. You can set the remote build path to any convenient location; the build system does not rely on the default value.

譯：如果您遠(yuǎn)程分發(fā)內(nèi)容，則必須修改遠(yuǎn)程加載路徑以反映您托管遠(yuǎn)程內(nèi)容的URL。您可以將遠(yuǎn)程構(gòu)建路徑設(shè)置為任何方便的位置；構(gòu)建系統(tǒng)不依賴于默認(rèn)值。

Profile variable syntax

All Profile Variables are of type "string". You can assign them a fixed path or value. You can also use two syntax designations to derive all or part of a variable's value from static properties or other variables:

譯：所有Profile變量都是“string”類型。您可以將它們分配為固定路徑或值。您還可以使用兩種語法指定從靜態(tài)屬性或其他變量派生變量值的全部或部分：

• Brackets [ ]: Addressables evaluates entries surrounded by brackets at build time. The entries can be other profile variables (such as [BuildTarget]) or code variables (such as [UnityEditor.EditorUserBuildSettings.activeBuildTarget]). During a build, as it process your groups, Addressables evaluates the strings inside brackets and writes the result into the catalog.

• 譯：方括號(hào)[ ]Addressables在構(gòu)建時(shí)評(píng)估方括號(hào)包圍的條目。條目可以是其他Profile變量（例如[BuildTarget]）或代碼變量（例如[UnityEditor.EditorUserBuildSettings.activeBuildTarget]）。在構(gòu)建過程中，Addressables評(píng)估方括號(hào)中的字符串并將結(jié)果寫入目錄。
  

• Braces { }: Addressables evaluates entries surrounded by braces at runtime. You can use code variables of runtime classes (such as {UnityEngine.AddressableAssets.Addressables.RuntimePath}).譯：花括號(hào){ }：Addressables在運(yùn)行時(shí)評(píng)估花括號(hào)包圍的條目。您可以使用運(yùn)行時(shí)類的代碼變量（例如{UnityEngine.AddressableAssets.Addressables.RuntimePath}）。?

You can use static fields and properties inside either the brackets or braces. The names must be fully qualified and the types must be valid in context. For example, classes in the UnityEditor namespace can't be used at runtime. For more information about namespaces, see Microsoft's?Namespaces?documentation.

譯：您可以在方括號(hào)或花括號(hào)中使用靜態(tài)字段和屬性。名稱必須是完全限定的，類型必須在上下文中有效。例如，UnityEditor命名空間中的類不能在運(yùn)行時(shí)使用。有關(guān)命名空間的更多信息，請(qǐng)參見Microsoft的命名空間文檔。

The code variables used in the default Profile variable settings include:

譯：默認(rèn)Profile變量設(shè)置中使用的代碼變量包括：

• [UnityEditor.EditorUserBuildSettings.activeBuildTarget]譯：

• [UnityEngine.AddressableAssets.Addressables.BuildPath]譯：

• [UnityEngine.AddressableAssets.Addressables.RuntimePath]譯：

For example: A load path of?{MyNamespace.MyClass.MyURL}/content/[BuildTarget]?is set on a group that creates an AssetBundle called "trees.bundle". During the build, the catalog registers the load path for that bundle as?{MyNamespace.MyClass.MyURL}/content/Android/trees.bundle, evaluates?[BuildTarget]?as "Android", and adds the AssetBundle name to the path. At runtime as the Addressables system processes the catalog it evaluates?{MyNamespace.MyClass.MyURL}?to produce the final load path,?http://example.com/content/Android/trees.bundle.

譯：例如：在創(chuàng)建名為“trees.bundle”的AssetBundle的組上設(shè)置了一個(gè)加載路徑{MyNamespace.MyClass.MyURL}/content/[BuildTarget]。在構(gòu)建過程中，目錄將該Bundle的加載路徑注冊(cè)為{MyNamespace.MyClass.MyURL}/content/Android/trees.bundle，將[BuildTarget]評(píng)估為“Android”，并將AssetBundle名稱添加到路徑中。在運(yùn)行時(shí)，當(dāng)Addressables系統(tǒng)處理目錄時(shí)，它評(píng)估{MyNamespace.MyClass.MyURL}以產(chǎn)生最終的加載路徑http://example.com/content/Android/trees.bundle。

NOTE

Referencing a runtime variable in a Profile string doesn't prevent Unity from stripping that variable from your applications’ runtime libraries during the build optimization phase (if nothing else in your code references the same variable). See [Managed code stripping] for more information on how to prevent a class or member from being stripped.

譯：注意：在Profile字符串中引用運(yùn)行時(shí)變量不能防止Unity在構(gòu)建優(yōu)化階段從您的應(yīng)用程序運(yùn)行時(shí)庫中剝離該變量（如果您的代碼中沒有其他引用相同變量）。有關(guān)如何防止類或成員被剝離的更多信息，請(qǐng)參見[Managed code stripping]。