Lint、フォーマット、pana スコア

公開前に、Dart のツールでコードを自動的に整えましょう。Quality checks によって問題を早期に発見でき、パッケージをプロフェッショナルな仕上がりにできます。🧹

dart format コマンドは、ファイルを公式のスタイルに合わせて書き換えます。スペースや改行がすぐに統一されるため、フォーマットに関する議論も不要になります。

dart analyze を実行すると、コードを動かさずにエラー、警告、リスクのあるパターンを見つけられます。疲れを知らない丁寧なレビュアーのようにコードを検査します。

analysis_options.yaml ファイルで適用する lint ルールを管理します。より厳しいチェックを有効にしたり、プロジェクトに合わないルールを緩和したりできます。

lint はスタイルや正しさに関する提案であり、必ず直す必要があるエラーではありません。推奨される lint に従うと、慣用的で読みやすいコードになります。

ほとんどのパッケージでは lints パッケージを追加し、推奨ルールセットを選びます。analysis_options に1行追加するだけで、コミュニティに信頼されたルール一覧を利用できます。

pana ツールは、pub.dev がパッケージを評価する方法をそのまま再現します。ローカルで実行すれば、ほかの人に見られる前に評価を確認できます。

pub points は、規約への準拠、API のドキュメント化、解析の成功、プラットフォーム対応などを評価します。各カテゴリの点数が合計され、公開スコアになります。

警告が0件のクリーンな analyze 結果を目指します。pana は問題があると点数を減点するため、問題を解消すれば表示スコアを直接上げられます。

CI パイプラインで format、analyze、テストを実行します。すべての push を同じ方法で検証できるため、問題がリリースに入り込むことを防げます。🤖

公開直前に、format、analyze、test、pana をまとめて実行します。この簡単な checklist により、アップロード時の予想外の問題を、落ち着いて予測可能なリリースへと変えられます。

これで format、analyze、lint を実行し、pana で pub points を事前に確認できるようになりました。今日コードをきれいにすれば、明日のスコアが上がります。✅