FlutterプロジェクトのSDK/パッケージの更新を自動チェックしたい...！

この記事は、【 可茂IT塾 Advent Calendar 2025 】の16日目の記事です。

💭 作ろうと思ったきっかけ

複数のFlutterプロジェクトを管理していると、依存関係の更新をチェックするのが意外と面倒です。定期的にflutter pub outdatedを実行して、どのパッケージが更新可能か確認して...という作業を手動でやるのは時間がかかります。

「GitHub Actionsで自動的にチェックして、更新があったらSlackに通知してくれたら楽だよなぁ」

そんな何気ない思いつきから、このツールを作りました。GitHub Actionsを使って定期実行し、更新が必要な場合にSlackに通知を送ることで、依存関係の管理を自動化できます。

Slack で更新可能なパッケージをサマリー通知

スレッド内に詳細Excelファイルを添付

更新可能なパッケージの詳細なバージョン情報を確認できる（Excel形式）

✨ 主要機能

GitHub Actionsを使用してFlutterプロジェクトの依存関係を自動チェックし、更新状況をSlackに通知

• Flutter SDKバージョンの更新チェック（.fvmrcファイルから取得）
• pubspec.yamlに記載されているパッケージの更新チェック
• 更新可能なパッケージがある場合、Slackに通知を送信
• Excelレポートの自動生成（リポジトリごとにシート分け）
• 定期実行（cron）による自動チェック
• 複数のFlutterプロジェクトを一度にチェック可能
• パッケージの更新状況を色分けで視覚的に表示（黒色、青色、赤色）

🛠 技術スタック

ツール

• GitHub Actions: 定期実行
• Slack Bot API: 通知送信とExcelファイルのアップロード
• Flutter CLI: 依存関係のチェック
• ExcelJS: Excelレポートの生成

必要な環境変数

GitHubリポジトリのSecretsに以下を設定する必要があります：

• SLACK_BOT_TOKEN: Slack Bot Token（files:writeスコープが必要）
• SLACK_CHANNEL_ID: 通知を送信するSlackチャンネルID
• GH_TOKEN: プライベートリポジトリにアクセスする場合のGitHub Token（オプション）

🔧 システム構成

1. GitHub Actionsがcronスケジュールに従って実行
2. 指定された複数のFlutterプロジェクトを順次チェック
3. 各プロジェクトの.fvmrcからFlutter SDKバージョンを取得
4. pubspec.yamlを解析してパッケージ情報を取得
5. パッケージの更新状況を判定（色分けルールに基づく）
6. Excelレポートを生成（リポジトリごとにシート分け）
7. 更新がある場合、Slackに通知を送信し、Excelファイルをスレッドに添付

🎨 Excelレポートの色分けルール

Excelレポートでは、パッケージの更新状況を色で視覚的に表示します。

パッケージの色分け

Flutter SDKの色分け

バージョン制約記号について

Flutterのpubspec.yamlでは、バージョン制約を指定する際に以下の記号を使用します：

• ^4.8.0: >=4.8.0 <5.0.0を意味します（4.8.0以上5.0.0未満）
• ~4.8.0: >=4.8.0 <4.9.0を意味します（4.8.0以上4.9.0未満）
• 4.8.0: 厳密に4.8.0のみ

重要なポイント: ^記号がある場合、更新は必須ではありませんが、更新可能なバージョンがあることを示します。

📦 使い方

1. リポジトリをクローンまたはテンプレートとして使用

このツールは個人プロジェクトとして開発しており、たまにメンテナンスしていこうと思っています。
そのため、フォークして使用してもらっても問題ありません。自分の環境に合わせてカスタマイズしたり、改善を加えたりして使っていただけます。

git clone https://github.com/vintage-tracker/flutter-dependency-checker.git

2. Slack Botの作成と設定

1. Slack APIで新しいアプリを作成
2. Bot Token Scopesに以下を追加：
   • chat:write（メッセージ送信）
   • files:write（Excelファイルのアップロード）
3. Botをチャンネルに招待（/invite @your-bot-name）

3. GitHubリポジトリのSecretsを設定

リポジトリのSettings > Secrets and variables > Actionsから以下を設定：

• SLACK_BOT_TOKEN: Slack Bot Token（xoxb-で始まる）
• SLACK_CHANNEL_ID: 通知を送信するSlackチャンネルID（Cで始まる）
• GH_TOKEN: プライベートリポジトリにアクセスする場合のGitHub Token（オプション）

4. チェック対象リポジトリの設定

repositories.jsonファイルを作成または編集して、チェックしたいFlutterプロジェクトのリポジトリ情報を指定します。

単一リポジトリの例：

{
  "repositories": [
    {
      "name": "example_app",
      "description": "サンプルFlutterアプリ",
      "url": "https://github.com/your-org/example_app"
    }
  ],
  "settings": {
    "includeDevDeps": true
  }
}

複数リポジトリの例：

{
  "repositories": [
    {
      "name": "example_app",
      "description": "メインアプリ",
      "url": "https://github.com/your-org/example_app"
    },
    {
      "name": "admin_dashboard",
      "description": "管理画面アプリ",
      "url": "https://github.com/your-org/admin_dashboard"
    },
    {
      "name": "shared_package",
      "description": "共通パッケージ",
      "url": "https://github.com/your-org/shared_package"
    }
  ],
  "settings": {
    "includeDevDeps": true
  }
}

• name: リポジトリの名前（識別用）
• description: リポジトリの説明（オプション）
• url: GitHubリポジトリのURL
• settings.includeDevDeps: 開発依存関係（dev_dependencies）もチェックするかどうか

5. 定期実行のスケジュールを設定

cron形式で実行スケジュールを設定できます。例：毎週月曜日の午前9時

on:
  schedule:
    - cron: '0 9 * * 1'

🔍 トラブルシューティング

Flutterバージョンが正しく表示されない

• チェック対象のリポジトリに.fvmrcファイルが存在するか確認
• .fvmrcファイルの形式が正しいか確認（flutter: "3.24.0"またはflutter: 3.24.0）
• pubspec.yamlのenvironmentセクションにFlutterバージョンが記載されているか確認

Excelファイルが送信されない

• Slack Botにfiles:writeスコープが設定されているか確認
• Botがチャンネルに参加しているか確認（/invite @your-bot-name）
• GitHub Actionsのログでエラーメッセージを確認

プライベートリポジトリにアクセスできない

• GH_TOKENシークレットが設定されているか確認
• GitHub Tokenにrepoスコープが付与されているか確認

GitHubリポジトリはこちら↓
https://github.com/vintage-tracker/flutter-dependency-checker