build_config

• Reject builder names with the wrong package name.

• Document that --define values are parsed as JSON with a fallback.
• Require Dart 3.8.0.

• Add build_to key to post_process_builders. Like the builders key, it controls where the builder output is written: by default cache, the hidden build cache, or source to write next to source files.

• Add top level key triggers. See the docs for more information.
• Bump the min sdk to 3.7.0.
• Remove unused dep: yaml.
• Documentation revamp.

• Stop using deprecated JsonKey.ignore.
• Bump the min sdk to 3.6.0.

• Expand pubspec description to improve pub score.

• Require Dart 2.14
• Support runsBefore global configuration for builders. This allows users to have some control over builder ordering.

• Migrate to null safety.

• Allow the latest pubspec_parse and checked_yaml.

• Comment out dev dependency temporarily to break source_gen/json_serializable dependency loop.

• Allow package:json_annotation v4.x.

• Support the latest pkg:yaml.

• Added the additional_public_assets option, which describes the assets readable when the configured package is not the root of the build.

• Add support for an auto_apply_builders option to the target config.
  • Defaults to true (the previous behavior), setting it to false means all builders have to be explicitly enabled.

• Added optional configYamlPath parameter to BuildConfig.parse. When provided, errors reported when parsing build configuration will include the file path.

• Support the latest release of package:json_annotation.
• Increased the lower bound for the Dart SDK to >=2.3.0.

• Breaking for build systems - change type of BuilderOptions fields to Map<String, dynamic> to drop dependency on build. Does not impact packages only depending on build.yaml parsing.
• Breaking for build systems - versioning scheme is changing to match package:build. Changes which are breaking to users - those with build.yaml files will be indicated with a breaking major version bump. Changed which are breaking to build system implementors - those who use the Dart API for this package, will be indicated with a minor version bump.

• Add an explicit error when buildExtensions is configured to overwrite it's input.
• Add an explicit error when an InputSet has an empty or null value in a glob list.
• Increase lower bound SDK constraint to 2.0.0.
• Normalize builder keys with the legacy | separator to use : instead.

• Improve validation and errors when parsing build.yaml.
• Add BuildConfig.globalOptions support.

• Increased the upper bound for the sdk to <3.0.0.

• Support package:json_annotation v1.

• Support package:build version 1.x.x.

• Support the latest package:json_annotation.

• Parsing of build.yaml files is now done with the json_serializable package and is Dart 2 compatible.

  • The error reporting will be a bit different, but generally should be better, and will include the yaml spans of the problem sections.

Breaking Changes

There are no changes to the build.yaml format, the following changes only affect the imperative apis of this package.

• The Constructors for most of the build config classes other than BuildConfig itself now have to be ran inside a build config zone, which can be done using the runInBuildConfigZone function. This gives the context about what package is currently being parsed, as well as what the default dependencies should be for targets.
• Many constructor signatures have changed, for the most part removing the package parameter (it is now read off the zone).

• The target and build_extensions keys for builder definitions are now optional and should be omitted in most cases since they are currently unused.
• Support options based on mode, add devOptions and releaseOptions on TargetBuilderConfig.
• Support applying default options based on builder definitions, add option, devOptions, and releaseOptions to TargetBuilderConfigDefaults.
• Ensure that defaults and generateFor fields are never null.
• Add InputSet.anything to name the input sets that don't filter out any assets.

• Restore error for missing build extensions.

• Restore error for missing default target.

• Added post_process_builders section to build.yaml. See README.md for more information.-dev
• Adds support for $default as a dependency, i.e.:

targets:
  $default:
    ...
  foo:
    dependencies:
      - $default

• Add support for runs_before in BuilderDefinition.

• Expose key normalization methods publicly, these include:
  • normalizeBuilderKeyUsage
  • normalizeTargetKeyUsage

• Bug fix: Empty build.yaml files no longer fail to parse.
• Allow $default as a target name to get he package name automatically filled in.

• Expand support for package:build to include version 0.12.0.

• Change the default for BuilderDefinition.buildTo to BuildTo.cache. Builders which want to operate on the source tree will need to explicitly opt in. Allow this regardless of the value of autoApply and the build system will need to filter out the builders that can't run.
• By default including any configuration for a Builder within a BuildTarget will enabled that builder.

• Add build_to option to Builder configuration.
• Add BuildConfig.fromBuildConfigDir for cases where the package name and dependencies are already known.
• Add TargetBuilderConfig class to configure builders applied to specific targets.
• Add TargetBuilderConfigDefaults class for Builder authors to provide default configuration.
• Add InputSet and change sources and generate_for to use it.
• Remove BuildTarget.isDefault and related config parsing. The default will be determined by the target which matches the package name.
• Normalize Target and Builder names so they are scoped to the package they are defined in.

Breaking

• Remove BuildConfigSet class. This was unused.
• Hide Pubspec class. Construct BuildConfig instances with a package path rather than an already created Pubspec instance.

• Add auto_apply option to Builder configuration.
• Add required_inputs option to Builder configuration.
• Add is_optional option to Builder configuration.

• Initial release - pulled from package:dazel. Updated to support build_extensions instead of input_extension and output_extensions.