Changelog

All notable changes to this package will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

[1.17.17] - 2021-04-06

  • Add AssetPostprocessor for AddressableSettings after AssetDatabase is Initialised, if not yet initialised on initial project launch.
  • Removed serialisation of m_MainAsset and m_TargetAsset from Group entries.
  • Fixed a warning "CacheInitialization.CacheInitOp.m_UpdateRequired'' is assigned but its value is never used" when building for platforms that don't have caching enabled
  • A message is printed on successful Addressable build
  • Properly save profile variables when switching profiles
  • Fixed bug where multi-selected Addressable Groups weren't all getting set dirty on an edit.
  • Fixed bug where Fast Mode wasn't respecting Log Runtime Exceptions setting
  • Implicit assets are now taken into account when using applying a label restriction on an asset reference

[1.17.15] - 2021-03-23

  • Fixed FileNotFoundException when using bundle naming mode "Filename" with Unity Cloud Build.
  • Fixed a bug where LoadAssetsAsync handle Completed callback is invoked before all individual Asset callbacks.
  • Added in Asset validator on Editor startup. This ensures that assets deleted when the editor was closed are removed from Addressables.
  • Fixed bug where the current amount of downloaded bytes was not properly updated

[1.17.13] - 2021-03-10

  • Fixed issue when loading a Sprite from a SpriteAtlas from an Addressable folder in AssetDatabase mode.
  • Fixed bug in AssetReference "Make Addressable" functionality (when referencing an asset no longer addressable)
  • Fixed bug with cyclic references in profile variable causing an infinite loop.
  • Fixed bug where cached asset type could get stuck with DefaultType, an invalid Editor type
  • Fixed issue where AsyncOperationHandle.Completed is called after AsyncOperationHandle.Task returns when the handle is already done.
  • Fixed some faulty logic in GetDownloadStatus() when errors occur
  • Removed extra dependencies that were being flagged as modified when running Check For Content Update Restrictions.
  • Fixed a bug where the result of a Task could be inconsistent and return null given certain race conditions
  • Fixed bug where UnloadSceneAsync decreased ref count more than once, and added unload scene to Release if ref count goes to zero
  • Fixed issue where a popup appears when an AddressableAsset file is being modified even if the file is checked out locally.
  • Fixed bug where fast mode wasn't showing events in the profiler
  • Remove check for isUpdating and isCompiling so GetSettings(true) still tries to load the settings when compiling or updating
  • Fixed issue where modified local static bundle dependencies fail to load after updating a previous build. Fix is compatible with older shipped content.

[1.17.6-preview] - 2021-02-23

  • Fixed issue where OnGlobalModification events would be EntryMoved when adding new Entries instead of EntryAdded.
  • Fixed issue where a previously built player fails to load content after running Content Update with missing local bundles
  • Fixed bug where ClearDependencyCacheAsync was throwing invalid handle exceptions if auto releasing the handle
  • Fixed a bug when SerializeReference entries in link.xml for addressable was causing Unity linker to fail.
  • Added results out parameter to AddressableAssetSettings.BuildPlayerContent.

[1.17.5-preview] - 2021-02-08

  • Fixed performance issue when disabling "Addressable" for multiple Assets in the Inspector.
  • Added option to set the build path of addressables_content_state.bin file.
  • The buildlogtep.json file is not generated when building the catalog bundle.
  • Fixed invalid handle exception getting thrown when static AssetReferences were used with domain reload turned off
  • Fixed catalog using invalid load path for Groups built with "bundle naming mode" "Filename".
  • Added option to set custom prefix on the unitybuiltinshader AssetBundle
  • Added documentation explaining how dependencies affect Content Update
  • Sub-assets with arbitrary main type can now be assigned to an asset reference if types match

[1.17.4-preview] - 2021-01-27

  • Removed unnecessary logging when deleting temporary Addressables build data.
  • Added WaitForCompletion() on AsyncOperationHandles. This allows async operation to be executed synchronously
  • Alphanumeric sorting in the group window can be enabled through a setting in the editor preferences
  • Change to set IgnoreFailures with LoadOptions.IgnoreFailures stored in the IResourceLocation.Data if not null
  • Fixed issue when loading legacy Resources from Addressables using the guid when playmode is set to AssetDatabase.
  • Fixed some compile warnings on 2020.2
  • Change to use full path for name of cached catalog.

[1.17.2-preview] - 2021-01-14

  • Add silent fail option to providers to get rid of error when cache not found as expected
  • Hierarchy now fully displayed in search results when 'show groups as hierarchy' and 'hierarchical search' options are enabled
  • OnValidate is now called when an AssetReference changes
  • Fixed bugs in Use Asset Database play mode related to multiple folders with matching addresses
  • Made the following APIs public:
    • ResourceManager.CreateChainOperation
    • AddressablesAnalyzeResultData
    • AddressableAssetSettings.OptimizeCatalogSize
    • BundledAssetGroupSchema.AssetNamingMode
    • BundledAssetGroupSchema.IncludeAddressInCatalog
    • BundledAssetGroupSchema.IncludeGUIDInCatalog
    • BundledAssetGroupSchema.IncludeLabelsInCatalog
    • BundledAssetGroupSchema.InternalIdNamingMode
    • BuildScriptBase.Log
    • ResourceManagerRuntimeData.AddressablesVersion
    • ProjectConfigData
      • ProjectConfigData.ShowSubObjectsInGroupView
      • ProjectConfigData.GenerateBuildLayout
      • ProjectConfigData.ActivePlayModeIndex
      • ProjectConfigData.PostProfilerEvents
      • ProjectConfigData.LocalLoadSpeed
      • ProjectConfigData.RemoteLoadSpeed
      • ProjectConfigData.HierarchicalSearch
      • ProjectConfigData.ShowGroupsAsHierarchy
    • BuildLayoutGenerationTask
    • BuildLayoutGenerationTask.BundleNameRemap
    • ExtractDataTask.BuildContext
    • ContentCatalogData.SetData(IList data, bool optimizeSize)
    • ContentCatalogData(string id) constructor
    • ContentUpdateContext
      • ContentUpdateContext.GuidToPreviousAssetStateMap
      • ContentUpdateContext.IdToCatalogDataEntryMap
      • ContentUpdateContext.BundleToInternalBundleIdMap
      • ContentUpdateContext.WriteData
      • ContentUpdateContext.ContentState
      • ContentUpdateContext.Registry
      • ContentUpdateContext.PreviousAssetStateCarryOver
    • RevertUnchangedAssetsToPreviousAssetState
      • RevertUnchangedAssetsToPreviousAssetState.Run
    • AddressableAssetEntry.GetAssetLoadPath(bool isBundled, HashSet otherLoadPaths)
    • AddressableAssetSettings.IgnoreUnsupportedFilesInBuild

[1.17.0-preview] - 2020-12-13

  • Added option to clear other cahced versions of asset bundles when a new version has been loaded.
  • Added options for internal naming of asset bundles. This will allow for deterministic naming to avoid unintended diffs for content updates.
  • The "Ignore Invalid/Unsupported Files" option is now saved in the settings
  • Fixed issue where Filename only bundle naming schemas were overwriting old bundles prematurely in content update.

[1.16.17] - 2021-02-25

  • Updated group rename logic to support engine AssetDatabase fix. Change should be transparent to users.

[1.16.16] - 2021-01-20

  • Updated dependency versions for testcase fix

[1.16.15] - 2020-12-09

  • Addressables link.xml should now have it's own folder.
  • Fixed an issue where InvalidKeyException was getting thrown when calling GetDownloadSizeAsync on scenes
  • Resources folders inside Unity packages now get added to the Built In Data group
  • Fixed issue where getting selected subasset would cause an error if any subassets' type was null

