build library Null safety
Classes
- AssetId
- Identifies an asset within a package.
- AssetReader
- Standard interface for reading an asset within in a package. [...]
- AssetWriter
- Standard interface for writing an asset into a package's outputs.
- AssetWriterSpy
- An AssetWriter which tracks all assetsWritten during its lifetime.
- Builder
- The basic builder class, used to build new files from existing ones.
- BuilderOptions
- BuildStep
- A single step in a build process. [...]
- FileDeletingBuilder
- A PostProcessBuilder which can be configured to consume any input extensions and always deletes it primary input.
- MultiPackageAssetReader
-
The same as an
AssetReader
, except thatfindAssets
takes an optional argumentpackage
which allows you to glob any package. [...] - MultiplexingBuilder
- A Builder that runs multiple delegate builders asynchronously. [...]
- PostProcessBuilder
- A builder which runs in a special phase at the end of the build. [...]
- PostProcessBuildStep
- A simplified BuildStep which can only read its primary input, and can't get a Resolver or any Resources, at least for now.
- ReleasableResolver
- A resolver that should be manually released at the end of a build step.
- Resolver
- Standard interface for resolving Dart source code as part of a build.
- Resolvers
- A factory that returns a resolver for a given BuildStep.
-
Resource<
T> - A Resource encapsulates the logic for creating and disposing of some expensive object which has a lifecycle. [...]
- ResourceManager
- Manages fetching and disposing of a group of Resources. [...]
- StageTracker
Extensions
- BuildOutputExtensions
- Extensions on Builder describing expected outputs.
Properties
Functions
-
expectedOutputs(
Builder builder, AssetId input) → Iterable< AssetId> -
Collects the expected AssetIds created by
builder
when giveninput
based on the extension configuration. -
runBuilder(
Builder builder, Iterable< AssetId> inputs, AssetReader reader, AssetWriter writer, Resolvers? resolvers, {Logger? logger, ResourceManager? resourceManager, StageTracker stageTracker = NoOpStageTracker.instance, void reportUnusedAssetsForInput(AssetId input, Iterable<AssetId> assets)?}) → Future<void> -
Run
builder
with each asset ininputs
as the primary input. [...] -
runPostProcessBuilder(
PostProcessBuilder builder, AssetId inputId, AssetReader reader, AssetWriter writer, Logger logger, {required void addAsset(AssetId), required void deleteAsset(AssetId)}) → Future< void> -
Run
builder
withinputId
as the primary input. [...]
Typedefs
-
BeforeExit
= FutureOr<
void> Function() - BuilderFactory = Builder Function(BuilderOptions options)
-
Creates a Builder honoring the configuation in
options
. -
CreateInstance<
T> = FutureOr< T> Function() -
DisposeInstance<
T> = FutureOr< void> Function(T instance) - PostProcessBuilderFactory = PostProcessBuilder Function(BuilderOptions)
Exceptions / Errors
- AssetNotFoundException
- BuildStepCompletedException
- InvalidInputException
- InvalidOutputException
- NonLibraryAssetException
- Thrown when attempting to read a non-Dart library in a Resolver.
- PackageNotFoundException
- SyntaxErrorInAssetException
- Exception thrown by a resolver when attempting to resolve a Dart library with syntax errors. [...]
- UnexpectedOutputException
- UnresolvableAssetException