Creating a release
To update the version no. and publish your project run:
The pub_release command will:
prompt you to select the new version number
update pubspec.yaml with the new version no.
create/update a version file in src/util/version.g.dart
format your code with dartfmt
analyze you code with dartanalyzer
Generate a default change log entry using your commit history
Allow you to edit the resulting change log.
push all commits to git
run any scripts found in the pre_release_hook directory.
remove and restore any dependency overrides in your pubspec.yaml
publish your project to pub.dev
run any scripts found in the post_release_hook directory.
--dry-run
You can pass the --dry-run flag on the pub_release command line. In this case the pub_release process is run but no modifications are made to to the project (except for code formatting). The dart pub publish command is also run with the --dry-run switch so suppress publishing the package.
setVersion
You can pass a version no. as an option on the command line. By default Pub Release will prompt the user for a new version no. When you pass the setVersion option the user will not be prompted and the passed version will be used.
--[no]-test
By default pub-release will run all unit tests (via the critical_test package) before doing a release.
If any unit tests fail then the release will be halted.
You can by pass the running of unit tests by passing the --no-test flag on the command line.
autoAnswer
By default, Pub Release runs in interactive mode and will ask the users a no. of questions during the release process. You can suppress these questions by passing the --autoAnswer flag. When you pass the autoAnswer flag Pub Release assumes that you answer yes to all questions and takes the default path.
--[no]-git
By default pub_release detects if your code is managed by git.
test
If the code is managed by git then it will automatically commit any changes made during the release process as well as creating a release tag.
The --test flag instructs Pub Release to run all unit tests using the Critical Test package. If any test fails the release will be aborted.
You can suppress all git operations by passing the --no-git flag.
Note: git operations are only supported against github. If you remote git repo is other than github then you should always use the --no-git flag.
line
pub_release will work if you just have a local git repo with no remote set.
The line flag controls the line length of Dart libraries when formatting code. The line length defaults to 80 characters.
--autoAnswer
If you pass the --autoAnswer flag then the user will no be prompted during the release process.
multi
If you use the --autoAnswer flag you MUST also pass the --setVersion flag.
The multi flag performs a simultaneous release of multiple related packages.
--setVersion
See multi-package releases for details.
The --setVersion option allows you to set the version from the command line.
If the --setVersion option isn't passed then you will be prompted to select the version no.
--line
The --line option allows you to override the default line width (80) used when formatting code.
We recommend that you use the dart default width of 80.
--tags
By default pub_release runs every test that is not marked as 'skipped'.
You can limit the set of test by passing in the --tag option.
See the test guide for details on how to setup and select tests via tags.
--exclude-tags
By default pub_release runs every test that is not marked as 'skipped'.
You can exclude certain tests by passing in the --exclude-tags option.
See the test guide for details on how to setup and exclude tests via tags.
--multi
Performs a multi-package release.
Use the --multi flag when you have multiple related packages that need to be released in sync with a single version no.
Last updated