[1.16.13] - 2020-11-18

  • Added option to invert the display of CheckBundleDupeDependencies Analyze rule
  • Fix GatherEntryLocations for scenes when parameter type is null
  • Added some API docs for RuntimeBuildLog and AnalyzeResultData that were missing.
  • Updated docs to explain the use of profile variables a little better.
  • Added ability to toggle Check Duplicate Bundle Dependencies analyze rule results to be arranged by Group or Asset
  • Allow assets that are inside a com.unity* package to be marked as addressable

[1.16.10] - 2020-11-04

  • Added internal naming option for the Bundled Asset Group Schema. Instead of using the full path, there are options to use the asset guid or the hashcode of the guid. These values are stable and wont change if the asset path changes, reducing the need to rebuild a bundle if paths change but contents do not. The internal ids stored in the content catalog will generally be shorter than asset paths - 32 bytes for the full guid, 8 bytes for the guid hash.
  • Added option to exclude sub catalog entries by file extension
  • Added options to exclude catalog entries for address, labels, and guids
  • Added option to optimize catalog size by extracting duplicated string in urls and file paths
  • Fixed issue where ResourceLocations were returning null for the ResourceType.
  • Added warning to build when an Addressable Group doesn't have any AddressableAssetGroupSchemas
  • Fixed issue where resource folder search was case sensitive for Mac and Linux
  • Fixed issue where warnings were getting logged incorrectly when marking an asset as Addressable using the checkbox in the inspector.
  • Fixed issue where an AssetReference's cached asset is not reset when the underlying asset re-imports.
  • Fixed issue where we were still checking for CRC when a bundle was cached.
  • Fixed bug when using Play Mode Script "Use AssetDatabase (fastest)", and calling Addressables.LoadContentCatalogAsync would fail when it had not been cached.

[1.16.7] - 2020-10-21

  • Fixed issue where InvalidHandle errors were getting thrown if an operation failed with releaseDependenciesOnFailure turned on.
  • Fixed group build and load paths not being saved when editing multiple groups at once
  • Changed Analyze Result data to be cached in the Library. Result data was previously stored in Assets/AddressableAssetsData/AnalyzeData/AnalyzeRuleData.asset. It is now stored in Library/com.unity/addressables/AnalyzeData/AnalyzeRuleData.json. If detected, the Assets - version of the Analyze data will be automatically cleaned up.
  • Fixed line in AsyncOperationHandle documentation that told the wrong API for acquiring a handle
  • Moved the content update documents to their own page. Expanded and clarified information on the update process

[1.16.6] - 2020-09-30

  • Group hierarchy support in groups window by detecting '-' in group name
    • This can be turned on & off in the addressable asset settings inspector: Group Hierarchy with Dashes
    • This only affects the visual display, groups are still stored in the main settings object in a flat list
    • The group name is unaffected. If you name a group "x-y-z" that will be it's name, but, with the option on, it will display as if it was in a folder called "y" that was inside a folder called "x"
  • Fixed fast mode resource locator Keys property to expand all possible keys when accessed. For large projects with many addressable entries and folders, this property may be slow when called for the first time.
  • Added detailed build layout feature. See documentation for details.
  • Fixed issue where assets in Resources weren't show full key in Groups window
  • Fixed issue where loading Addressables from a different project was throwing errors.
  • Fixed WriteSerializedFiles profile event timings when using the detailed build log
  • Selecting multiple Resources and checking "addressable" now display a single popup
  • Fixed CreateArrayResult wouldn't work with classes derived from Object, only the base class, so not for ScriptableObject. Also added test
  • Fixed exceptions not handled while loading ContentCatalog
  • Fixed issue where passing false into releaseDependenciesOnFailure was still releasing dependencies on failure
  • Fixed issue where failed operations could over release their dependencies.
  • Changes to an AssetReference rendered by AssetReferenceDrawer now register as a GUI change
  • Added a checkbox in settings to ignore invalid/unsupported files during build
  • empty folders are cleaned-up when moving multiple resources fails
  • fixed bug where an error would occur when moving resources for paths without extensions
  • Fixed issue where AddressableAsset files locked by version control couldn't be modified.

[1.16.1] - 2020-09-15

  • Fixed bug where some files would not be created in the right folder if the user moved its addressables config folder elsewhere
  • Fixed determanism issue where bundles could have different names after Editor restart
  • Added a blurb to the documentation explaining you have to pack an atlas before the sub objects will show up in the groups window
  • Added "addressable" checkbox when viewing package assets in the Inspector.
  • Fixed issue where GatherAllAssets would not retrieve assets located in package resources folders.
  • Fixed issue where temporary StreamingAssets folder are recreated due to un-deleted meta files during a player build
  • added Equals implementation for typeless AsyncOperationHandle
  • When AssetReference MainAsset changed, reset SubObject
  • resource manager callback leak fixes
  • Packed Playmode build logs regarding BuildTargets now show up in PlayMode
  • Additional Fast Mode optimizations
  • Fixed issue where a released operation was not properly cleaned-up
  • Fixed issue where renaming an AssetGroup with a name that contained a period led to unusual renaming behavior.
  • Removed Analyze Rule "Check Sprite Atlas To...". This check was not actually valid. See "SpriteAtlas dependencies" section of "Memory Management" page in Addressables documentation for more information.
  • UnloadSceneAsync calls that attempt to unload a scene that is still currently loading are now chained with the load operation and will complete after the load is finished.
  • The MaxConcurrentWebRequests exposed on the AddressableAssetSettings object now gets set during runtime initialization
  • Fix performance issues drawing AssetReferences with subassets caused by earlier changes to AssetReferenceDrawer
  • Fixed bug where Addressables.ClearDepenendcyCache wasn't clearing the cache.
  • AssetReferenceUILabelRestriction attribute now works properly on references in nested classes

[1.15.1] - 2020-08-25

  • Change to not allow the same AssetReference to LoadAssetAsync or LoadSceneAsync twice if current handle is valid, instead log an error with note about how to get the valid handle
  • Fixed issue where disabled asset groups data would be included in the addressables_content_state.bin file for the build.
  • Add ability to use custom ResourceManager exception handlers by not overwriting it in InitializeAsync if it is not null
  • Fixed bug where Content Update would not use asset bundle load options for unchanged static remote bundles.
  • Fixed LoadAssetAsync<IList> to return the same set of objects in all play modes. The main asset is always first and hidden objects are ignored.
  • Changed keys parameter for many Addressables APIs to be IEnumerable instead of IList. This allows for passing collections of AssetReferences or AssetLabelReferences directly instead of requiring them to be copied into a new List.
  • Fix bug where lists of AssetReferenceSprites were not displayed or set right by AssetReferenceDrawer. Also fixed where multiple selected objects in project hierarchy couldn't set all lists of AssetReferences elements.
  • Added better error logging when unrecognized file in build.
  • Added error log when building asset bundles during player build.
  • Added "Hide Events" context menu option in Event Viewer
  • Fixed a bug where running the "Check Scene to Addressable Duplicate Dependencies" analyze rule multiple times would cause a duplicate key exception
  • The "Check Scene to Addressable Duplicate Dependencies" analyze rule now only considers scenes that are enabled in the build settings.
  • Fixed a bug where an error would be thrown when Unity 2019 opens and if the hosting window was previously left open
  • Fixed a bug where changes to a service where not applied in the hosting window
  • Fixed a bug where profile selection in the inspector was incorrectly reverted to the default one on domain reload
  • Added documentation for LoadResourceLocationsAsync
  • Added documentation for ResourceManager.ExceptionHandler
  • Added documentation for AddressableAssetSettings.BuildPlayerContent
  • Added documentation for LoadSceneAsync
  • Added ScriptableBuildPipeline Build Callbacks to Addressables Build Scripts
  • Temporary files made during bundled catalog creation are now properly cleaned up
  • Inspector window now opens if it was closed when inspecting addressable settings
  • Fixed bug where AsyncOperation.PercentComplete was returning 100% when IsDone was false before the operation had started.
  • Progress bar is no longer updated for every entry while running Analyze rules for performance purposes.
  • Fixed loading of scenes from scenes list through Addressables. Clears out an InvalidCastException that occured on init.
  • Fixed issue where AssetReference wasn't able to load Addressable assets in folders during AssetDatabase Mode.

