flutter-pub-update

Flutter Pub Update

Overview

Flutterプロジェクトのpubspec.yaml依存パッケージを安全に更新するためのスキル。更新前に変更内容を確認し、メジャーバージョン変更時はユーザー確認を挟む。

使用方法

• /flutter-pub-update パッケージ名 - 指定パッケージを更新
• /flutter-pub-update パッケージ1 パッケージ2 - 複数パッケージを更新
• /flutter-pub-update --all - 全パッケージを一括更新

ワークフロー

Step 1: 現在の状態を確認

flutter pub outdated

出力から以下を把握:

• Current: 現在のバージョン
• Upgradable: pubspec.yaml制約内で更新可能なバージョン
• Resolvable: 制約を変更すれば更新可能なバージョン
• Latest: 最新バージョン

Step 2: 更新対象の特定

指定パッケージの場合: $ARGUMENTSで指定されたパッケージのみ対象

--allの場合: outdatedで表示された全パッケージを対象

Step 3: 各パッケージの更新差分を調査

対象パッケージごとにWebFetchツールを使用して変更内容を確認:

1. pub.devのChangelogを確認

   • URL: https://pub.dev/packages/{パッケージ名}/changelog
   • 現在バージョンから更新後バージョンまでの変更点を抽出

2. GitHubリリースノートを確認（必要に応じて）

   • pub.devのパッケージページからリポジトリURLを取得
   • リリースノートで詳細な変更内容を確認

3. 変更内容をまとめて報告

   • 新機能
   • バグ修正
   • Breaking Changes（重要）
   • 非推奨になった機能

Step 4: メジャーバージョン更新の確認

メジャーバージョンが変わる場合（例: 1.x.x → 2.x.x）:

1. Breaking Changesを明確に提示
2. 影響を受ける可能性のあるコードを説明
3. AskUserQuestionツールで更新の承認を確認

このパッケージはメジャーバージョンが変わります:
- {パッケージ名}: {現在バージョン} → {新バージョン}

Breaking Changes:
- [変更内容1]
- [変更内容2]

更新を続行しますか？

Step 5: パッケージの更新

承認後、flutter pub upgradeコマンドを使用:

指定パッケージの更新:

flutter pub upgrade パッケージ名

メジャーバージョンを含む更新:

flutter pub upgrade --major-versions パッケージ名

全パッケージの更新:

flutter pub upgrade

全パッケージのメジャーバージョン更新:

flutter pub upgrade --major-versions

Step 6: 更新結果の報告

更新完了後、以下を報告:

## 更新完了

| パッケージ | 旧バージョン | 新バージョン | 変更種別 |
|-----------|-------------|-------------|---------|
| xxx       | 1.0.0       | 1.2.0       | Minor   |
| yyy       | 2.0.0       | 3.0.0       | Major   |

### 主な変更点
- xxx: 新機能Aが追加
- yyy: APIが変更（要確認）

注意事項

• 自動生成ファイル（*.g.dart, *.freezed.dart）がある場合はflutter pub run build_runner build --delete-conflicting-outputsの実行を提案