dart pub publish для pub.dev

Когда пакет готов, одна команда отправляет его в мир. Публикация размещает вашу библиотеку на pub.dev, и любой пользователь может добавить её в зависимости. 🌍

Задайте понятную версию в pubspec.yaml в соответствии с семантическим версионированием. Номера основной, дополнительной и исправляющей версий точно сообщают пользователям, что изменилось.

Каждому выпуску нужна соответствующая запись в CHANGELOG. Пользователи читают её, чтобы решить, стоит ли обновляться и как это сделать, поэтому описывайте изменения ясно.

Опубликованный пакет должен содержать файл LICENSE. Он сообщает пользователям об их юридических правах, а pub.dev автоматически распознаёт распространённые лицензии с открытым исходным кодом.

Запустите publish с флагом dry-run, чтобы проверить всё без загрузки. Он выявит отсутствующие файлы или предупреждения, пока исправления ещё не требуют больших затрат.

При первой публикации откроется браузер для входа. pub.dev свяжет загрузку с вашей учётной записью, а позже вы сможете добавить других пользователей как тех, кто выполняет загрузку.

Если пробный запуск завершился без проблем, уберите флаг и опубликуйте пакет. Команда publish загружает ваши файлы и делает версию доступной в течение нескольких секунд.

После публикации версию нельзя удалить — её можно только отозвать, чтобы не допустить нового использования. Внимательно проверьте файлы: ошибка навсегда останется в истории.

Не включайте секреты и ненужные файлы в загрузку. Dart не включает файлы, соответствующие вашему .gitignore, поэтому аккуратная работа с коммитами помогает сохранить чистоту опубликованного архива.

Публикуйте пакет от имени проверенного издателя, связанного с принадлежащим Вам доменом. Такой значок повышает доверие и объединяет все Ваши пакеты под одной учётной записью. 🛡️

При каждом обновлении увеличивайте версию, добавляйте запись в CHANGELOG, повторно запускайте проверки, а затем снова публикуйте пакет. Этот отлаженный цикл будет повторяться всегда.

Вы научились указывать версии, вести журнал изменений, добавлять лицензию, выполнять пробный запуск и наконец публиковать пакет командой dart pub publish. Теперь Ваш пакет стал частью экосистемы. 🎉