dart pub publish で pub.dev に公開

パッケージの準備ができたら、1つのコマンドで世界に公開できます。Publishing によってライブラリが pub.dev に掲載され、誰でも依存関係として利用できるようになります。🌍

セマンティックバージョニングに従い、pubspec.yaml に明確な version を設定します。メジャー、マイナー、パッチの番号によって、変更の大きさをユーザーに正確に伝えられます。

リリースごとに、対応する項目を CHANGELOG に追加します。ユーザーはアップグレードするかどうか、またどのようにアップグレードするかを判断するために読むので、変更内容を明確に説明してください。

公開するパッケージには LICENSE ファイルを含める必要があります。ユーザーが持つ法的な権利を示すもので、pub.dev は一般的なオープンソースライセンスを自動的に認識します。

dry-run フラグを付けて publish を実行すると、アップロードせずにすべてを検証できます。修正が容易なうちに、ファイル不足や警告を見つけられます。

初めて公開するときは、ブラウザーが開いてサインインを求められます。pub.dev はアップロードを account に関連付け、後からほかのユーザーをアップローダーとして追加できます。

ドライランに問題がなければ、フラグを外して公開します。publish コマンドがファイルをアップロードし、数秒以内にそのバージョンが利用可能になります。

一度公開されると、バージョンは削除できず、新たな利用を控えてもらうために撤回することしかできません。ファイルを再確認してください。ミスは履歴に残り続けます。

アップロード対象に秘密情報や不要なファイルを含めないようにします。Dart は.gitignoreに一致するファイルを無視するため、コミットを適切に管理しておくと、公開するアーカイブをクリーンに保てます。

ご自身が所有するドメインに紐付いた認証済みパブリッシャーとして公開してください。バッジによって信頼性が高まり、すべてのパッケージを1つのアイデンティティの下にまとめられます。🛡️

更新するたびにバージョンを上げ、CHANGELOG の項目を追加し、チェックを再実行してから、もう一度公開してください。このスムーズなサイクルを今後も繰り返します。

実際にパッケージをアップロードする前に行う、安全な最初の手順は何ですか？

バージョンを付け、CHANGELOG を更新し、ライセンスを設定し、dry-run を実行して、最後に dart pub publish を実行する方法を学びました。これで、パッケージはエコシステムの一部になりました。🎉