build

• Allow analyzer 14.0.0, require 13.3.0.
• Require Dart 3.11.0.

• Replace Builder extension method hasOutputFor with matchesInput. Deprecate hasOutputFor. The new matchesInput is identical, but now that zero-output builders are supported the old name is misleading.
• Require Dart 3.8.0.

• Allow analyzer 13.0.0.

• Allow analyzer 11.0.0 and 12.0.0.

• Allow analyzer 10.0.0.

• Allow analyzer 9.0.0.

• Require analyzer 8.0.0. Remove use of deprecated analyzer members, use their recommended and compatible replacements.

• Improvements to dartdoc.

• Remove methods and classes deprecated in 4.0.0.
• Make AssetReader.digest abstract.
• Remove unused deps: async, build_runner_core, convert.

• Deprecate runBuilder. It has been moved to package:build_runner_core and will be removed from package:build. Please note: the currently supported ways to run builders are using build_runner on the command line or build_test in tests. If you need ongoing support for a different way to run builders please get in touch at https://github.com/dart-lang/build/discussions.
• Deprecate runPostProcessBuilder. Like runBuilder, it has been moved to package:build_runner_core and will be removed from package:build.
• Deprecate AssetWriterSpy. It will be removed.
• Deprecate MultiplexingBuilder. It will be removed.
• Use build_runner_core 9.3.1.

• Use build_runner_core 9.3.0.
• Documentation revamp.
• Allow meta 1.16.0.

• Small improvements to RAM usage.
• Allow analyzer 8.0.0.

• Removed unused deps: meta, pool.
• Breaking: use the new element2 APIs in analyzer. Builders that do resolution need to switch to the new API, see https://github.com/dart-lang/sdk/blob/main/pkg/analyzer/doc/element_model_migration_guide.md. For questions please use https://github.com/dart-lang/build/discussions.

• Removed unused deps: meta, pool.

• Breaking: use the new element2 APIs in analyzer. Builders that do resolution need to switch to the new API, see https://github.com/dart-lang/sdk/blob/main/pkg/analyzer/doc/element_model_migration_guide.md. For questions please use https://github.com/dart-lang/build/discussions.

• Use build_runner_core 9.1.2.

• Use build_runner_core 9.1.1.

• Use build_runner_core 9.1.0.

• Use build_runner_core 9.0.1.

User-visible changes:

• Improved performance for large builds. More performance improvements will follow, if your workflow is affected by slow build_runner performance then please consider sharing details at https://github.com/dart-lang/build/discussions.
• Improved logging: show what builders are running and, for long-running builders, where the time is spent.
• AssetNotFoundException now also reports the missing path.

Versions:

• Bump the min sdk to 3.7.0.
• Use build_test 3.0.0.
• Use build_runner_core 9.0.0.

Internal changes:

• Add package:build/src/internal.dart for use by build_resolvers, build_runner_core and build_test.
• Refactor PathProvidingAssetReader to AssetPathProvider.
• Refactor MultiPackageAssetReader to internal AssetFinder.
• Add internal Filesystem that backs AssetReader and AssetWriter implementations.
• Refactor CachingAssetReader to FilesystemCache.
• Refactor BuildCacheReader to BuildCacheAssetPathProvider.
• Refactor FileBasedAssetReader and FileBasedAssetWriter to ReaderWriter.
• Move BuildStepImpl to build_runner_core, use SingleStepReader directly.
• Add LibraryCycleGraphLoader for loading transitive deps for analysis.
• Track resolver dependencies as library cycle graphs.
• Ignore deprecated analyzer API usages.

• Bump the min sdk to 3.6.0.
• Remove some unnecessary casts and non-null assertions now that we have private field promotion.
• Require analyzer ^6.9.0, allow <8.0.0.
• Fix analyzer deprecations.

• Allow the latest analyzer (6.x.x).

• Add BuildStep.packageConfig getter to resolve a package config of all packages involved in the current build.

• Allow the latest package:analyzer.
• Bump min sdk to 2.17.0.

• Support ^ in build extensions that don't use capture groups, which results in full path matching instead of suffix matching.

• Allow analyzer version 4.x.

• Fix a bug where builders were allowed to write to the same asset multiple times.

• Allow reusing the values held by Resources when the resource has a dispose method. Previously the instances were discarded and recreated for every build even if they had tried to clean up their own state.
• Allow the latest analyzer.

