Vixen
02b45cc4
csharp
public sealed class UnregisteredReadException

An importer read a file it never said it depended on.

No guide page documents this yet — the page shows what the code says about itself.

Remarks

This is the single most valuable check in the pipeline, and it is worth understanding why it is an exception rather than a warning. Incrementality is decided entirely by the cache key, and the cache key is built from the dependencies an importer declared. An importer that quietly reads a palette file, a shared configuration, or a sibling texture without declaring it produces an artefact that is correct today and stale for ever: the file it read can change and nothing will re-run it.

That failure does not show up as a crash. It shows up as an artist changing a file, rebuilding, and getting the old result — once, on one machine, in a way nobody can reproduce. Catching it at the moment of the read, with the path in the message, turns a week of that into a line of code.

Fields and properties (2)

  • public VirtualPath Path

    What it read.

  • public string Importer

    Which importer read it.

Methods (1)

  • public UnregisteredReadException(VirtualPath path, string importer)

    An importer read a file it never said it depended on.

Used by (2)

  • DeclaredReadsOnlyProviderVixen.Editor.Assets
  • ImporterTestsVixen.Editor.Assets.Tests