Upgrading build 1 to 2
Breaking1.6.3 → 2.5.4Breaking2New3Changed22Fixed4Other13
BreakingUpgrade verdict
2 breaking changes.
In plain terms
- Code that passed `rootPackage` to `runBuilder` must stop passing it.
- Callers must now pass a `Uri` instead of a string to `AssetId.resolve`.
Must act 2 items need code or config changes
Dart SDK requirement changed in 2.5.0: >=2.11.99 <3.0.0 → ^3.7.0.
What you must change
Breaking2
Removes the deprecated
rootPackage argument to runBuilder.runBuilderrootPackageChanges the first argument to
AssetId.resolve from a String to a Uri instance.AssetId.resolveUriUri.parse()API changes
Generated by DepDelta from published Dart source. Not mixed with prose notes.
- removed:
class MultiPackageAssetReader: abstract extends AssetReader - removed:
get AssetId.uri: Uri - removed:
method MultiPackageAssetReader.findAssets(Glob glob, {String package}): Stream<AssetId> - changed:
ctor AssetId.resolve(String uri, {AssetId from}) → ctor AssetId.resolve(Uri uri, {AssetId? from}) - changed:
ctor AssetNotFoundException(this.assetId) → ctor AssetNotFoundException(this.assetId, {this.path}) - changed:
ctor BuilderOptions(this.config, {bool isRoot}) → ctor BuilderOptions(this.config, {this.isRoot = …}) - changed:
ctor FileDeletingBuilder.withExcludes( this.inputExtensions, Iterable<String> exclude, {this.isEnabled = …}) → ctor FileDeletingBuilder.withExcludes( this.inputExtensions, Iterable<String> exclude, { this.isEnabled = …, }) - changed:
ctor Resource(this._create, {DisposeInstance<T> dispose, BeforeExit beforeExit}) → ctor Resource(this._create, {DisposeInstance<T>? dispose, BeforeExit? beforeExit}) - changed:
field UnexpectedOutputException.expected: final Iterable<AssetId> → field UnexpectedOutputException.expected: final Iterable<AssetId>? - changed:
function runBuilder(Builder builder, Iterable<AssetId> inputs, AssetReader reader, AssetWriter writer, Resolvers resolvers, {Logger logger, ResourceManager resourceManager, @Deprecated('The rootPackage argument is unused') String rootPackage, StageTracker stageTracker = …, void Function(AssetId input, Iterable<AssetId> assets) reportUnusedAssetsForInput}): Future<void> → function runBuilder( Builder builder, Iterable<AssetId> inputs, AssetReader assetReader, AssetWriter assetWriter, Resolvers? resolvers, { Logger? logger, ResourceManager? resourceManager, StageTracker stageTracker = …, void Function(AssetId input, Iterable<AssetId> assets)? reportUnusedAssetsForInput, PackageConfig? packageConfig, }): Future<void> - changed:
function runPostProcessBuilder(PostProcessBuilder builder, AssetId inputId, AssetReader reader, AssetWriter writer, Logger logger, {@required void Function(AssetId) addAsset, @required void Function(AssetId) deleteAsset}): Future<void> → function runPostProcessBuilder( PostProcessBuilder builder, AssetId inputId, AssetReader reader, AssetWriter writer, Logger logger, { required void Function(AssetId) addAsset, required void Function(AssetId) deleteAsset, }): Future<void> - changed:
method AssetReader.readAsString(AssetId id, {Encoding encoding}): Future<String> → method AssetReader.readAsString(AssetId id, {Encoding encoding = …}): Future<String> - changed:
method AssetWriter.writeAsString(AssetId id, String contents, {Encoding encoding = …}): Future<void> → method AssetWriter.writeAsString( AssetId id, String contents, { Encoding encoding = …, }): Future<void> - changed:
method AssetWriterSpy.writeAsString(AssetId id, String contents, {Encoding encoding = …}): Future<void> → method AssetWriterSpy.writeAsString( AssetId id, String contents, { Encoding encoding = …, }): Future<void> - changed:
method BuildStep.writeAsString(AssetId id, FutureOr<String> contents, {Encoding encoding = …}): Future<void> → method BuildStep.writeAsString( AssetId id, FutureOr<String> contents, { Encoding encoding = …, }): Future<void> - changed:
method BuilderOptions.overrideWith(BuilderOptions other): BuilderOptions → method BuilderOptions.overrideWith(BuilderOptions? other): BuilderOptions - changed:
method FileDeletingBuilder.build(PostProcessBuildStep buildStep): FutureOr<Null> → method FileDeletingBuilder.build(PostProcessBuildStep buildStep): FutureOr<void> - changed:
method PostProcessBuildStep.writeAsString(AssetId id, FutureOr<String> content, {Encoding encoding = …}): Future<void> → method PostProcessBuildStep.writeAsString( AssetId id, FutureOr<String> content, { Encoding encoding = …, }): Future<void> - changed:
method Resolver.astNodeFor(Element element, {bool resolve = …}): Future<AstNode> → method Resolver.astNodeFor(Element element, {bool resolve = …}): Future<AstNode?> - changed:
method Resolver.compilationUnitFor(AssetId assetId, {bool allowSyntaxErrors = …}): Future<CompilationUnit> → method Resolver.compilationUnitFor( AssetId assetId, { bool allowSyntaxErrors = …, }): Future<CompilationUnit> - changed:
method Resolver.findLibraryByName(String libraryName): Future<LibraryElement> → method Resolver.findLibraryByName(String libraryName): Future<LibraryElement?> - changed:
method Resolver.libraryFor(AssetId assetId, {bool allowSyntaxErrors = …}): Future<LibraryElement> → method Resolver.libraryFor( AssetId assetId, { bool allowSyntaxErrors = …, }): Future<LibraryElement> - changed:
method ResourceManager.beforeExit(): Future<Null> → method ResourceManager.beforeExit(): Future<void> - changed:
method ResourceManager.disposeAll(): Future<Null> → method ResourceManager.disposeAll(): Future<void> - added:
extension BuildOutputExtensions on Builder - added:
field AssetId.uri: late final Uri - added:
field AssetNotFoundException.path: final String? - added:
get BuildStep.allowedOutputs: Iterable<AssetId> - added:
get BuildStep.packageConfig: Future<PackageConfig> - added:
method BuildOutputExtensions.hasOutputFor(AssetId input): bool