# Asset Lens ## About **Asset Lens** **Asset Lens** is a dependency tracking plugin for UnityEditor that provides additional information such as the number of usage. This plugin is based on pre-cached complementary guid map to trace which asset has dependencies to specific asset. The pain point that mainly considered with Unity is that when we delete an asset, we don't know which asset is using it. ## Requirements - All assets must be serialized as force-text option in ProjectSetting/Editor ### Compatibility We recommend the version `2021.2.0f1` or `latest` because of UI Toolkit(former UI Elements). But plug-in still work well in lower version. > Specifically tested semantic version is :

## Installation

Download with NPM (Unity Package Manager)

[![NPM](https://camo.githubusercontent.com/acb3d21f85b5191f4d0b9966df891872785a990af0cd4890ca56d9bb86cfa55f/68747470733a2f2f6e6f6465692e636f2f6e706d2f636f6d2e63616c63692e61737365746c656e732e706e673f636f6d706163743d74727565)](https://npmjs.org/package/com.calci.assetlens) Replace stable version at version definition in json `x.x.x` example) `"com.calci.assetlens": "0.4.2"` ```json { "dependencies": { "com.calci.assetlens": "x.x.x" } } ``` ```json { "scopedRegistries": [ { "name": "npm", "url": "https://registry.npmjs.org", "scopes": [ "com.calci" ] } ] } ```

Download with OpenUPM

[![openupm](https://camo.githubusercontent.com/ed2f9bb7a48f0b9cec2596bfc584a47dec562715bf07d6882ed020818b2ee742/68747470733a2f2f696d672e736869656c64732e696f2f6e706d2f762f636f6d2e63616c63692e61737365746c656e733f6c6162656c3d6f70656e75706d2672656769737472795f7572693d68747470733a2f2f7061636b6167652e6f70656e75706d2e636f6d)](https://openupm.com/packages/com.calci.assetlens/) ```bash openupm add com.calci.assetlens ```

GitHub Link

```bash https://github.com/seonghwan-dev/assetlens.git#upm ```

## QuickStart When you install plugin, indexing wizard will be shown.

1. Hit the bluish `generate` button and then wait for progress bar. 2. When it finished, wizard will be close automatically. 3. Select any asset you want to see which asset uses that. 4. There is 2 options to show dependencies between assets. 4-1. hit `detail` button on top of the inspector. then editor window will be shown. 4-2. set mouse cursor to the asset in project view and hit right click and select context menu named `Find Reference In Project`.

Show Option Description

- `Indexes by GUID Regular Expression` : find dependencies by GUID Regex or EditorUtility.CollectDependencies. - `Trace scene object hierarchically` : WIP (not in feature currently) - `Inlcude subdirectories of Packages` : Include assets under Packages/ or not. - `Always open when you start a project` : if you want to see this wizard on startup again, disable this option.

## Fundamentals - Create a cache file per a asset file, see also [RefData.cs] - Detect asset changes from `AssetPostprocessor`, see also [AssetLensPostprocessor.cs] - Detect an attempt to delete an asset from `AssetModificationProcessor`, see also [AssetLensModification.cs] ## Features - Display asset usage count in inspector. - Find References In Project ### Reference Viewer Window |before initialize|after initialize| |:---:|:---:| |

| |not available|available to trace dependencies| #### Overview

- `0.2.6` : Indexer version. This represent the which serializer indexes this asset. - `(UnityEngine.GameObject)` : the type of selected asset. prefabs are displayed as GameObject. - `Last Modified : 2021-12-22 PM 8:39:34` : last modified date time of asset. this information is not from cached data but file metadata. - `Dependencies` : list up assets that this asset is using. `Cube 2` includes the material `MAT_Green` in MeshRenderer. - `Used By` : list up assets that uses selected asset. if you delete the `Cube 2` then the instantiated prefab in `SampleScene` will be disconnected and displyed as missing. --- ### Inspector Lens Displays the number of other resources using the selected asset.

- Details : Open Reference Viewer as EditorWindow instantly. - Refresh : Reserialized cached reference data asset. - GUID : Displays the guid of selected asset. onClick events will copy guid to your clipboard. ## Community ### Discord [

](https://discord.gg/h9WPFRNFBY) ## Roadmap Not stable yet, but under development. ### Reference Viewer [x] Reference View for Persistent Assets. [ ] Reference View for Scene Objects. [ ] Sortable Multi-Column viewer. [ ] Dependency graph for Scene Objects. ### Inspector Lens. [x] Display how many assets are related to selected asset at the top of the inspector. [ ] Pop-up window of linked assets such as nested prefab inspector. ### Safe Delete [x] Alert before the asset that is used by other asset will be deleted. [ ] (Experimental) Replace reference during delete asset. (Reference Replacer) ### Build Lens [ ] Find the assets will be included in build [ ] Asset bundle, Addressable, Linked assets with scenes in build setting, resources. --- ## Contributes - Current Editor Version : `2021.2.0f1` - Fork and clone repository. - Edit sources and commit with conventional commits (prefer Commitizen) - Add unit test codes for new feature (Optional) - Create PR. ### Developer mode Select menu in `Help/Asset Lens/Enter Debug Mode` or Add an scripting define symbol `DEBUG_ASSETLENS` at ProjectSettings/Player. ### Edit Languages - Run `Tools/Asset Lens_DEV/Add New Language` to create a new localization profile. - Run `Tools/Asset Lens_DEV/Update Language profiles` to add field after edit `Localize` class. ### Requirements - commitizen - conventional commit log to generate changelog ### Tests must be passed test in 2019.4, 2020.3, 2021.1, 2021.2 [RefData.cs]: https://github.com/seonghwan-dev/AssetLens/blob/main/Packages/com.calci.assetlens/Editor/Reference/Model/RefData.cs [AssetLensPostprocessor.cs]: https://github.com/seonghwan-dev/AssetLens/blob/main/Packages/com.calci.assetlens/Editor/Reference/Callback/ReferencePostprocessor.cs [AssetLensModification.cs]: https://github.com/seonghwan-dev/AssetLens/blob/main/Packages/com.calci.assetlens/Editor/Reference/Callback/ReferenceModification.cs