[native_assets_cli] Document NativeCodeAsset.file requiredness (#1051)

pkgs/native_assets_cli/CHANGELOG.md

@@ -1,3 +1,8 @@
+## 0.5.1
+
+- Update documentation about providing `NativeCodeAsset.file` in dry runs.
+  https://github.com/dart-lang/native/issues/1049
+
 ## 0.5.0
 
 - **Breaking change** Completely rewritten API.

pkgs/native_assets_cli/lib/src/api/native_code_asset.dart

@@ -59,6 +59,20 @@ abstract final class NativeCodeAsset implements Asset {
   /// Either dynamic loading or static linking.
   LinkMode get linkMode;
 
+  /// The file to be bundled with the Dart or Flutter application.
+  ///
+  /// How this file is bundled depends on the kind of asset, represented by a
+  /// concrete subtype of [Asset], and the SDK (Dart or Flutter).
+  ///
+  /// If the [linkMode] is [DynamicLoadingBundled], the file most be provided in
+  /// the [BuildOutput] for [BuildConfig.dryRun].
+  ///
+  /// If the [linkMode] is [DynamicLoadingSystem], [LookupInProcess], or
+  /// [LookupInExecutable] the file must be omitted in the [BuildOutput] for
+  /// [BuildConfig.dryRun].
+  @override
+  Uri? get file;
+
   /// Constructs a native code asset.
   ///
   /// The [id] of this asset is a uri `package:<package>/<name>` from [package]

pkgs/native_assets_cli/pubspec.yaml

@@ -4,7 +4,7 @@ description: >-
   native assets CLI.
 
 # Note: Bump BuildConfig.version and BuildOutput.version on breaking changes!
-version: 0.5.0
+version: 0.5.1
 repository: https://github.com/dart-lang/native/tree/main/pkgs/native_assets_cli
 
 topics: