---
name: App Release
slug: app-release
category: DevOps
description: App Release automates version bumps, CHANGELOG updates, and release tagging for Flutter apps. Use it when asked to release, bump the version, or publish iOS, Android, desktop, or all platforms.
github: "https://github.com/K9i-0/ccpocket/tree/main/.claude/skills/release-app"
language: Dart
stars: 1039
forks: 97
install: "npx degit https://github.com/K9i-0/ccpocket/tree/main/.claude/skills/release-app ~/.claude/skills/release-app"
installs_to: ~/.claude/skills/release-app
source_path: .claude/skills/release-app/SKILL.md
collection_size: 18
category_size: 798
collection_url: "https://dirskills.com/collections/K9i-0/ccpocket"
added: 2026-08-21T05:14:05.752Z
last_synced: 2026-08-21T05:14:05.752Z
canonical_url: "https://dirskills.com/skills/app-release"
---

# App Release

App Release automates version bumps, CHANGELOG updates, and release tagging for Flutter apps. Use it when asked to release, bump the version, or publish iOS, Android, desktop, or all platforms.

**Install:**

```bash
npx degit https://github.com/K9i-0/ccpocket/tree/main/.claude/skills/release-app ~/.claude/skills/release-app
```

## README

# アプリ リリース

Flutter アプリのリリースを行う。
タグ push 後は GH Actions が自動でビルド・署名・配布・GitHub Release を作成する。

## 前提

- main ブランチで作業中であること
- 未コミットの変更がないこと

## 手順

### 1. 現在のバージョン確認 & 変更内容の収集

```bash
grep '^version:' apps/mobile/pubspec.yaml
```

`version: X.Y.Z+N` の形式。`+N` は build number。

前回リリースからの差分を確認する:

```bash
# 前回のタグ（iOS/Android/macOS/Linux/Windows のいずれか新しい方）
git tag -l 'ios/v*' 'android/v*' 'macos/v*' 'linux/v*' 'windows/v*' --sort=-v:refname | head -1

# 差分コミット（bridge 以外）
git log $(git tag -l 'ios/v*' 'android/v*' 'macos/v*' 'linux/v*' 'windows/v*' --sort=-v:refname | head -1)..HEAD --oneline -- apps/mobile/ CHANGELOG.md
```

### 2. バージョンとプラットフォームをユーザーに確認

差分コミットの内容を分析し、AskUserQuestion で **2つの質問を同時に** 確認する。

#### 質問 1: バージョン

**選択肢の決定ルール:**
- `feat` コミットがある → **minor** を推奨（1番目の選択肢にし「(Recommended)」を付ける）
- `feat` がなく `fix` のみ → **patch** を推奨
- 破壊的変更がある → **major** を推奨

選択肢は具体的なバージョン番号で提示する（例: 「1.20.0+43 (minor)」「1.19.1+43 (patch)」）。
build number は現在の値 +1 で統一する。

#### 質問 2: プラットフォーム

以下の選択肢を提示する:
- **iOS + Android + macOS + Linux + Windows 全部** (Recommended)
- **iOS + Android のみ**（モバイルのみ）
- **macOS + Linux + Windows のみ**（デスクトップのみ）
- **macOS のみ**
- **Linux のみ**
- **Windows のみ**
- **iOS のみ**
- **Android のみ**

### 3. CHANGELOG 更新

`CHANGELOG.md`（ルート）の先頭に新しいセクションを追加する。

```markdown
## [X.Y.Z] - YYYY-MM-DD

### Added
- ...

### Changed
- ...

### Fixed
- ...
```

ステップ 1 で確認したコミットを元に、Added / Changed / Fixed に分類する。
空のセクション（該当なし）は省略する。

### 4. バージョン bump

`apps/mobile/pubspec.yaml` の `version` をステップ 2 で決定したバージョンに更新する。

### 5. ローカル検証

タグ push 前に、CD と同じチェックをローカルで実行する。
**すべて pass しなければ次のステップに進まない。**

```bash
# 静的解析
dart analyze apps/mobile

# テスト
cd apps/mobile && flutter test
```

失敗した場合はユーザーに報告し、修正を待つ。

### 6. コミット & タグ

```bash
git add apps/mobile/pubspec.yaml CHANGELOG.md
git commit -m "chore: bump version to X.Y.Z+N"
git push origin main
```

ステップ 2 で選択されたプラットフォームのタグを打つ:

