From ad7221e26629ee2e888f977cc783bea84db90d4b Mon Sep 17 00:00:00 2001 From: John Ryan Date: Wed, 8 Jan 2025 14:17:40 -0800 Subject: [PATCH] Update dart_services README.md (#3115) * Update README.md * Update README.md * Update README.md --- pkgs/dart_services/README.md | 31 +++++++++++++++++++++++++++---- 1 file changed, 27 insertions(+), 4 deletions(-) diff --git a/pkgs/dart_services/README.md b/pkgs/dart_services/README.md index f49d55472..2b3325ec7 100644 --- a/pkgs/dart_services/README.md +++ b/pkgs/dart_services/README.md @@ -43,6 +43,23 @@ To rebuild the shelf router, run: dart run build_runner build --delete-conflicting-outputs ``` +### Building storage artifacts +Dart services pre-compiles `.dill` files for the Dart SDK and Flutter Web SDK, which +are uploaded to Cloud Storage automatically. These files are located in the +`artifacts/` directory. + +If you need to re-generate these files, run the following command. + +``` +grind build-storage-artifacts +``` + +Or, if you don't have `grind` on your PATH: + +``` +dart tool/grind.dart build-storage-artifacts +``` + ### Modifying supported packages Package dependencies are pinned using the `pub_dependencies_.yaml` @@ -58,11 +75,17 @@ that the dependencies resolve and update the pinned versions specified in the grind build-project-templates ``` -3. Run `pub upgrade` in the Dart or Flutter project in `project_templates/` -4. Run `grind update-pub-dependencies` to overwrite the + Or, if you don't have `grind` on your PATH: + + ``` + dart tool/grind.dart build-project-templates + ``` + +4. Run `pub upgrade` in the Dart or Flutter project in `project_templates/` +5. Run `grind update-pub-dependencies` to overwrite the `tool/dependencies/pub_dependencies_.yaml` file for your current - channel. -5. Repeat the above steps for the latest version of each Flutter channel + channel. Or, if you don't have `grind` on your PATH, `dart tool/grind.dart update-pub-dependencies` +6. Repeat the above steps for the latest version of each Flutter channel (`main`, `beta` and `stable`) ## Redis