By default, the Addressables system manages the catalog automatically at runtime. If you built your application with a remote catalog, the Addressables system automatically checks to see if you have uploaded a new catalog, and, if so, downloads the new version and loads it into memory.

譯：在運行時管理目錄 默認情況下，Addressables系統(tǒng)會在運行時自動管理目錄。如果你使用遠程目錄構(gòu)建了應(yīng)用程序，Addressables系統(tǒng)會自動檢查是否上傳了新的目錄，如果有，就會下載新版本并加載到內(nèi)存中。

You can load additional catalogs at runtime. For example, you could load a catalog produced by a separate, compatible project to load Addressable assets built by that project. (See?Loading Content from Multiple Projects.)

譯：你可以在運行時加載額外的目錄。例如，你可以加載由另一個兼容項目生成的目錄，以加載該項目構(gòu)建的Addressable資源。（請參閱從多個項目加載內(nèi)容。）

If you want to change the default catalog update behavior of the Addressables system, you can turn off the automatic check and check for updates manually. See?Updating catalogs.

譯：如果你想改變Addressables系統(tǒng)的默認目錄更新行為，你可以關(guān)閉自動檢查并手動檢查更新。請參閱更新目錄。

Loading additional catalogs

Use?Addressables.LoadContentCatalogAsync?to load additional content catalogs, either from your hosting service or from the local file system. All that is required is for you to supply the location of the catalog you wish to load. After the operation to load the catalog is finished, you can call any Addressables loading functions using the keys in the new catalog.

譯：加載額外的目錄 使用Addressables.LoadContentCatalogAsync來加載額外的內(nèi)容目錄，可以來自你的托管服務(wù)或本地文件系統(tǒng)。你只需要提供要加載的目錄位置即可。加載目錄的操作完成后，你可以使用新目錄中的鍵調(diào)用任何Addressables加載函數(shù)。

If you provide the catalog hash file at the same URL as the catalog, Addressables caches the secondary catalog. When the client application loads the catalog in the future, it only downloads a new version of the catalog if the hash changes.

譯：如果你在與目錄相同的URL上提供了目錄哈希文件，Addressables會緩存次要目錄。當(dāng)客戶端應(yīng)用程序在將來加載目錄時，僅在哈希值更改時才會下載目錄的新版本。

NOTE

• The hash file does need to be in the same location and have the same name as your catalog. The only difference to the path should be the extension.譯：哈希文件需要與你的目錄位于相同的位置并具有相同的名稱。路徑的唯一差異應(yīng)該是擴展名。

• LoadContentCatalogAsync comes with a parameter autoReleaseHandle. In order for the system to download a new remote catalog, any prior calls to LoadContentCatalogAsync that point to the catalog you're attempting to load need to be released. Otherwise, the system picks up the Content Catalog load operation from our operation cache. If the cached operation is picked up, the new remote catalog is not downloaded. If set to true, the parameter autoReleaseHandle can ensure that the operation doesn't stick around in our operation cache after completing.譯：LoadContentCatalogAsync帶有參數(shù)autoReleaseHandle。為了使系統(tǒng)下載新的遠程目錄，任何指向你要加載的目錄的之前的LoadContentCatalogAsync調(diào)用都需要被釋放。否則，系統(tǒng)會從我們的操作緩存中獲取Content Catalog加載操作。如果選擇了緩存操作，則不會下載新的遠程目錄。如果設(shè)置為true，參數(shù)autoReleaseHandle可以確保操作在完成后不會留在我們的操作緩存中。

Once you load a catalog, you cannot unload it. You can, however, update a loaded catalog. You must release the operation handle for the operation that loaded the catalog before updating a catalog. See?Updating catalogs?for more information.

譯：一旦你加載了目錄，就無法卸載它。但是，你可以更新已加載的目錄。在更新目錄之前，必須釋放加載目錄的操作句柄。請參閱更新目錄以獲取更多信息。

In general, there is no reason to hold on to the operation handle after loading a catalog. You can release it automatically by setting the?autoReleaseHandle?parameter to true when loading a catalog, as shown in the following example:

譯：通常情況下，加載目錄后沒有保留操作句柄的原因。你可以在加載目錄時將autoReleaseHandle參數(shù)設(shè)置為true以自動釋放它，如以下示例所示：

NOTE

You can use the?Catalog Download Timeout?property of your Addressables settings to specify a timeout for downloading catalogs.

譯：你可以使用Addressables設(shè)置的目錄下載超時屬性來指定下載目錄的超時時間。

Updating catalogs

If the catalog hash file is available, Addressables checks the hash when loading a catalog to determine if the version at the provided URL is more recent than the cached version of the catalog. You can turn off the default catalog check, if desired, and call the?Addressables.UpdateCatalogs?function when you want to update the catalog. If you loaded a catalog manually with?LoadContentCatalogAsync, you must release the operation handle before you can update the catalog.

譯：更新目錄 如果目錄哈希文件可用，Addressables會在加載目錄時檢查哈希值，以確定提供的URL上的版本是否比目錄的緩存版本更新。如果需要，你可以關(guān)閉默認目錄檢查，并在想要更新目錄時調(diào)用Addressables.UpdateCatalogs函數(shù)。如果你使用LoadContentCatalogAsync手動加載了目錄，則必須在更新目錄之前釋放操作句柄。

When you call the UpdateCatalog function, all other Addressable requests are blocked until the operation is finished. You can release the operation handle returned by UpdateCatalogs immediately after the operation finishes (or set the?autoRelease?parameter to true).

譯：當(dāng)您調(diào)用UpdateCatalog函數(shù)時，直到操作完成之前，所有其他的Addressable請求都會被阻塞。您可以在操作完成后立即釋放UpdateCatalogs返回的操作句柄（或?qū)utoRelease參數(shù)設(shè)置為true）。

If you call UpdateCatalog without providing a list of catalogs, Addressables checks all of the currently loaded catalogs for updates.

譯：如果調(diào)用UpdateCatalog而不提供目錄列表，則Addressables將檢查所有當(dāng)前加載的目錄以獲取更新。

You can also call?Addressables.CheckForCatalogUpdates?directly to get the list of catalogs that have updates and then perform the update:

譯：您也可以直接調(diào)用Addressables.CheckForCatalogUpdates來獲取有更新的目錄列表，然后執(zhí)行更新：

IMPORTANT

If you update a catalog when you have already loaded content from the related AssetBundles, you can encounter conflicts between the loaded AssetBundles and the updated versions. You can enable the?Unique Bundle Ids?option in your Addressable settings to eliminate the possibility of bundle ID collisions at runtime. However, enabling this option also means that more AssetBundles must typically be rebuilt when you perform a content update. See?Content update builds?for more information. Another option is to first unload any content and AssetBundles that must be updated, which can be a slow operation.

譯：重要提示：如果在已加載相關(guān)AssetBundles的情況下更新目錄，則可能會遇到已加載的AssetBundles和已更新版本之間的沖突。您可以在Addressable設(shè)置中啟用唯一Bundle Ids選項，以消除運行時bundle ID沖突的可能性。但是，啟用此選項也意味著在執(zhí)行內(nèi)容更新時通常必須重新構(gòu)建更多的AssetBundles。有關(guān)詳細信息，請參見內(nèi)容更新構(gòu)建。另一個選擇是首先卸載必須更新的任何內(nèi)容和AssetBundles，這可能是一個緩慢的操作。