Version: 2021.1
LanguageEnglish
  • C#

CollectImportedDependenciesAttribute

class in UnityEditor.AssetImporters

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Description

Use this method attribute to specify which methods declare dependancies on imported assets. The methods are called by AssetDatabase during import.

The AssetDatabase imports the dependencies declared in methods with this attribute before importing the dependent assets. This also re-imports the dependent asset whenever the dependency asset changes. Use this declared dependency to safely load dependancies in AssetPostprocessor callbacks.

This example shows how you can declare a dependency between two prefabs imported by the ModelImporter and use them in an AssetPostprocessor.

using UnityEditor;
using UnityEditor.AssetImporters;
using UnityEngine;

public class ProceduralParentPostprocessor : AssetPostprocessor { private const string s_DependentPath = "Assets/ProceduralPrefab.fbx"; private const string s_DependencyPath = "Assets/DependencyPrefab.fbx";

[CollectImportedDependencies(typeof(ModelImporter), 1)] public static string[] CollectImportedDependenciesForModelImporter(string assetPath) { if (assetPath.Equals(s_DependentPath)) return new[] { s_DependencyPath };

return null; }

void OnPostprocessMeshHierarchy(GameObject root) { if (root.name == "ProceduralPrefabRoot") { // Add a new child game object var go = AssetDatabase.LoadMainAssetAtPath(s_DependencyPath) as GameObject; Object.Instantiate(go, root.transform, true); } } }

Note: The attribute supports only native importer types with AssetPostprocessor callbacks: ModelImporter, TextureImporter, AudioImporter, and SpeedTreeImporter.

Properties

importerTypeThe type of the importer for which the imported dependency getter is declared.
versionThe version of the imported dependency getter.

Constructors

CollectImportedDependenciesAttributeUse the CollectImportedDependencies attribute to declare getters for imported dependencies.