[1.14.2] - 2020-08-11

  • Addressables now logs the package version on initialization.
  • Renamed Build Bundle Layout analyze rule to Bundle Layout Preview
  • Marked RawWriteOperation obsolete.
  • Marked SceneRawWriteOperation obsolete.
  • AsyncOperationHandle ClearDependencyCacheAsync has been added. The new API takes an autoReleaseHandle parameter and returns the AsyncOperationHandle.
  • Made the AsyncOperationHandle in AssetReference public.
  • Fixed loading of items from Resources and the built in ScenesList.
  • Improved the performance of loading local content on Android by using LoadFromFileAsync instead of UnityWebRequest. Please note that the bundle compression mode for all local content (on any platform) should be LZ4 or uncompressed to have optimal load performance.
  • Fixed issue where some Addressables settings were not being saved if they were only serialized properties or textfields like 'Build Remote Catalog'
  • Fixed a bug where DiagnosticEvents would be created even if 'Send Profiler Events' was set to false.
  • Refactored the DebugNames of many of the most common implementations of AsyncOperationHandle to improve readability in the event viewer.
  • Events in the Event viewer should now display more accurately in the case of Repeated loads and unloads of the same object.
  • AddressableAssetEntry now overrides ToString() to return the address of the entry
  • Added support for setting multiple assets and subasset references at a time for field in GameObject script in the AssetReference Inspector
  • Improved performance of the GenerateLocationLists task
  • Refactored DiagnosticEventCollector.RegisterEventHandler so that events are always handled in frame order.
  • Fixed bug where the Event Viewer would not work when connected to a standalone player.
  • Added docs describing the process of connecting the Event Viewer to a standalone player.
  • Fixed exception that was getting thrown on Editor restart regarding accessing EditorSettings.enterPlayModeOptionsEnabled during serialization.
  • Added MaxConcurrentWebRequests option to the AddressableAssetSettings.
  • Added GetDownloadStatus method to AsyncOperationHandle. The DownloadStatus struct returned will contain the total number of bytes needed to be downloaded and the current number of bytes already downloaded. Cached AssetBundles will not be included in the count and if everything is cached, the values in the struct will be zero.
  • Added Documentation for the following:
    • InstantiateAsync
    • DownloadDependenciesAsync
    • LoadContentCatalogAsync
    • UpdateCatalogs

[1.13.1] - 2020-07-28

  • Made AssetReferenceT<TObject> be Serializable. This will only matter if using Unity 2020.1 or later.
  • Added AddressableAssetSettings.ContiguousBundles option, which when enabled will improve asset loading times.
    • In testing, performance improvements varied from 10% improvement over all, with improvements up to 50% for large complex assets such as extensive UI prefabs.
  • Add New Build unclickable No Build Script Available option when no valid builder is found and added line in docs to explain what is needed
  • Fixed bug where dragging a non addressable asset from an addressable folder in project viewer to AssetReference field would mark the asset as addressable and put it in the default group
  • Fixed bug where enumerate exception is being thrown when expanding a group folder containing subfolders in the Addressable Groups window.
  • Changed to only ask to convert legacy bundles when AddressableAssetSettings is first created or when selected from the Tools menu
  • Fixed bug where clicking on an AssetReference property won't ping the referenced asset in the Project window.
  • Fixed bug where GetDownloadSizeAsync was returning non-zero values for cached AssetBundles.
  • Removed Event Viewer Record button because it didn't do anything.
  • Fixed bug where changes made through the AddressableAssetProfileSettings API would not be immediately represented in the Profiles Window.
  • Fixed bug where Instantiation and EventCount events in the Event Viewer would not update as expected.
  • Fixed bug where events that occurred immediately after entering play mode would not be properly represented in the Event Viewer.
  • Fixed bug where Instantiation and EventCount events would not display their most recent value when inspected in the Event Viewer.
  • Added Documentation for the following:
    • LoadAssetAsync
    • LoadAssetsAsync
    • InitializeAsync
    • TransformInternalId
  • Fixed bug where changing the value of "Optimize Mesh Data" in PlayerSettings doesn't affect bundle building until the old build cache is deleted.
  • Expanded bundle dependencies so that loaded bundles maintain a reference to all bundle they references. This fixes various bugs when unloading and reloading a bundle that is being referenced by another bundle.

[1.12.0] - 2020-07-14

  • Implemented Undo/Redo capability for the Profiles Window.
  • Fixed bug where the Profiles Window would occasionally throw a NullReferenceException when making a new profile.
  • Added RenameProfile to the AddressableAssetsProfileSettings API
  • Added error messages for failed attempts at renaming a Profile
  • Fixed bug where when there are AssetReferences with the same name but in different Addressable groups only one could be selected in field dropdown
  • Fixed bug surrounding addressable sprites that were also in a SpriteAtlas
  • Fixed bug where loading a scene in a package would only load an empty scene with no contents.
  • Fixed bug where Event Viewer window would always be empty.
  • LinkXmlGenerator moved to the Scriptable Build Pipeline package in the UnityEditor.Build.Pipeline.Utilities namespace.
  • Added documentation to explain how to make packages addressable.
  • Fixed bug where ArgumentException errors are thrown when selecting a prefab from a read-only package.
  • Fixed bug where setting AssetReference property to null wasn't dirtying the asset
  • Fixed a bug where IResourceLocations were returning a false positive on comparison.
  • Added error checking to make sure that an address doesn't have '[]'.

[1.11.2] - 2020-06-15

  • Refactored Play Mode Script for "Use Asset Database" to pull data directly from the settings. This reduces the time needed to enter play mode.
  • Added scrollbar to the Label dropdown
  • Fixed misleading dialog box shown to the user when there are unsaved scenes.
  • Fixed bug where DownloadDependenciesAsync always returns an AsyncOperationHandle with a null task.
  • Fixed bug where AddressableAssetSettings.asset is always being written to disk whenever something is changed in OnPostProcessAllAssets, including asset modified, moved, group created or deleted
  • Revamped Profiles window to a two panel layout.
  • Fixed issue with Profiles window where changes would occasionally not be serialized to the settings asset.
  • Fixed bug where an op with some failed dependencies would never release the ones that had succeeded.
  • Added optional parameter "releaseDependenciesOnFailure" to LoadAssetsAsync to handle the scenario of partial success. This is when there are multiple locations being loaded, and not all succeed. In the partial success scenario:
    • By default, the new parameter is true, and all successful parts will be released. The .Result on the returned handle will be null and Status will be Failed
    • When false, the returned .Result will be a List of size matching the number of matching locations. Any failed location will correlate to null in the List, while successful locations will correlate to valid objects in the List. Status will still be Failed in this scenario.
  • Bundles that fail to load from the cache are now removed from the Cache and will be redownloaded.
  • Added option to disable CRC checks for cached AssetBundles on BundledAssetGroupSchema under Advanced Options.
  • If null is passed into Addressables.UpdateCatalogs(...) for the list of catalogIds, CheckForCatalogUpdates will be called automatically.
  • Added null reference check when running InitializationObjectsOperation to take failed RuntimeData operations into account.
  • Disabled hitting ENTER on an AssetReference inspector to open popup. The drawer does not know which AssetReference to associate the popup should that MonoBehaviour have more than one. So disabling is unfortunately the only safe option.
  • Fixed issue where assets located in subfolders marked as addressable would be added to build content multiple times.
  • Fixed bug where Groups window hierarchical search was not filtering the group contents.
  • Fixed bug with Groups window flat search not sorting.

[1.10.0] - 2020-05-28

  • Fixed hosting service not working for special characters in addressable asset address
  • Fixed bug where tracked scene instance operation handles weren't matching the handles returned to the user.
  • Fixed bug where Sprite Atlas ResourceProvider wasn't getting added to list of ResourceProviders.
  • Fixed bug where pack separately groups were rebuilding all bundles when an asset was added or removed from the group.

