Quden Dev Doc

Appearance

Chrome拡張(v3)のリリース手順 ​

TIP

Chrome拡張(v3)のリリース手順について記したDocsです。 現在、拡張機能の審査提出は GitHub Actions で自動化されています。

対象リポジトリ: quden-chrome-extension-v3

リリース手順 ​

1. 機能を実装する ​

  • リリースしたい機能を実装し、PR を作成・マージする
  • バージョンは GitHub Actions 実行時に自動で更新されるため、手動での変更は不要

2. GitHub Actions でリリースを実行 ​

  1. GitHub Actions にアクセス
  2. "Publish to Chrome Web Store" ワークフローを選択
  3. "Run workflow" ボタンをクリック
  4. バージョン種別を選択:
    • patch: バグ修正など（例: 1.0.0 → 1.0.1）
    • minor: 新機能追加（例: 1.0.0 → 1.1.0）
    • major: 破壊的変更（例: 1.0.0 → 2.0.0）
  5. "Run workflow" で実行

3. 自動処理の内容 ​

GitHub Actions が以下を自動で実行します:

  1. バージョン番号の更新
  2. 拡張機能のビルド
  3. Chrome Web Store への審査提出
  4. Git タグの作成とプッシュ
  5. GitHub Release の作成

4. リリース完了 ​

  • 審査が通ると自動的に公開される
  • 反映には数分〜数時間かかる場合がある

リリース後作業 ​

  • #team_dev-quden でリリースが完了したことをシェア

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

"Browser platform publish" ステップでエラーが出る ​

以下のようなエラーが出ることがあります:

Error: ERROR | Error: chrome: Step 2) Item "eeadaochfaalhdgkgejdfalcpdddcpea" (Quden for Chrome)": Response code 400 (Bad Request)

原因: BPP_KEYS_2 として登録されている認証情報の期限切れ

対処方法:

  1. OAuth 2.0 クライアントシークレットを再発行

    • Google Cloud Console にアクセス
    • 該当プロジェクトの「APIとサービス」>「認証情報」を開く
    • 既存の OAuth 2.0 Client ID を選択
    • 「クライアントシークレットを追加」で新しいシークレットを発行

  2. Refresh Token を取得

  3. GitHub Secrets を更新

json
{
  "$schema": "https://raw.githubusercontent.com/plasmo-corp/bpp/v3/keys.schema.json",
  "chrome": {
    "zip": "build/chrome-mv3-prod.zip",
    "clientId": "Google Cloud から取得",
    "refreshToken": "上記手順で取得",
    "extId": "eeadaochfaalhdgkgejdfalcpdddcpea",
    "clientSecret": "Google Cloud から取得"
  }
}
  1. 再度 GitHub Actions を実行

WARNING

OAuth クライアント自体を新規作成する必要はありません。既存のクライアントに対して新しいクライアントシークレットを発行すればOKです。