pub publish

Learn to publish packages with pub publish.

dart pub publish

dart pub publish sends your package to pub.dev. First you do a trial with dart pub publish --dry-run; this lists issues before publishing.

Before publishing pubspec must have a description, a license and a README. pub.dev checks these; it blocks publishing if anything is missing.

Published versions cannot be undone; so raise the version number carefully. From 1.0.0 to 1.0.1 is a patch, to 1.1.0 a minor, to 2.0.0 a major change.

Publishing checklist

Before publishing pubspec must be complete: name, description, version and environment. You also need a LICENSE file and a README.md.

CHANGELOG.md lists the changes in each version. pub.dev shows it to readers and presents the version history clearly.

The first publish asks for email verification. Later publishes need only your Google account.

Exercise Package metadata

Import the library with import 'dart:convert';. In main print the result of jsonEncode({'package': 'hello', 'version': '1.0.0'}) with print.

Show example solution

import 'dart:convert';

void main() {
  print(jsonEncode({'package': 'hello', 'version': '1.0.0'}));
}

Test yourself

Dry run publish

dart pub publish --____

Show answer

dart pub publish --dry-run

What does dart pub publish --dry-run do?
- Checks without publishing
- Publishes the package
- Deletes the package
- Downgrades the version
Show answer

Checks without publishing — --dry-run checks without publishing.
Publishing parts

dart pub publish

Publishing
--dry-run

Dry run
LICENSE

License file
README.md

Readme file

Next lesson: Summary - Packages

We Are Enhancing Your Experience

Cookie Preferences

Strictly Necessary Cookies

Analytical Cookies