|
| 1 | +# Backlogアプリケーションのリリース方法 |
| 2 | + |
| 3 | +このドキュメントでは、Backlogアプリケーションのビルドとリリース配布方法について説明します。 |
| 4 | + |
| 5 | +## リリース準備 |
| 6 | + |
| 7 | +### 1. バージョン更新 |
| 8 | + |
| 9 | +リリース前に`package.json`のバージョンを更新します: |
| 10 | + |
| 11 | +```bash |
| 12 | +# package.jsonのバージョンを手動で更新するか、npm versionコマンドを使用 |
| 13 | +npm version patch # パッチバージョンを上げる |
| 14 | +npm version minor # マイナーバージョンを上げる |
| 15 | +npm version major # メジャーバージョンを上げる |
| 16 | +``` |
| 17 | + |
| 18 | +### 2. SEAバイナリのビルド |
| 19 | + |
| 20 | +```bash |
| 21 | +# 必要なパッケージをインストール |
| 22 | +npm install |
| 23 | + |
| 24 | +# ビルドスクリプトを実行 |
| 25 | +npm run build # TypeScriptのビルド |
| 26 | + |
| 27 | +# macOS向けビルド |
| 28 | +node scripts/sea-mac.js |
| 29 | + |
| 30 | +# Windows向けビルド |
| 31 | +node scripts/sea-windows.js |
| 32 | +``` |
| 33 | + |
| 34 | +ビルドが成功すると、以下のディレクトリとファイルが生成されます: |
| 35 | + |
| 36 | +#### macOS向け(`dist/macos`ディレクトリ) |
| 37 | +- `advanced-backlog-mcp` - macOS用実行可能なSEAバイナリ |
| 38 | +- `advanced-backlog-mcp.blob` - SEAブロブファイル |
| 39 | +- `sea-bundle.js` - バンドルされたJavaScriptファイル |
| 40 | +- `sea-config.json` - SEA設定ファイル |
| 41 | + |
| 42 | +#### Windows向け(`dist/windows`ディレクトリ) |
| 43 | +- `advanced-backlog-mcp.exe` - Windows用実行可能なSEAバイナリ |
| 44 | +- `advanced-backlog-mcp.blob` - SEAブロブファイル |
| 45 | +- `sea-bundle.js` - バンドルされたJavaScriptファイル |
| 46 | +- `sea-config.json` - SEA設定ファイル |
| 47 | + |
| 48 | +## GitHubリリースの作成 |
| 49 | + |
| 50 | +### 1. 変更をコミットしてプッシュ |
| 51 | + |
| 52 | +```bash |
| 53 | +git add . |
| 54 | +git commit -m "Release vX.Y.Z" |
| 55 | +git push origin main |
| 56 | +``` |
| 57 | + |
| 58 | +### 2. Gitタグを作成 |
| 59 | + |
| 60 | +```bash |
| 61 | +git tag vX.Y.Z |
| 62 | +git push origin vX.Y.Z |
| 63 | +``` |
| 64 | + |
| 65 | +### 3. GitHubリリースの作成 |
| 66 | + |
| 67 | +1. GitHubリポジトリページにアクセス |
| 68 | +2. 「Releases」タブをクリック |
| 69 | +3. 「Draft a new release」ボタンをクリック |
| 70 | +4. 作成したタグを選択(例:`vX.Y.Z`) |
| 71 | +5. リリースタイトルを入力(例:「Backlog v1.0.0」) |
| 72 | +6. リリースノートを記入(変更点や新機能などを説明) |
| 73 | +7. ビルドされたバイナリをドラッグ&ドロップしてアップロード |
| 74 | + - macOS用: `dist/macos/advanced-backlog-mcp` |
| 75 | + - Windows用: `dist/windows/advanced-backlog-mcp.exe` |
| 76 | +8. 「Publish release」ボタンをクリック |
| 77 | + |
| 78 | +## ユーザーのインストール方法 |
| 79 | + |
| 80 | +リリースページから配布されたバイナリをインストールする方法をユーザーに案内します: |
| 81 | + |
| 82 | +### macOSユーザー向け |
| 83 | + |
| 84 | +TBD |
| 85 | + |
| 86 | +### Windowsユーザー向け |
| 87 | + |
| 88 | +TBD |
| 89 | + |
| 90 | +## リリース自動化(オプション) |
| 91 | + |
| 92 | +GitHub Actionsを使用してリリースプロセスを自動化することも可能です。以下の手順で設定できます: |
| 93 | + |
| 94 | +1. `.github/workflows/release.yml`ファイルを作成 |
| 95 | +2. ワークフローを設定して、タグプッシュ時に自動的にビルドとリリースを行う |
| 96 | +3. クロスプラットフォームビルドを設定して、各OS向けバイナリを生成 |
| 97 | + |
| 98 | +詳細な設定方法については、GitHub Actionsのドキュメントを参照してください。 |
0 commit comments