[hooks] [code_assets] Update README (#2321)

dcharkes · web-flow · commit b1466111d5f1 · 2025-05-21T17:58:22.000+02:00
diff --git a/pkgs/code_assets/CHANGELOG.md b/pkgs/code_assets/CHANGELOG.md
@@ -1,3 +1,7 @@
+## 0.19.2
+
+* Mark this package as in preview.
+
 ## 0.19.1
 
 * Bump the SDK constraint to at least the one from `package:hooks` to fix
diff --git a/pkgs/code_assets/README.md b/pkgs/code_assets/README.md
@@ -3,12 +3,12 @@
 [![pub package](https://img.shields.io/pub/v/code_assets.svg)](https://pub.dev/packages/code_assets)
 [![package publisher](https://img.shields.io/pub/publisher/code_assets.svg)](https://pub.dev/packages/code_assets/publisher)
 
-This library contains the hook protocol specification for bundling native code
-with Dart packages.
+A library to use in build hooks (`hook/build.dart`) for building and bundling
+code assets.
 
 ## Status: Experimental
 
-**NOTE**: This package is currently experimental and published under the
+**NOTE**: This package is currently in preview and published under the
 [labs.dart.dev](https://dart.dev/dart-team-packages) pub publisher in order to
 solicit feedback. 
 
diff --git a/pkgs/code_assets/pubspec.yaml b/pkgs/code_assets/pubspec.yaml
@@ -3,7 +3,7 @@ description: >-
   This library contains the hook protocol specification for bundling native code
   with Dart packages.
 
-version: 0.19.1
+version: 0.19.2
 
 repository: https://github.com/dart-lang/native/tree/main/pkgs/code_assets
 
@@ -21,7 +21,7 @@ environment:
 
 dependencies:
   collection: ^1.19.1
-  hooks: ^0.19.1
+  hooks: ^0.19.2
 
 dev_dependencies:
   custom_lint: ^0.7.5
diff --git a/pkgs/data_assets/README.md b/pkgs/data_assets/README.md
@@ -3,8 +3,8 @@
 [![pub package](https://img.shields.io/pub/v/data_assets.svg)](https://pub.dev/packages/data_assets)
 [![package publisher](https://img.shields.io/pub/publisher/data_assets.svg)](https://pub.dev/packages/data_assets/publisher)
 
-This library contains the hook protocol specification for bundling data assets
-with Dart packages.
+A library to use in build hooks (`hook/build.dart`) for building and bundling
+data assets.
 
 ## Status: Experimental
 
diff --git a/pkgs/data_assets/pubspec.yaml b/pkgs/data_assets/pubspec.yaml
@@ -17,7 +17,7 @@ environment:
   sdk: '>=3.9.0-21.0.dev <4.0.0'
 
 dependencies:
-  hooks: ^0.19.1
+  hooks: ^0.19.2
 
 dev_dependencies:
   custom_lint: ^0.7.5
diff --git a/pkgs/hooks/CHANGELOG.md b/pkgs/hooks/CHANGELOG.md
@@ -1,3 +1,7 @@
+## 0.19.2
+
+* Mark this package as in preview.
+
 ## 0.19.1
 
 - Added links to the `build` and `link` methods as primary entry points.
diff --git a/pkgs/hooks/README.md b/pkgs/hooks/README.md
@@ -3,11 +3,11 @@
 [![pub package](https://img.shields.io/pub/v/hooks.svg)](https://pub.dev/packages/hooks)
 [![package publisher](https://img.shields.io/pub/publisher/hooks.svg)](https://pub.dev/packages/hooks/publisher)
 
-A library to invoke the native C compiler installed on the host machine.
+A library to use in build hooks (`hook/build.dart`).
 
 ## Status: Experimental
 
-**NOTE**: This package is currently experimental and published under the
+**NOTE**: This package is currently in preview and published under the
 [labs.dart.dev](https://dart.dev/dart-team-packages) pub publisher in order to
 solicit feedback. 
 
diff --git a/pkgs/hooks/example/build/download_asset/pubspec.yaml b/pkgs/hooks/example/build/download_asset/pubspec.yaml
@@ -11,9 +11,9 @@ environment:
   sdk: '>=3.8.0 <4.0.0'
 
 dependencies:
-  code_assets: ^0.19.1
+  code_assets: ^0.19.2
   crypto: ^3.0.6
-  hooks: ^0.19.1
+  hooks: ^0.19.2
   logging: ^1.3.0
   native_toolchain_c: ^0.16.2
 
diff --git a/pkgs/hooks/example/build/local_asset/pubspec.yaml b/pkgs/hooks/example/build/local_asset/pubspec.yaml
@@ -11,8 +11,8 @@ environment:
   sdk: '>=3.8.0 <4.0.0'
 
 dependencies:
-  code_assets: ^0.19.1
-  hooks: ^0.19.1
+  code_assets: ^0.19.2
+  hooks: ^0.19.2
   logging: ^1.3.0
 
 dev_dependencies:
diff --git a/pkgs/hooks/example/build/native_add_library/pubspec.yaml b/pkgs/hooks/example/build/native_add_library/pubspec.yaml
@@ -11,8 +11,8 @@ environment:
   sdk: '>=3.8.0 <4.0.0'
 
 dependencies:
-  code_assets: ^0.19.1
-  hooks: ^0.19.1
+  code_assets: ^0.19.2
+  hooks: ^0.19.2
   logging: ^1.3.0
   native_toolchain_c: ^0.16.2
 
diff --git a/pkgs/hooks/example/build/native_dynamic_linking/pubspec.yaml b/pkgs/hooks/example/build/native_dynamic_linking/pubspec.yaml
@@ -11,8 +11,8 @@ environment:
   sdk: '>=3.8.0 <4.0.0'
 
 dependencies:
-  code_assets: ^0.19.1
-  hooks: ^0.19.1
+  code_assets: ^0.19.2
+  hooks: ^0.19.2
   logging: ^1.3.0
   native_toolchain_c: ^0.16.2
 
diff --git a/pkgs/hooks/example/build/system_library/pubspec.yaml b/pkgs/hooks/example/build/system_library/pubspec.yaml
@@ -10,8 +10,8 @@ environment:
   sdk: '>=3.8.0 <4.0.0'
 
 dependencies:
-  code_assets: ^0.19.1
-  hooks: ^0.19.1
+  code_assets: ^0.19.2
+  hooks: ^0.19.2
   logging: ^1.3.0
   native_toolchain_c: ^0.16.2
 
diff --git a/pkgs/hooks/example/build/use_dart_api/pubspec.yaml b/pkgs/hooks/example/build/use_dart_api/pubspec.yaml
@@ -10,8 +10,8 @@ environment:
   sdk: '>=3.8.0 <4.0.0'
 
 dependencies:
-  code_assets: ^0.19.1
-  hooks: ^0.19.1
+  code_assets: ^0.19.2
+  hooks: ^0.19.2
   logging: ^1.3.0
   native_toolchain_c: ^0.16.2
 
diff --git a/pkgs/hooks/example/link/package_with_assets/pubspec.yaml b/pkgs/hooks/example/link/package_with_assets/pubspec.yaml
@@ -11,7 +11,7 @@ environment:
 
 dependencies:
   data_assets: ^0.19.1
-  hooks: ^0.19.1
+  hooks: ^0.19.2
   logging: ^1.3.0
   meta: ^1.16.0
   record_use: ^0.3.0
diff --git a/pkgs/hooks/pubspec.yaml b/pkgs/hooks/pubspec.yaml
@@ -3,7 +3,7 @@ description: >-
   A library that contains a Dart API for the JSON-based protocol for
   `hook/build.dart` and `hook/link.dart`.
 
-version: 0.19.1
+version: 0.19.2
 
 repository: https://github.com/dart-lang/native/tree/main/pkgs/hooks
 
@@ -29,7 +29,7 @@ dependencies:
 
 dev_dependencies:
   args: ^2.6.0
-  code_assets: ^0.19.1 # Used for running tests with real asset types.
+  code_assets: ^0.19.2 # Used for running tests with real asset types.
   custom_lint: ^0.7.5
   dart_flutter_team_lints: ^3.5.1
   data_assets: ^0.19.1 # Used for running tests with real asset types.
diff --git a/pkgs/hooks_runner/pubspec.yaml b/pkgs/hooks_runner/pubspec.yaml
@@ -12,12 +12,12 @@ environment:
   sdk: '>=3.9.0-21.0.dev <4.0.0'
 
 dependencies:
-  code_assets: ^0.19.1 # Needed for OS for Target for KernelAssets.
+  code_assets: ^0.19.2 # Needed for OS for Target for KernelAssets.
   collection: ^1.19.1
   crypto: ^3.0.6
   file: ^7.0.1
   graphs: ^2.3.2
-  hooks: ^0.19.1
+  hooks: ^0.19.2
   logging: ^1.3.0
   meta: ^1.16.0
   package_config: ^2.1.0
diff --git a/pkgs/hooks_runner/test_data/add_asset_link/pubspec.yaml b/pkgs/hooks_runner/test_data/add_asset_link/pubspec.yaml
@@ -10,8 +10,8 @@ environment:
   sdk: '>=3.8.0 <4.0.0'
 
 dependencies:
-  code_assets: ^0.19.1
-  hooks: ^0.19.1
+  code_assets: ^0.19.2
+  hooks: ^0.19.2
   logging: ^1.3.0
   meta: ^1.16.0
   native_toolchain_c: ^0.16.2
diff --git a/pkgs/hooks_runner/test_data/complex_link/pubspec.yaml b/pkgs/hooks_runner/test_data/complex_link/pubspec.yaml
@@ -14,7 +14,7 @@ dependencies:
   complex_link_helper:
     path: ../complex_link_helper/
   data_assets: ^0.19.1
-  hooks: ^0.19.1
+  hooks: ^0.19.2
   logging: ^1.3.0
 
 dev_dependencies:
diff --git a/pkgs/hooks_runner/test_data/complex_link_helper/pubspec.yaml b/pkgs/hooks_runner/test_data/complex_link_helper/pubspec.yaml
@@ -12,7 +12,7 @@ environment:
 dependencies:
   cli_config: ^0.2.0
   data_assets: ^0.19.1
-  hooks: ^0.19.1
+  hooks: ^0.19.2
   logging: ^1.3.0
 
 dev_dependencies:
diff --git a/pkgs/hooks_runner/test_data/cyclic_package_1/pubspec.yaml b/pkgs/hooks_runner/test_data/cyclic_package_1/pubspec.yaml
@@ -12,7 +12,7 @@ environment:
 dependencies:
   cyclic_package_2:
     path: ../cyclic_package_2
-  hooks: ^0.19.1
+  hooks: ^0.19.2
 
 dev_dependencies:
   lints: ^5.1.1
diff --git a/pkgs/hooks_runner/test_data/cyclic_package_2/pubspec.yaml b/pkgs/hooks_runner/test_data/cyclic_package_2/pubspec.yaml
@@ -12,7 +12,7 @@ environment:
 dependencies:
   cyclic_package_1:
     path: ../cyclic_package_1
-  hooks: ^0.19.1
+  hooks: ^0.19.2
 
 dev_dependencies:
   lints: ^5.1.1
diff --git a/pkgs/hooks_runner/test_data/depend_on_fail_build/pubspec.yaml b/pkgs/hooks_runner/test_data/depend_on_fail_build/pubspec.yaml
@@ -12,7 +12,7 @@ environment:
 dependencies:
   fail_build:
     path: ../fail_build/
-  hooks: ^0.19.1
+  hooks: ^0.19.2
 
 dev_dependencies:
   ffigen: ^18.0.0
diff --git a/pkgs/hooks_runner/test_data/depend_on_fail_build_app/pubspec.yaml b/pkgs/hooks_runner/test_data/depend_on_fail_build_app/pubspec.yaml
@@ -12,7 +12,7 @@ environment:
 dependencies:
   depend_on_fail_build:
     path: ../depend_on_fail_build/
-  hooks: ^0.19.1
+  hooks: ^0.19.2
 
 dev_dependencies:
   ffigen: ^18.0.0
diff --git a/pkgs/hooks_runner/test_data/drop_dylib_link/pubspec.yaml b/pkgs/hooks_runner/test_data/drop_dylib_link/pubspec.yaml
@@ -10,8 +10,8 @@ environment:
   sdk: '>=3.8.0 <4.0.0'
 
 dependencies:
-  code_assets: ^0.19.1
-  hooks: ^0.19.1
+  code_assets: ^0.19.2
+  hooks: ^0.19.2
   logging: ^1.3.0
   native_toolchain_c: ^0.16.2
 
diff --git a/pkgs/hooks_runner/test_data/fail_build/pubspec.yaml b/pkgs/hooks_runner/test_data/fail_build/pubspec.yaml
@@ -10,8 +10,8 @@ environment:
   sdk: '>=3.8.0 <4.0.0'
 
 dependencies:
-  code_assets: ^0.19.1
-  hooks: ^0.19.1
+  code_assets: ^0.19.2
+  hooks: ^0.19.2
 
 dev_dependencies:
   ffigen: ^18.0.0
diff --git a/pkgs/hooks_runner/test_data/fail_on_os_sdk_version/pubspec.yaml b/pkgs/hooks_runner/test_data/fail_on_os_sdk_version/pubspec.yaml
@@ -10,8 +10,8 @@ environment:
   sdk: '>=3.8.0 <4.0.0'
 
 dependencies:
-  code_assets: ^0.19.1
-  hooks: ^0.19.1
+  code_assets: ^0.19.2
+  hooks: ^0.19.2
 
 dev_dependencies:
   ffigen: ^18.0.0
diff --git a/pkgs/hooks_runner/test_data/fail_on_os_sdk_version_link/pubspec.yaml b/pkgs/hooks_runner/test_data/fail_on_os_sdk_version_link/pubspec.yaml
@@ -13,7 +13,7 @@ dependencies:
   data_assets: ^0.19.1
   fail_on_os_sdk_version_linker:
     path: ../fail_on_os_sdk_version_linker/
-  hooks: ^0.19.1
+  hooks: ^0.19.2
 
 dev_dependencies:
   ffigen: ^18.0.0
diff --git a/pkgs/hooks_runner/test_data/fail_on_os_sdk_version_linker/pubspec.yaml b/pkgs/hooks_runner/test_data/fail_on_os_sdk_version_linker/pubspec.yaml
@@ -10,8 +10,8 @@ environment:
   sdk: '>=3.8.0 <4.0.0'
 
 dependencies:
-  code_assets: ^0.19.1
-  hooks: ^0.19.1
+  code_assets: ^0.19.2
+  hooks: ^0.19.2
 
 dev_dependencies:
   ffigen: ^18.0.0
diff --git a/pkgs/hooks_runner/test_data/native_add/pubspec.yaml b/pkgs/hooks_runner/test_data/native_add/pubspec.yaml
@@ -10,8 +10,8 @@ environment:
   sdk: '>=3.8.0 <4.0.0'
 
 dependencies:
-  code_assets: ^0.19.1
-  hooks: ^0.19.1
+  code_assets: ^0.19.2
+  hooks: ^0.19.2
   logging: ^1.3.0
   native_toolchain_c: ^0.16.2
 
diff --git a/pkgs/hooks_runner/test_data/native_add_add_source/pubspec.yaml b/pkgs/hooks_runner/test_data/native_add_add_source/pubspec.yaml
@@ -10,8 +10,8 @@ environment:
   sdk: '>=3.8.0 <4.0.0'
 
 dependencies:
-  code_assets: ^0.19.1
-  hooks: ^0.19.1
+  code_assets: ^0.19.2
+  hooks: ^0.19.2
   logging: ^1.3.0
   native_toolchain_c: ^0.16.2
 
diff --git a/pkgs/hooks_runner/test_data/native_add_duplicate/pubspec.yaml b/pkgs/hooks_runner/test_data/native_add_duplicate/pubspec.yaml
@@ -10,8 +10,8 @@ environment:
   sdk: '>=3.8.0 <4.0.0'
 
 dependencies:
-  code_assets: ^0.19.1
-  hooks: ^0.19.1
+  code_assets: ^0.19.2
+  hooks: ^0.19.2
   logging: ^1.3.0
   native_add:
     path: ../native_add/
diff --git a/pkgs/hooks_runner/test_data/native_dynamic_linking/pubspec.yaml b/pkgs/hooks_runner/test_data/native_dynamic_linking/pubspec.yaml
@@ -11,8 +11,8 @@ environment:
   sdk: '>=3.8.0 <4.0.0'
 
 dependencies:
-  code_assets: ^0.19.1
-  hooks: ^0.19.1
+  code_assets: ^0.19.2
+  hooks: ^0.19.2
   logging: ^1.3.0
   native_toolchain_c: ^0.16.2
 
diff --git a/pkgs/hooks_runner/test_data/native_subtract/pubspec.yaml b/pkgs/hooks_runner/test_data/native_subtract/pubspec.yaml
@@ -10,8 +10,8 @@ environment:
   sdk: '>=3.8.0 <4.0.0'
 
 dependencies:
-  code_assets: ^0.19.1
-  hooks: ^0.19.1
+  code_assets: ^0.19.2
+  hooks: ^0.19.2
   logging: ^1.3.0
   native_toolchain_c: ^0.16.2
 
diff --git a/pkgs/hooks_runner/test_data/no_asset_for_link/pubspec.yaml b/pkgs/hooks_runner/test_data/no_asset_for_link/pubspec.yaml
@@ -10,9 +10,9 @@ environment:
   sdk: '>=3.8.0 <4.0.0'
 
 dependencies:
-  code_assets: ^0.19.1
+  code_assets: ^0.19.2
   data_assets: ^0.19.1
-  hooks: ^0.19.1
+  hooks: ^0.19.2
   logging: ^1.3.0
   meta: ^1.16.0
 
diff --git a/pkgs/hooks_runner/test_data/no_hook/pubspec.yaml b/pkgs/hooks_runner/test_data/no_hook/pubspec.yaml
@@ -10,8 +10,8 @@ environment:
   sdk: '>=3.8.0 <4.0.0'
 
 dependencies:
-  code_assets: ^0.19.1
-  hooks: ^0.19.1
+  code_assets: ^0.19.2
+  hooks: ^0.19.2
   logging: ^1.3.0
   native_toolchain_c: ^0.16.2
 
diff --git a/pkgs/hooks_runner/test_data/package_reading_metadata/pubspec.yaml b/pkgs/hooks_runner/test_data/package_reading_metadata/pubspec.yaml
@@ -10,8 +10,8 @@ environment:
   sdk: '>=3.8.0 <4.0.0'
 
 dependencies:
-  code_assets: ^0.19.1
-  hooks: ^0.19.1
+  code_assets: ^0.19.2
+  hooks: ^0.19.2
   package_with_metadata:
     path: ../package_with_metadata/
 
diff --git a/pkgs/hooks_runner/test_data/package_with_metadata/pubspec.yaml b/pkgs/hooks_runner/test_data/package_with_metadata/pubspec.yaml
diff --git a/pkgs/hooks_runner/test_data/relative_path/pubspec.yaml b/pkgs/hooks_runner/test_data/relative_path/pubspec.yaml
diff --git a/pkgs/hooks_runner/test_data/reusable_dynamic_library/pubspec.yaml b/pkgs/hooks_runner/test_data/reusable_dynamic_library/pubspec.yaml
diff --git a/pkgs/hooks_runner/test_data/reuse_dynamic_library/pubspec.yaml b/pkgs/hooks_runner/test_data/reuse_dynamic_library/pubspec.yaml
diff --git a/pkgs/hooks_runner/test_data/simple_data_asset/pubspec.yaml b/pkgs/hooks_runner/test_data/simple_data_asset/pubspec.yaml
diff --git a/pkgs/hooks_runner/test_data/simple_link/pubspec.yaml b/pkgs/hooks_runner/test_data/simple_link/pubspec.yaml
diff --git a/pkgs/hooks_runner/test_data/system_library/pubspec.yaml b/pkgs/hooks_runner/test_data/system_library/pubspec.yaml
diff --git a/pkgs/hooks_runner/test_data/transformer/pubspec.yaml b/pkgs/hooks_runner/test_data/transformer/pubspec.yaml
diff --git a/pkgs/hooks_runner/test_data/treeshaking_native_libs/pubspec.yaml b/pkgs/hooks_runner/test_data/treeshaking_native_libs/pubspec.yaml
diff --git a/pkgs/hooks_runner/test_data/use_all_api/pubspec.yaml b/pkgs/hooks_runner/test_data/use_all_api/pubspec.yaml
diff --git a/pkgs/hooks_runner/test_data/user_defines/pubspec.yaml b/pkgs/hooks_runner/test_data/user_defines/pubspec.yaml
diff --git a/pkgs/hooks_runner/test_data/wrong_build_output/pubspec.yaml b/pkgs/hooks_runner/test_data/wrong_build_output/pubspec.yaml
diff --git a/pkgs/hooks_runner/test_data/wrong_build_output_2/pubspec.yaml b/pkgs/hooks_runner/test_data/wrong_build_output_2/pubspec.yaml
diff --git a/pkgs/hooks_runner/test_data/wrong_build_output_3/pubspec.yaml b/pkgs/hooks_runner/test_data/wrong_build_output_3/pubspec.yaml
diff --git a/pkgs/hooks_runner/test_data/wrong_linker/pubspec.yaml b/pkgs/hooks_runner/test_data/wrong_linker/pubspec.yaml
diff --git a/pkgs/hooks_runner/test_data/wrong_namespace_asset/pubspec.yaml b/pkgs/hooks_runner/test_data/wrong_namespace_asset/pubspec.yaml
diff --git a/pkgs/native_toolchain_c/pubspec.yaml b/pkgs/native_toolchain_c/pubspec.yaml