[1.9.2] - 2020-05-21

  • Improved the performance of GenerateLocationLists.
  • Fixed AssetReferenceLabelUIRestriction not working for private fields
  • Fixed AssetReferenceDrawer OnGui changing text of static variable GUIContent.none
  • Updated documentation to explain what's happening when DontDestroyOnLoad GameObjects are having their dependencies removed when the scene they originate in is unloaded.
  • Using a more efficient method of gathering the Addressable entries for the AssetReferenceDropdown UI.
  • Fixed bug surrounding how "Use AssetDatabase" build script handles deleted assets.
  • Fixed issue where ContentUpdate was throwing an exception if a dependency wasn't in the previous build.
  • PercentComplete calcluation updates to correctly take progress callbacks on ProviderOperations into account.
  • Added support for Enable Play Mode Options in 2019.3+
  • Fixed issue where diagnostic events are still being sent to the player regardless of the value of "Send Profiler Events".
  • Added error checking to make sure that a group doesn't have both a PlayerDataGroupSchema and a BundledAssetGroupSchema.
  • Fixed issue where InitializationObjects were causing the InitializationOperation to hang.

[1.8.4] - 2020-05-20

  • Taking an updated scriptable build pipeline that reverts a recent hashing change.

[1.8.3] - 2020-04-07

  • Option to disable sprites and subobjects has been added to the Groups window Tools menu. This option is persisted per user, not with the project.
  • Catalog entries for subobjects and sprites are no longer serialized into the catalog. These are generated at runtime with a custom resource locator.
  • Added missing error logs to various failure cases.
  • Fixed subobject parsing to treat anything between the first '[' character and the last ']' as the subobject name instead of the last '[' and the last ']'.
  • Changed the display of AssetReference types in the inspector from a dropdown to look like an object reference.
  • Added the option to compress the local content catalog by packing it in an asset bundle.
  • Added method in settings to retrieve all defined labels.
  • Fixed PercentComplete in ChainOperation
  • Fixed main settings asset getting marked dirty when making builds.
  • Fixed issues with Content Update when entry with dependant entries was modified.
  • Fixed "Unknown Exception" issue caused by releasing certain operation handles too many times.
  • Added link to online documentation in the addressable windows menu.
  • Fixed bug where two assets with the same address packed separately was causing an error.
  • Fixed issue where loading a content catalog multiple times was throwing exceptions.
  • Made it so using the LoadContentCatalogAsync API creates a ResourceLocation that allows those catalogs to be updated properly.
  • Fixed bug where the scene in a recycled InstanceOperation wasn't being cleaned.
  • Fixed bug where an invalid location would be created for assets that weren't in a Resources folder, but were part of a group with the PlayerDataGroupShema.
  • Schema asset file name uses group name instead of GUID. For example: GroupName_SchemaName.asset
  • Fixed text that was being cutoff in the CacheIntializationSettings inspector view.
  • During init, if a remote catalog is expected but not present, this will fail silently. Fixed a bug where that silent failure showed up later as an "unknown error in async operation".
    • if you wish to see a log for the failed catalog retrieval, enable ADDRESSABLES_LOG_ALL as a scripting define symbol.
  • Fixed bug where renaming a class referenced by an AddressableAssetEntry causes an InvalidKeyException.
  • Fixed performance regression in ContentUpdateScript.SaveContentState
  • Fixed performance regression in BuildScriptPackedMode.PostProcessCatalogEntries
  • Updated to scriptable build pipeline 1.7.2 which includes many build optimizations - see SBP changelog for details

[1.7.5] - 2020-03-23

  • Fixed null key exception when building that happened when an invalid asset type is in a resources folder.

[1.7.4] - 2020-03-13

  • Improved building catalog data speed.
  • Various minor optimizations related to handling sub objects.
  • Added progress bar to the catalog generation part of the build process.
  • Gave initialization objects an asynchronous initialization API.
  • Made it so a CacheInitializationObject waits for engine side Caching.ready to be true before completing.
  • Fixed a bug when accessing AssetReferenceT.editorAsset where the Type does not match the Editor Asset type, Such as a subAsset type.
  • Fixed bug where Use Asset Database and Use Existing Build could return a different number of results in LoadAssetAsync<IList<>>
  • Fixed bug where SceneUnload Operations weren't getting properly released in certain circumstances.
  • Fixed UI performance regression when opening the Addressables Group Editor window.
  • Fixed issue where RuntimeKeyIsValid was give a false negative when checking sub-objects.
  • Updating scripting defines to check if caching is enabled.
  • Changed the display of AssetReference types in the inspector from a dropdown to look like an object reference.
  • Prevent assets from being added to read only Addressable groups through the group editor window.
  • Group names can now be searched through the group editor window.
  • Added ability to set variables in AddressablesRuntimeProperties more than once.
  • Fixed missed null check on drag and drop in Group Editor window.
  • Updated Scriptable Build Pipeline dependency to bring in these changes:
    • Updated CompatibilityAssetBundleManifest so hash version is properly serializable.
    • Renamed "Build Cache" options in the Preferences menu to "Scriptable Build Pipeline"
    • Improved performance of the Scriptable Build Pipeline's archiving task.

[1.6.2] - 2020-02-08

  • Checking if Profile Events is enabled on the engine side before running the DiagnosticEventCollector Update.
  • Fixed issue where RuntimeKeyIsValid was give a false negative when checking sub-objects.
  • Fixed Update Previous Build workflow that wasn't re-using previously built Asset Bundle paths when necessary.
  • Updated Scriptable Build Pipeline dependency to bring in these changes:
    • Fixed an issue where texture sources for sprites were not being stripped from the build.
    • Fixed an issue where scene changes weren't getting picked up in a content re-build.
    • Fixed an issue where texture sources for non-packed sprites were being stripped incorrectly.
  • Fixed issue where hosting service ports were changing on assets re-import.
  • Fixed issues with Content Update, including groups that are Packed Separately not updating properly.

[1.6.0] - 2020-01-11

  • Fixed bug where unsubscribing to AsyncOperations events could throw if no subscription happened beforehand.
  • Fixed NullReferenceException when displaying Groups window displaying entries with Missing Script References on SubAssets.
  • Moved AnalyzeWindow.RegisterNewRule to AnalyzeSystem.RegisterNewRule so that the API/logic wouldn't live in GUI code.
  • Fixed bug where scenes in a folder containing "Assets" in the folder name not loadable in "Use Asset Database" mode.
  • InvalidKeyException's message now include the type of the key that caused it, if applicable.
  • Added the ability to select and edit multiple Addressable Groups at the same time.
  • Assigning LocationCount during AddressableAssetBuildResult.CreateResult
  • Fixed issue where groups and schemas were getting deleted on import.
  • Adding dependencies to built in modules to prevent them from being disabled if Addressables is active.
  • Adding scripting define to remove Caching API calls when ENABLE_CACHING is false
  • Added API to get the scene AsyncOperation from ActivateAsync(). Made the previous API, Activate(), obsolete.
  • Fixed bug where the group window wasn't properly refreshed on Analyse fix

[1.5.1] - 2020-01-13

  • Fixed issue where groups and schemas were getting deleted on import.
  • Adding scripting define to remove Caching API calls when ENABLE_CACHING is false

[1.5.0] - 2019-12-09

  • Fixed temporary StreamingAssets files not being removed on a failed player build.
  • Added Bundle Naming option for naming as a hash of the full filename string.
  • Added a delay before unloaded things are removed from Event Viewer graph. Ideally this would track with dependencies, but for now it's simply time based.
  • Fixed ProfileValueReferences not getting set dirty when changed.
  • Added ability for Addressables to handle null references in the Addressables groups list.
    • Null groups should not affect or influence content builds, updates, or Analyze rules.
    • Right clicking on a [Missing Reference] will give you the option to remove all missing references.
  • Fixed issue with Analyze reporting multiple duplicate data for one group.
  • Fixed issue where unloading a scene was throwing an invalid handle error.
  • Added Addressables.ClearDependencyCacheAsync API to clear cached dependent AssetBundles for a given key or list of keys.
  • Added type conversion from AnimatorController to RuntimeAnimatorController.

[1.4.0] - 2019-11-13

  • Added the ability to disable checking for content catalog updates during initialization.
  • Fixed issue where turning off Include in Build in the right circumstances would throw an exception.
  • Made internal classes and members public to support custom build scripts.
  • Exposed Addressables.InstanceProvider to allow for setting up runtime specific data on custom instance providers.
  • Fixed issue with filenames being too long to write to our Temp cache of AssetBundles.
  • Changed ProcessGroup in BuildScriptFastMode to directly create catalog entries from Addressable entries.
  • Added progress bar to Fast Mode when creating content catalog.

[1.3.8] - 2019-11-04

  • Properly suppressing a harmless "Unknown error in AsyncOperation" that has been popping up during init. It had to do with not finding a cached catalog before a catalog had been cached (so error shouldn't happen).
  • Fixed issue with asset hash calcluation for internal asset bundle name when building bundles.
  • Adding option "Unique Bundle IDs" to the General section of the AddressableAssetSettings Inspector.
    • If set, every content build (original or update) will result in asset bundles with more complex internal names. This may result in more bundles being rebuilt, but safer mid-run updates. See docs for more info.
    • This complex internal naming was added to 1.3.3 to support safter Content Catalog updating, but was forced on. It is now optional as there are some drawbacks.

[1.3.5] - 2019-11-01

  • Added documentation about updating Content Catalog at runtime (outside Init). Uses CheckForCatalogUpdates() and UpdateCatalogs().

[1.3.3] - 2019-10-21

  • UI and naming changes
    • "Static true or false" content is now content with an "Update Restriction" of "Cannot Change Post Release" or "Can Change Post Release"
    • "Fast Mode" (play mode) has been renamed "Use Asset Database (faster)"
    • "Virtual Mode" (play mode) has been renamed "Simulate Groups (advanced)"
    • "Packed Mode" (play mode) has been renamed "Use Existing Build (requires built groups)"
    • There is no longer a current "Build Script" (Build Script menu in Addressables window). Instead the script is selected when triggering the build.
    • Schemas have been given display names to be more clear of their intent BundledAssetGroupSchema.
      • BundledAssetGroupSchema displays as "Content Packing & Loading"
        • ContentUpdateGroupSchema displays as "Content Update Restriction"
      • Bundle and Asset providers within schema settings are named more descriptively
    • Profile management is in its own window ("Profiles")
    • Label management is in its own window
    • "Prepare for Content Update" is now under the "Tools" menu (in Addressables window), and is called "Check for Content Update Restriction"
    • "Build for Content Update" is "Update a Previous Build" (still in "Build" menu of Addressables window).
    • "Profiler" window has been renamed "Event Viewer". It's more accurate, and avoids confusion with "Profilers" window.
  • Added additional parameter to AssetReference.LoadSceneAsync method to match Addressables.LoadSceneAsync API
  • Added AssetReference.UnloadScene API
  • Fixed issue with WebGL builds where re-loading the page was causing an exception to get thrown.
  • Fixed Analyze bug where bundle referenced multiple times was flagged as duplicate.
  • Fixed issue with hashing dependencies that led to frequent "INCORRECT HASH: the same hash (hashCode) for different dependency lists:" errors.
  • Update AddressableAssetEntry cached path to new modified asset entry paths.
  • Storing the KeyData string from ContentCatalogData on disk instead of keeping it in memory as it can get quite large.
  • Fixed Custom Hosting Service window so it won't close when focus is lost.
  • Fixed issue with AudioMixerGroups not getting the proper runtime type conversion for the build.
  • Fixed invalid location load path when using "only hash" bundle naming option in 'content packing and loading' schema.
  • Removed content update hash from final AssetBundle filename.
  • Removed exception in Analyze that was triggering when "Fix Selected Rules" was bundling in Un-fixable rules.
  • (SBP) Fixed an edge case where Optimize Mesh would not apply to all meshes in the build.
  • (SBP) Fixed an edge case where Global Usage was not being updated with latest values from Graphics Settings.
  • (SBP) Fixed Scene Bundles not rebuilding when included prefab changes.
  • Added APIs to update content catalog at runtime: CheckForCatalogUpdates() and UpdateCatalogs().

[1.2.4] - 2019-09-13

  • Further improvement to the % complete calculations.
    • Note that this is an average of dependency operations. Meaning a LoadAssetsAsync call will average the download, and the loading progress. DownloadDependenciesAsync currently has one extra op, so the download will crawl to 50%, then jump to done (we will look into removing that). Similarly any op that is called before Addressables init's will jump to 50% once init is done.

[1.2.3] - 2019-09-10

  • Actually "Made ContentUpdateScript.GatherModifiedEntries public."

[1.2.2] - 2019-09-09

  • Made ContentUpdateScript.GatherModifiedEntries public.
  • Added sub-object support to AssetReference. For example, you can now have an AssetReference to a specific sprite within a sprite atlas.
  • Added sub-object support to addresses via [] notation. For example, sprite atlas "myAtlas", would support loading that atlas via that address, or a sprite via "myAtlas[mySprite]"
  • Fixed issue with Content Update workflow. Assets that don't change groups during Content Update now remain in the same bundle.
  • Added funtionality to allow multiple diagnostic callbacks to the ResourceManager.
    • Added error and IResourceLocation to the callback.
  • Added default parameter to DownloadDependenciesAsync to allow auto releasing of the the operation handle on completion.
  • Added memory management documentation.
  • Changed OnlyHash naming option to remove folder structure. This is a workaround to Windows long-file-path issues.
  • Made AssetReference interfaces virtual
  • Fixed hash calculations to avoid collisions
  • Added overload for GetDownloadSizeAsync. The overload accepts a list of keys and calculates their total download size.
  • Improved percent complete calculations for async opertions.

[1.1.10] - 2019-08-28

  • Fix for all files showing "Missing File" in the addressables window.
  • Fix for waiting on a successfully done Task

[1.1.9] - 2019-08-22

  • Fixed drag and drop NullRef in main addressables window.
  • Fixed AudioMixer type assets getting stripped from bundles.
  • Fixed issue where failed async operations weren't getting released from the async operation cache.
  • Fix unloading of scenes so that the dependencies will wait for the unload operation to complete before unloading. This was causing an occasional 1-frame visual glitch during unload.
  • Fixed scenario where AsyncOperation Task fails to complete when AsyncOperation has already completed.
  • Fixed a missed init-log that was stuck always-logging.
  • Fixed issue around assets losing dependencies when unloaded then reloaded. This would manifest most often as sprites losing their texture or prefabs losing their shader/material/texture.
  • Changed checks for determining if a path is remote or not from looking for "://" to looking for starting with "http". "://" is still used to determine if the asset should be loaded via UnityWebRequest or not.
  • Added Analyze Rule to show entire Asset Bundle layout
  • Added progress bars and some optimizations for calculating analyze rules

[1.1.7] - 2019-07-30

  • Fixed chain operation percent complete calculation.
  • Fixed scenario where deleting assets would also delete groups that have similar names.
  • Fix in bundle caching bug surrounding bundles with '.' in their name
  • Significant improvements to the manual pages
  • Made the many init-logs not log unless ADDRESSABLES_LOG_ALL is defined in player settings (other logs always worked this way, init didn't).
  • Prevented NullReferenceException when attempting to delete entries in the Addressables window.
  • Fix for building by label (Bundle Mode = Pack Together By Label)
  • Removed ability to mark editor-only assets as addressable in GUI
  • Better fix to Editor types being added to the build
  • Made BuiltIn Data group read-only by default.
  • Fixed NullRef caused by an invalid (BuildIn Data) group being default during a build.
  • Fixed path where LoadResourceLocationsAsync could still throw an exception with unknown key. Now it should not, and is a safe way to check for valid keys.
    • If Key does not exist but nothing else goes wrong, it will return an empty list and Success state.
  • Fixed NullRef caused when there was a deleted scene in the scenes list.
  • BuildCompression for Addressables can now be driven from the default group. If necessary WebGL builds will fallback to LZ4Runtime and all other build targets will fallback to LZMA.
  • Added options for bundle naming: AppendHash, NoHash, OnlyHash.
    • As a temporary workaround for updating issues, we recommend setting all groups with StaticContent=true to be NoHash. This will make sure the updated catalog still refers to the correct unchanged bundle. An actual fix will be out in a few releases.

[1.1.5] - 2019-07-15

  • Fixed scenario where scene unload simultaneously destroys objects being instantiated in different scenes.
  • Cleaned up SetDirty logic to remove excessive dirtying of assets.

[1.1.4-preview] - 2019-06-19

  • Fixed an issue where Editor only types were being added to the build.

[1.1.3-preview] - 2019-06-17

  • BREAKING CODE CHANGES
    • ReleaseInstance will now return a bool saying if it successfully destroyed the instance. If an instance is passed in that Addressables is unaware of, this will return false (as of 0.8 and earlier, it would print a log, and still destroy the instance). It will no longer destroy unknown instances.
  • Added PrimaryKey to the IResourceLocation. By default, the PrimaryKey will be the address. This allows you to use LoadResourceLocationsAsync and then map the results back to an address.
  • Added ResourceType to IResourceLocation.
    • This allows you to know the type of a location before loading it.
    • Fixes a problem where calling Load*(key) would load all items that matched the key, then filter based on type. Now it will do the filter before loading (after looking up location matches)
    • This also adds a Type input to LoadResourceLocationsAsync. null input will match all types.
  • Safety check AssetReference.Asset to return null if nothing loaded.
  • New rule added to Analyze window - CheckResourcesDupeDependencies - to check for dependencies between addressables and items in Resources
  • Added group rearranging support to the Addressables window.
  • Improved logging when doing a Prepare for Content Update.
  • Added versions of DownloadDependencies to take a list of IResourceLocations or a list of keys with a MergeMode.
  • Fixed scenario where Task completion wouldn't happen if operation was already in a certain state
  • Made LoadResourceLocations no longer throw an exception if given unknown keys. This method is the best way to check if an address exists.
  • Exposed AnalyzeRule class to support creating custom rules for Addressables analysis.
  • Fixed some issues surrounding loading scenes in build scenes list via Addressables
  • Removed using alias directives defined in global space.
  • Proper disposal of DiagnosticEventCollector and DelayedActionManager when application closes.
  • Added support for loading named sub-objects via an "address.name" pattern. So a sprite named "trees" with sub-sprites, could be loaded via LoadAssetAsync("trees.trees_0").
  • Known issue: loading IList from a Texture2D or IList from an fbx will crash the player. The workaround for now is to load items by name as mentioned just above. Engine fix for this is on its way in.

[0.8.6-preview] - 2019-05-14

  • Fix to make UnloadSceneAsync(SceneInstance) actually unload the scene.

[0.8.3-preview] - 2019-05-08

  • BREAKING CODE CHANGES
    • Chagned all asynchronous methods to include the word Async in method name. This fits better with Unity's history and convention. They should auto upgrade without actually breaking your game.
    • Moved AsyncOperationHandle inside namespace UnityEngine.ResourceManagement
  • Addressable Analyze changes:
    • Analyze has been moved into it's own window.
    • CheckSceneDupeDependencies Analyze rule has been added.
    • CheckDupeDependencies has been renamed into CheckBundleDupeDependencies.
    • Analyze Rule operations for individuals or specific sets of Analyze Rules has been added via AnalyzeRule selections.

[0.7.4-preview] - 2019-04-19

  • Removed support for .NET 3.x as it is deprecated for Unity in general.
  • Replaced IAsyncOperation with AsyncOperationHandle.
    • Once the asset is no longer needed, the user can call Addressables.Release, passing in either the handle, or the result the handle provided.
  • Exposed AsyncOperationBase for creating custom operations
    • These operations must be started by ResourceManager.StartOperation
  • Replaced IDataBuilderContext and it's inherited classes with simpler AddressablesDataBuilderInput. This class is fed into all IDataBuilder.BuildData calls.
  • Fixed Nintendo Switch and PlayStation4 support.
  • Simplified the IResourceProvider interface.
  • Refactored build script interface. Made BuildScriptBase and the provided concrete versions easier to inherit from.
  • Removed DelayedActionManager.
  • Removed ISceneProvider. Users can implement custom scene loading using a custom AsyncOperationBase.
  • Removed optional LRU caching of Assets and Bundles.
  • Addressables Profiler now tracks all active async operations
  • AssetBundles targetting StreamingAssets (by using the profile variable [UnityEngine.AddressableAssets.Addressables.BuildPath] now build to the Library instead of StreamingAssets. During the player build, these files are copied into StreamingAssets, then after the build, the copies are deleted. They are also built into platform specific folders (so building for a second platform will not overwrite data from a first build). We recommend deleting anything in Assets/StreamingAssets/aa.
  • The addressables_content_state.bin is built into a platform specific folder within Assets/AddressableAssetsData/. We recommend deleting the addressables_content_state.bin in Assets/AddressableAssetsData to avoid future confusion.
  • ScriptableBuildPipeline now purges stale data from its cache in the background after each build.
  • Disabled Addressables automatic initialization. It will now initialize itself upon the first call into it (such as Load or Instantiate). To Initialize on startup instead of first use, call Addressables.Initialize().
  • Optimized performance around instantiation and general garbage generation.
  • Added per-group bundle compression settings.
  • Fixes to AssetReference drawers.
  • Improved the group template system for creating better defined asset groups.
  • Fixed bug in bundle caching that caused GetDownloadSize to report incorrectly
  • Cleaned up Load/Release calls to make sure all releases could take either the handle returned by Load, or the handle.Result.
  • Added editor-only analytics (nothing added in runtime). If you have Analytics disabled in your project nothing will be reported. Currently only run when you build addressables, it includes data such as Addressables version and Build Script name.
  • Fixed null ref issue when cleaning all the data builders
  • KNOWN ISSUE: there is still an occasional issue with code stripping on iOS. If you run into iOS issues, try turning stripping off for now.

[0.6.8-preview] - 2019-03-25

  • fixed Build For Content Update to no longer delete everything it built.

[0.6.7-preview] - 2019-03-07

  • Fix for iOS and Android. Symptom was NullReferenceException dring startup resulting in nothing working. Fix requires re-running Build Player Content

[0.6.6-preview] - 2019-03-05

  • BREAKING CODE CHANGES
    • to ease code navigation, we have added several layers of namespace to the code.
    • All Instantiate API calls (Addressables and AssetReference) have been changed to only work with GameObjects.
    • any hardcoded profile path to com.unity.addressables (specifically LocalLoadPath, RemoteLoadPath, etc) should use UnityEngine.AddressableAssets.Addressables.RuntimePath instead. For build paths, replace Assets/StreamingAssets/com.unity.addressables/[BuildTarget] with [UnityEngine.AddressableAssets.Addressables.BuildPath]/[BuildTarget] For load paths, replace Assets/StreamingAssets/com.unity.addressables/[BuildTarget] with {UnityEngine.AddressableAssets.Addressables.RuntimePath}/[BuildTarget]
    • We have removed attribute AssetReferenceTypeRestriction as it is cleaner to enforce type via generics
    • Attribute AssetReferenceLabelRestriction is renamed to AssetReferenceUILabelRestriction and must be surrounded by #if UNITY_EDITOR in your game code, to enforce it's editor-only capability
    • Modifications to IResourceProvider API.
    • Removed PreloadDependencies API. Instead use DownloadDependencies
  • Content Update calculation has changed, this will invalide previously generated addressables_content_state.bin files.
    • Some types for content update were made private as a result of the above change.
  • Minimum Unity version is now 2018.3 to address a build-time bug with progressive lightmapper.
  • Moved all of the Resource Manager package to be contained within Addressables (no longer a stand alone package). No code change implications.
  • Change to content catalog building:
    • Previous model built one catalog per group, wherever that group built it's data.
    • New model builds one catalog locally, and optionally one "remote". Remote location is set on the top level AddressableAssetSettings object.
    • Loading will now always check if remote has changes (if remote exists), and use local otherwise (or cached version of remote).
  • LoadScene API now takes the LoadSceneParameters that were added to the engine in 2018.2
  • Exposed AddressablesBuildDataBuilderContext.BuildScriptContextConstants for use in build scripts.
  • Refactored AddressablesBuildDataBuilderContext.GetValue to take default parameter.
  • Fixed Scene asset path to be consistent between different play modes in the catalog data.
  • Exposed the various IDataBuilder implementations as public classes.
  • Exposed asset and bundle provider types for BundledAssetGroupSchema.
  • Fixed several bugs when loading catalogs from other projects.
  • Added provider suffix to Initialization operation and Addressables.LoadCatalogsFromRuntimeData API to better support overriding providers.
  • Exposed CachedProvider options in BundledAssetGroupSchema. Each unique set of parameters will generate a separate provider. There is also an option to force a group to have its own providers.
  • Added IEnumerable Keys property to IResourceLocator interface.
  • Exposed InitializationOperation as public API.
  • Added BuildTarget to ResourceManagerRuntimeData. This is used to check if the generated player content was built with the same build target as the player or the editor when entering play mode.
  • Removed warnings generated from not finding the cached catalog hash files, which is not an error.
  • Fixed bug where scenes were not unloading.
  • Fixed GUI exception thrown in group inspector.
  • Fixed error case where an asset (usually a bundle) was loaded multiple times as different types (object and AssetBundle).
  • Fixed divide by zero bug when computing load percent of simulated asset bundles.
  • AddressableAssetBuildResult.CreateResult now takes the settingsPath as a parameter to pass this to the result.
  • Fix AssetReference GUI when the AssetReference is inside an array of classes, part of a SerializedObject, or private.
  • Fix AssetReferenceSprite to properly support sprites (as opposed to Texture2D's).
  • Fixed bug involving scenes being repeatedly added to the build scenes list.
  • Removed deprecated and obsolete code. If you are upgrading from a very old version of Addressables, please update to 0.5.3-preview first.
  • Removed the default MergeMode on LoadAssets calls to enforce explicit behavior.
  • Added IAsyncOperation GetDownloadSize(object key) API to compute remaining data needed to load an asset
  • Fixed assets being stuck in a read-only state in UI
  • Unified asset moving API to clean up public interface
  • Added PlayerVersion override to AddressableAssetSettings
  • Ensure UI cannot show invalide assets (such as .cs files)
  • Renamed Addressables.LoadAddtionalCatalogs to Addressables.LoadContentCatalog and now it takes the path of the catalog instead of the settings file
  • Moved provider information from ResourceManagerRuntimeDate into ContentCatalogData
  • Updating ResourceManager to be a non-static class
  • Fixed bugs surrounding assets moving in or out of Resources (outside Addressables UI)
  • Fixed the AssetReference dropdown to properly filter valid assets (no Resources and honoring type or label limitations).
  • Fixed AssetReferences to handle assets inside folders marked as Addressable.
  • Added attribute AssetReferenceUIRestriction to support user-created AssetReference restrictions (they are only enforced in UI, for dropdown and drag&drop)
  • Changed addressables_content_state.bin to only build to the folder containing the AddressableAssetSettings object (Assets/AddressableAssetsData/ in most cases)
  • Fixed issue where the wrong scene would sometimes be open post-build.

[0.5.3-preview] - 2018-12-19

  • fixed upgrade bug from 0.4.x or lower to 0.5.x or higher. During upgrade, the "Packed Mode" option was removed from play mode. Now it's back and upgrades are safe from 0.4.x or from 0.5.x to 0.5.3

[0.5.2-preview] - 2018-12-14

  • IMPORTANT CHANGE TO BUILDING
    • We have disabled automatic asset bundle building. That used to happen when you built the player, or entered play mode in "packed mode". This is no longer the case. You must now select "Build->Build Player Content" from the Addressables window, or call AddressableAssetSettings.BuildPlayerContent(). We did this because we determined that automatic building did not scale well at all for large projects.
  • fixed regression loading local bundles
  • Added Addressables.DownloadDependencies() interface
  • fixes for Nintendo Switch support
  • Fixed issues around referencing Addressables during an Awake() call
  • Code refactor and naming convention fixes
  • Cleaned up missing docs
  • Content update now handles not having and groups marked as Static Content
  • Fixed errors when browing for the addressables_content_state.bin and cancelling
  • Moved addressables_content_state.bin to be generated into the addressables settings folder
  • Changed some exceptions when releasing null bundles to warnings to handle the case of releasing a failed download operation
  • Separated hash and crc options to allow them to be used independently in asset bundle loads.
  • Use CRC in AssetBundle.LoadFromFileAsync calls if specified
  • Always include AssetBundleRequestOptions for asset bundle locations

[0.4.8-preview] - 2018-10-22

  • Added all referenced types in asset bundles to link.xml to prevent them from being stripped in IL2CPP builds

[0.4.7-preview] - 2018-10-20

  • updated Scriptable Build Pipeline version in dependencies

[0.4.6-preview] - 2018-10-16

  • MINIMUM RECOMMENDED VERSION - 2018.2.11+
    • We have re-enabled the addressables checkbox. Versions of 2018.2 older than the .11 release will work unless you attempt to view the Animation Import Settings inspector. If you do have animations you need to inspect, use .11+. If you do not, use any official release version of 2018.2.
  • refactored the way IResourceProviders are initialized in the player - serialized data is constructed at runtime to control how the providers are configured
  • added readonly custom inspector for AddressableAssetEntryCollection
  • AssetReference now stores the loaded asset which can be accessed via the Asset property after LoadAsset completes. ReleaseAsset has been modified to not need the asset passed in (the old version is marked obsolete]
  • fixed profiler details view not updating when a mouse drag is completed
  • fixed null-ref when moving Resources to Addressables when there are no Resources
  • blocked moving EditorSceneList within GUI
  • fixed cap on address name length
  • fixed workflows of marking Resources as addressable and moving an addressable into Resources.
  • fixed issue where AssetReferenceDrawer did not mark scene as dirty when changed.
  • added Hosting Services feature; provides extensible framework and implementation for serving packed content to player builds from the Editor
  • replaced addressables buildscript with an interface based system. IDataBuilder class is now used to define builders of specific types of data. The Addressables settings object contains a collection of data builders and uses these to create player and play mode data. Users can implemented custom data builders to control the build process.
  • replaced AssetGroupProcessors with a collection of AssetGroupSchema objects. The difference is that the schema objects only contain data and groups can have multiple schemas. The logic for processing groups now resides in the build script and uses the schemas as data sources and filters for how to build.
  • Added Initialization objects that can be created during the build to run during addressables initialization
  • Implemented Caching API initialization with initialization objects
  • Changed some API and tests to work with 2019.x
  • fixed how AssetReference's draw when within lists, arrays, or contained classes
  • Fixed the workflow of scenes moving in and out of the Editor Build Settings Scene list.
  • Removed "Preview" and added "Analyze".
    • The new system runs any rules it knows about.
    • Currently this is one rule that is manually set up in code. Future work will have additional rules, and expose the ability to create/add user- or project-specific rules
    • This process can be slow, as it runs most of a build to get accurate data.
    • Within the Analyze window there is a "fix" button that allows each rule to fix any issues if the rule knows how.
    • The current rule is a "check duplicate asset" rule. This looks for assets that are pulled into multiple asset bundles due to dependency calculations. The way it fixes things is to move all of those into a newly created group.
  • Added option to toggle logging of all exceptions within the Resource Manager
  • Refactored initialization of the addressable asset settings to prevent it getting into a bad state.

[0.3.5-preview] - 2018-09-05

  • implemented content update workflow. Added a dropdown to the "Build" button on main window's toolbar.
    • "Build/Prepare for Content Update" will detect assets in locked bundles (bundles flagged as static, by default all local bundles).
    • "Build/Build for Content Update" will build assets with a catalog that is compatible with a previously released player.
    • "Build/Build Packed Data" will build in the same way entering play mode in PackedMode would.
    • implemented Clean Build. "Build/Clean/*" will clear out build caches.
  • cleaned up streaming assets folder better after build
  • moved asset group data into separate assets in order to better support version control
  • fixed bug when canceling export of entries to an AssetEntryCollection
  • fixed several bugs related to caching packed bundles in play mode
  • added option to build settings to control whether streaming assets is cleared after each build
  • enabled CreateBuiltInShadersBundle task in build and preview
  • fixed bug in AA initialization that was cuasing tests to fail when AA is not being used.
  • fixed bug where toggling "send profiler events" would have no effect in some situations
  • default the first 2 converted groups to have StaticContent set to true
  • UI Redesign
    • Moved most data settings onto actual assets. AddressableAssetSettings and AddressableAssetGroup assets.
      • AddressableAssetSettings asset has "Send Profile Events", list of groups, labels, and profiles
      • AddressableAssetGroup assets have all data associated with that group (such as BuildPath)
    • Made "preview" be a sub-section within the Addressables window.
    • The "Default" group can now be set with a right-click in the Addressables window.
    • Set play mode from "Mode" dropdown on main window's toolbar.
    • Moved "Hierarchical Search" option onto magnifying glass of search bar. Removed now empty settings cog button.
  • fixed issue when packing groups into seperate bundles generated duplicate asset bundle names, leading to an error being thrown during build
  • added support for disabling the automatic initialization of the addressables system at runtime via a script define: ADDRESSABLES_DISABLE_AUTO_INITIALIZATION
  • added API to create AssetReference from AddressableAssetSettings object in order to create an entry if it does not exist.
  • moving resource profiler from the ResourceManager package to the Addressables package
  • fixed bug where UnloadScene operation never entered Done state or called callback.
  • fixed loading of additonal catalogs. The API has changed to Addressables.LoadCatalogsFromRuntimeData.
  • fixed bug in InitializationOperation where content catalogs were not found.
  • changed content update workflow to browse for cachedata.bin file instead of folder
  • fixed exception thrown when creating a group and using .NET 4.x
  • fixed bugs surrounding a project without addressables data.
    • AssetLabelReference inspector rendering
    • AssetReference drag and drop
  • fixed profiler details view not updating when a mouse drag is completed
  • fixes surrounding the stability of interacting with the "default" group.
  • Added docs for the Content Update flow.
  • Adjusted UI slightly so single-clicking groups shows their inspector.
  • removed not-helpful "Build/Build Packed Data" item from menu.
  • fixed bug where you could no longer create groups, and group assets were not named correctly

[0.2.2-preview] - 2018-08-08

  • disabled asset inspector gui for addressables checkbox due to editor bug

[0.2.1-preview] - 2018-07-26

  • smoothed transition from 0.1.x data to 0.2.x data
  • added checks for adding duplicate scenes into the EditorBuildSettings.scenes list
  • fixed exception when deleting group via delete key, added confirmation to all deletions

[0.2.0-preview] - 2018-07-23

  • Fixed bundles being built with default compression instead of compression from settings
  • Fixed bug in tracking loaded assets resulting in not being able to release them properly
  • Added Key property to IAsyncOperation to allow for retrieval of key that requested the operation
  • Added AssetLabelReference to provide inspector UI for selecting the string name of a label
  • Fixed dragging from Resources to a group.
  • Added ability to re-initialize Addressables with multiple runtime data paths. This is to support split projects.
  • Clean up StreamingAssets folder after build/play mode

[0.1.2-preview] - 2018-06-11

  • fixed Application.streamingAssetsPath being stripped in IL2CPP platforms

[0.1.1-preview] - 2018-06-07

  • MIN VERSION NOW 2018.2.0b6
  • updated dependency

[0.1.0-preview] - 2018-06-05

  • MIN VERSION NOW 2018.2.0b6
  • added better checks for detecting modified assets in order to invalidate cache
  • fixed preview window showing scenes in wrong bundle
  • exclude current processor type from conversion context menu
  • fixed exception when right clicking asset groups
  • added support for adding extra data to resource locations
  • made Addressables.ReleaseInstance destroy even non-addressable assets.
  • append hash to all bundle names
  • pass crc & hash to bundle provider
  • clear catalog cache whenever packed mode content is rebuilt

[0.0.27-preview] - 2018-05-31

  • fixed ResourceManager initialization to work as the stand-alone player

[0.0.26-preview] - 2018-05-24

  • re-added Instantiate(AssetReference) for the sake of backwards compatability.

[0.0.25-preview] - 2018-05-23

  • workaround for engine bug surrounding shader build. Fix to engine is on it's way in.

[0.0.24-preview] - 2018-05-21

  • minor bug fix

[0.0.23-preview] - 2018-05-21

  • new format for content catalogs
  • detects changes in project and invalidates cached runtime data and catalogs
  • data is not copied into StreamingAssets folder when running fast or virtual mode
  • added external AssetEntry collections for use by packages
  • modifying large number of asset entries on the UI is no longer unresponsive
  • added an option to search the asset list in a hierarchical fashion. Helps track down which group an asset is in.
  • many small bug fixes.

[0.0.22-preview] - 2018-05-03

  • dependency update.

[0.0.21-preview] - 2018-05-03

  • fixed build-time object deletion bug.

[0.0.20-preview] - 2018-05-02

  • Added support for extracting Built-In Shaders to a common bundle
  • Added build task for generating extra data for sprite loading edge case
  • fix build related bugs introduced in 0.0.19.

[0.0.19-preview] - 2018-05-01

  • Complete UI rework.
    • Moved all functionality to one tab
    • Preview is a toggle to view in-line.
    • Profiles are edied from second window (this part is somewhat placeholder pending a better setup)
  • Dependency updates
  • Minor cleanup to build scripts

[0.0.18-preview] - 2018-04-13

  • minor bug fixes
  • exposed memory cache parameters to build settings, changed defaults to use LRU and timed releases to make preloading dependencies more effective

[0.0.17-preview] - 2018-04-13

  • added tests
  • fixed bugs
  • major API rewrite
    • all API that deals with addresses or keys have been moved to Addressables
    • LoadDependencies APIs moved to Addressables
    • Async suffix removed from all Load APIs

[0.0.16-preview] - 2018-04-04

  • added BuildResult and callback for BuildScript
  • added validation of instance to scene and scene to instance maps to help debug instances that change scenes and have not been updated
  • added ResourceManager.RecordInstanceSceneChange() method to allow RM to track when an instance is moved to another scene
  • moved variable expansion of location data to startup

[0.0.15-preview] - 2018-03-28

  • fixed scene unloading
  • release all instances when a scene unloads that contains unreleased instances
  • fixed overflow error in virtual mode load speeds

[0.0.14-preview] - 2018-03-20

  • Updated dependencies

[0.0.12-preview] - 2018-03-20

  • Minor UI updates
  • doc updates
  • fixed bug involving caching of "all assets"
  • improved error checking & logging
  • minor bug fixes.

[0.0.8-preview] - 2018-02-08

  • Initial submission for package distribution