• Throw an ArgumentError if an expected output matches the input.
• Bump min sdk to 2.14.0.

• Expand the expressiveness of buildExtensions include capture groups, enabling directory moves.
• Add an allowedOutputs getter to BuildStep. It returns assets that may be written in that step.

• Allow analyzer version 2.x.x.

• Handle failed resolvers in buildStep.complete.

• Require package:async version 2.5.0 and package:collection version 1.15.0.

• Migrate to null-safety
• Breaking: Remove the deprecated rootPackage argument to runBuilder
• Breaking: Change the first argument to AssetId.resolve from a String (which previously was required to be a valid URI) to a Uri instance. Call sites which have static errors can wrap the argument with Uri.parse().

• Use latest analyzer version 1.x.
• Use latest glob version 2.x.

• Fix AssetId.resolve for empty uris

• Allow the null safe pre-releases of all migrated deps.

• Adds the Future<AstNode> astNodeFor(Element, {bool resolve}) api to Resolver which provides a safe way of getting ast nodes (avoiding InconsistentAnalysisExceptions).

• Allow the latest analyzer verion 0.41.x.

• Expose a set of valid inputs in InvalidInputException.
• AssetReader implementations are now expected to throw InvalidInputExceptions when reading invalid inputs. The check has been removed from the build step implementation.

• Allow the latest analyzer version 0.40.x.
• Added the Future<CompilationUnit> compilationUnitFor(AssetId id) api to the Resolver class, which returns only the parsed AST for the given asset.
  • Much cheaper than libraryFor, because it only reads the given asset instead of touching all transitive deps.
  • Still may be suitable for some builders which don't need the fully resolved Element model.

The resolver will now throw an SyntaxErrorInAssetException when attempting to resolve an asset with syntax errors. You can opt-out of this new behavior by passing allowSyntaxErrors: true to libraryFor.

Added a new experiments library which exposes a list of language experiments through a Zone variable. This should only be used by builders which are invoking compilers or some other tool and need to pass on the language experiments.

Updated docs for some minor behavior changes in build_resolvers 1.3.0

• Resolver.libraries will now return any library that has been resolved with this resolver. This means calls to libraryFor or isLibrary on files not already resolved will make subsequent libraries streams return more libraries than previous calls did.
• The same holds for findLibraryByName since it searches through the libraries stream. You may get a different result at different points in your build method if you resolve additional libraries.

• Allow analyzer 0.39.x.

• Add the void reportUnusedAssets(Iterable<AssetId> ids) method to the BuildStep class.
  • WARNING: Using this introduces serious risk of non-hermetic builds.
  • Indicates to the build system that ids were read but their content has no impact on the outputs of the build.
  • Build system implementations can choose to support this feature or not, and it should be assumed to be a no-op by default.

• Allow analyzer version 0.38.0.

• Allow analyzer version 0.37.0.

• Internal cleanup: use "strict raw types".
• Some return types for interfaces to implement changed from Future<dynamic> to Future<void>.

• Update the minimum sdk constraint to 2.1.0.
• Increased the upper bound for package:analyzer to <0.37.0.

• Internal fixes: Remove default value for optional argument.

• Requires analyzer version 0.35.0
  • Resolver implementations in other packages are now backed by an AnalysisDriver. There are behavior changes which may be breaking. The LibraryElement instances returned by the resolver will now:
    • Have non-working context fields.
    • Have no source offsets for annotations or their errors.
    • Have working session fields.
    • Have Source instances with different URIs than before.

• Add Resolver.assetIdForElement API. This allows finding the Dart source asset which contains the definition of an element found through the analyzer.
• Include the AssetId hash code in the default digest implementation.
  • Any custom implementations of the AssetReader.digest method should do the same, and a comment has been added to that effect.

• Increased the upper bound for package:analyzer to <0.35.0.

• Increased the upper bound for package:analyzer to <0.34.0.

Breaking Changes

• Changed the return type of Builder.build from Future<dynamic> to FutureOr<void>. This should not be breaking for most Builder authors, it is only breaking for build system implementations that run Builders.

• Added the T trackStage<T>(String label, T Function() action); method to BuildStep. Actions that are tracked in this way will show up in the performance timeline at /$perf.