```bash
# iOS（選択された場合）
git tag ios/vX.Y.Z+N
git push origin ios/vX.Y.Z+N

# Android（選択された場合）
git tag android/vX.Y.Z+N
git push origin android/vX.Y.Z+N

# macOS（選択された場合）
git tag macos/vX.Y.Z+N
git push origin macos/vX.Y.Z+N

# Linux（選択された場合）
git tag linux/vX.Y.Z+N
git push origin linux/vX.Y.Z+N

# Windows（選択された場合）
git tag windows/vX.Y.Z+N
git push origin windows/vX.Y.Z+N
```

### 7. 完了確認

タグ push 後、GH Actions が自動実行される:

| タグ | ワークフロー | 内容 |
|-----|------------|------|
| `ios/v*` | `ios-release.yml` | Shorebird release iOS → TestFlight → GitHub Release |
| `android/v*` | `android-release.yml` | Shorebird release Android → Google Play (internal draft) → GitHub Release |
| `macos/v*` | `macos-release.yml` | Developer ID 署名 → 公証 → DMG → GitHub Release |
| `linux/v*` | `linux-release.yml` | Linux release build → Xvfb smoke → tar.gz → GitHub Release |
| `windows/v*` | `windows-release.yml` | Windows release build → smoke → zip → GitHub Release |

```bash
# 各プラットフォームのワークフロー確認（タグを打ったもののみ）
gh run list --workflow=ios-release.yml --limit 1
gh run list --workflow=android-release.yml --limit 1
gh run list --workflow=macos-release.yml --limit 1
gh run list --workflow=linux-release.yml --limit 1
gh run list --workflow=windows-release.yml --limit 1
```

選択した全プラットフォームの CD が `completed/success` になるまで確認を継続する。
失敗した場合は `gh run view <run-id> --log-failed` で原因を確認し、修正後に再実行する。

#### 待機の目安

リリース CD は Shorebird release、署名、公証、ストア配布を含むため、通常 15 分前後かかる。
タグ push 直後から `gh run watch` で張り付くと出力が大きくなりやすいので、効率よく待つ場合は低頻度ポーリングにする。

推奨:

```bash
# 起動確認
gh run list --workflow=ios-release.yml --limit 1
gh run list --workflow=android-release.yml --limit 1
gh run list --workflow=macos-release.yml --limit 1
gh run list --workflow=linux-release.yml --limit 1
gh run list --workflow=windows-release.yml --limit 1

# 10〜15分ほど待ってから再確認
gh run list --workflow=ios-release.yml --limit 1
gh run list --workflow=android-release.yml --limit 1
gh run list --workflow=macos-release.yml --limit 1
gh run list --workflow=linux-release.yml --limit 1
gh run list --workflow=windows-release.yml --limit 1
```

途中確認する場合も 2〜3 分間隔を目安にする。`failure` / `cancelled` が出た場合だけ `gh run view <run-id> --log-failed` で詳細を確認する。

#### CD 成功までのポーリング

タグを打った workflow だけを対象に、成功するまでループする。以下の例では全プラットフォームを確認するが、実行していない workflow は `release_tags` から外す。

```bash
version="X.Y.Z+N"
declare -A release_tags=(
  [ios-release.yml]="ios/v${version}"
  [android-release.yml]="android/v${version}"
  [macos-release.yml]="macos/v${version}"
  [linux-release.yml]="linux/v${version}"
  [windows-release.yml]="windows/v${version}"
)

while true; do
  all_success=true
  for workflow in "${!release_tags[@]}"; do
    tag="${release_tags[$workflow]}"
    run_json=$(gh run list --workflow="$workflow" --branch="$tag" --limit 1 --json databaseId,status,conclusion,url)
    status=$(echo "$run_json" | jq -r '.[0].status')
    conclusion=$(echo "$run_json" | jq -r '.[0].conclusion')
    run_id=$(echo "$run_json" | jq -r '.[0].databaseId')
    url=$(echo "$run_json" | jq -r '.[0].url')

    echo "$workflow ($tag): $status/$conclusion $url"

    if [ "$status" = "completed" ] && [ "$conclusion" = "success" ]; then
      continue
    fi

    all_success=false
    if [ "$status" = "completed" ]; then
      gh run view "$run_id" --log-failed
      exit 1
    fi
  done

  if [ "$all_success" = true ]; then
    echo "All selected release workflows completed successfully."
    break
  fi

  sleep 180
done
```