GitHub Actions｜iOS App CI/CD 自動化構築でビルドからデプロイまで最速実現

name: app-ci-cd-github-actions-demo
options:
  bundleIdPrefix: com.example
  deploymentTarget:
    iOS: '13.0'
  usesTabs: false
  indentWidth: 2
  tabWidth: 2

configs:
  Debug: debug
  Release: release

targets:
  app-ci-cd-github-actions-demo:
    type: application
    platform: iOS
    sources:
      - app-ci-cd-github-actions-demo
    resources:
      - app-ci-cd-github-actions-demo/Assets.xcassets
      - app-ci-cd-github-actions-demo/Base.lproj
    info:
      path: app-ci-cd-github-actions-demo/Info.plist
      properties:
        CFBundleIdentifier: $(PRODUCT_BUNDLE_IDENTIFIER)
    settings:
      base:
        PRODUCT_BUNDLE_IDENTIFIER: com.test.appcicdgithubactionsdemo
    cocoapods: true

  app-ci-cd-github-actions-demoTests:
    type: bundle.unit-test
    platform: iOS
    sources:
      - app-ci-cd-github-actions-demoTests
    dependencies:
      - target: app-ci-cd-github-actions-demo
    info:
      path: app-ci-cd-github-actions-demoTests/Info.plist
    settings:
      base:
        PRODUCT_BUNDLE_IDENTIFIER: com.test.appcicdgithubactionsdemo.tests

  app-ci-cd-github-actions-demoUITests:
    type: bundle.ui-testing
    platform: iOS
    sources:
      - app-ci-cd-github-actions-demoUITests
    dependencies:
      - target: app-ci-cd-github-actions-demo
    info:
      path: app-ci-cd-github-actions-demoUITests/Info.plist
    settings:
      base:
        PRODUCT_BUNDLE_IDENTIFIER: com.test.appcicdgithubactionsdemo.uitests

  app-ci-cd-github-actions-demoSnapshotTests:
    type: bundle.unit-test
    platform: iOS
    sources:
      - path: app-ci-cd-github-actions-demoSnapshotTests
        excludes:
          - "**/__Snapshots__/**"
    dependencies:
      - target: app-ci-cd-github-actions-demo
      - product: SnapshotTesting
        package: SnapshotTesting
    info:
      path: app-ci-cd-github-actions-demoSnapshotTests/Info.plist
      settings:
        base:
          PRODUCT_BUNDLE_IDENTIFIER: com.test.appcicdgithubactionsdemo.snapshottests

packages:
  SnapshotTesting:
    url: https://github.com/pointfreeco/swift-snapshot-testing
    from: 1.18.4

# ワークフロー（Action）名
name: CI-Testing

# Actions ログのタイトル名
run-name: "[CI-Testing] ${{ github.event.pull_request.title \\|\\| github.ref }}"

# 同じ Concurrency Group に新しいジョブがある場合、実行中のものをキャンセルする
# 例：Push Commit トリガーのジョブがまだ実行されているときに再度 Push Commit された場合、前のジョブをキャンセル
concurrency:
  group: ${{ github.workflow }}-${{ github.event_name }}-${{ github.event.pull_request.number \\|\\| github.ref }}
  cancel-in-progress: true

# トリガーイベント
on:
  # PR イベント
  pull_request:
    # PR - オープン、再オープン、新しい Push Commit 時
    types: [opened, synchronize, reopened]
  # 手動トリガー
  workflow_dispatch:
    # 入力フォームのフィールド
    inputs:
      # 実行するテスト Fastlane レーン
      TEST_LANE:
        description: 'Test Lane'
        default: 'run_unit_tests'
        type: choice
        options:
          - run_unit_tests
          - run_all_tests
  # 他のワークフローからの呼び出しによるトリガー
  # Nightly Build で使用
  workflow_call:
    # 入力フォームのフィールド
    inputs:
      # 実行するテスト Fastlane レーン
      TEST_LANE:
        description: 'Test Lane'
        default: 'run_unit_tests'
        # workflow_call inputs は choice をサポートしない
        type: string
      BRANCH:
        description: 'Branch'
        type: string
  
# ジョブ
# ジョブは並行実行される
jobs:
  # ジョブID
  testing:
    # ジョブ名（省略可能だがログ表示用に設定推奨）
    name: Testing
    
    # ランナーラベル - GitHub Hosted Runner macos-15 を使用
    # 注意：このプロジェクトは Public Repo のため無料で無制限に利用可能
    # 注意：このプロジェクトは Public Repo のため無料で無制限に利用可能
    # 注意：このプロジェクトは Public Repo のため無料で無制限に利用可能
    # Private Repo の場合は従量課金、macOS マシンは最も高価（10倍）で、10回実行で2000分無料上限に達する可能性あり
    # self-hosted Runner の使用を推奨
    runs-on: macos-15

    # 最大タイムアウト時間を設定し、異常時の無限待機を防止
    timeout-minutes: 30

    # zsh を使用
    # 省略可能。私は zsh を好むため設定。デフォルトは bash
    defaults:
      run:
        shell: zsh {0}
          
    # ステップ
    # ステップは順番に実行される  
    steps:
      # git clone とチェックアウト
      - name: Checkout repository
        uses: actions/checkout@v3
        with:
          # Git Large File Storage はテスト環境で不要
          # default: false
          lfs: false
          
          # 指定があればそのブランチをチェックアウト、なければデフォルト（現在のブランチ）
          # on: schedule は main ブランチのみ実行のため、Nightly Build 等はブランチ指定が必要
          # 例：on: schedule -> main ブランチ、Nightly Build は master ブランチ
          ref: ${{ github.event.inputs.BRANCH \\|\\| '' }}

      # ========== 環境セットアップステップ ==========
      
      # プロジェクト指定の Xcode バージョンを読み込み
      # 後続で手動で Xcode_x.x.x.app を指定し使用
      # xcversion は非推奨で不安定のため使用しない
      - name: Read .xcode-version
        id: read_xcode_version
        run: \\|
          XCODE_VERSION=$(cat .xcode-version)
          echo "XCODE_VERSION: ${XCODE_VERSION}"
          echo "xcode_version=${XCODE_VERSION}" >> $GITHUB_OUTPUT

          # ここでグローバルに Xcode バージョンを指定することも可能（後続で DEVELOPER_DIR 指定不要）
          # ただし sudo 権限が必要。self-hosted runner の場合は実行環境に sudo 権限があることを確認
          # sudo xcode-select -s "/Applications/Xcode_${XCODE_VERSION}.app/Contents/Developer"

      # プロジェクト指定の Ruby バージョンを読み込み
      - name: Read .ruby-version
        id: read_ruby_version
        run: \\|
          RUBY_VERSION=$(cat .ruby-version)
          echo "RUBY_VERSION: ${RUBY_VERSION}"
          echo "ruby_version=${RUBY_VERSION}" >> $GITHUB_OUTPUT

      # Runner の Ruby バージョンをプロジェクト指定バージョンに設定
      - name: Set up Ruby
        uses: ruby/setup-ruby@v1
        with:
          ruby-version: "${{ steps.read_ruby_version.outputs.ruby_version }}"

      # 設定してもしなくても良い（self-hosted で複数 Runner を同時起動すると cocoapods repos が共有ディレクトリで競合する可能性があるため）
      # 問題：同時に pod install 実行時に cocoapods repos の競合が起きる場合がある（デフォルトは $HOME/.cocoapods/）
      # GitHub Hosted Runner では不要
      # - name: Change Cocoapods Repos Folder
      #   if: contains(runner.labels, 'self-hosted')
      #   run: \\|
      #     # 各 Runner ごとに専用の .cocoapods フォルダを使いリソース競合を防止
      #     mkdir -p "$HOME/.cocoapods-${{ env.RUNNER_NAME }}/"
      #     export CP_HOME_DIR="$HOME/.cocoapods-${{ env.RUNNER_NAME }}"
      #     rm -f "$HOME/.cocoapods-${{ env.RUNNER_NAME }}/repos/cocoapods/.git/index.lock"

      # ========== キャッシュ設定ステップ ==========
      # self-hosted でもキャッシュはクラウドキャッシュで容量計算される
      # ルール：7日間未使用で自動削除、1キャッシュ最大10GB、Action 成功時のみキャッシュ
      # Public Repo: 無制限無料
      # Private Repo: 5GBから
      # Self-hosted は独自のシェルスクリプトや他ツールでキャッシュ管理可能
      
      # Bundle キャッシュ (Gemfile)
      # Makefile で Bundle インストール先を ./vendor に指定している対応
      - name: Cache Bundle
        uses: actions/cache@v3
        with:
          path: \\|
            ./vendor
          key: ${{ runner.os }}-bundle-${{ hashFiles('Gemfile.lock') }}
          restore-keys: \\|
            ${{ runner.os }}-bundle-

      # CocoaPods キャッシュ (Podfile)
      # デフォルトは プロジェクト/Pods 下
      - name: Cache CocoaPods
        uses: actions/cache@v3
        with:
          path: \\|
            ./Product/Pods
          key: ${{ runner.os }}-cocoapods-${{ hashFiles('Product/Podfile.lock') }}
          restore-keys: \\|
            ${{ runner.os }}-cocoapods-

      # Mint キャッシュ
      # Makefile で Mint インストール先を ./mint に指定している対応
      - name: Cache Mint
        uses: actions/cache@v3
        with:
          path: ./mint
          key: ${{ runner.os }}-mint-${{ hashFiles('Mintfile') }}
          restore-keys: \\|
            ${{ runner.os }}-mint-

      # ====================

      # プロジェクトセットアップ＆依存関係インストール
      - name: Setup & Install Dependency
        run: \\|
          # Makefile にまとめた Setup コマンドを実行（例）
          # brew install mint
          # bundle config set path 'vendor/bundle'
          # bundle install
          # mint bootstrap
          # ...
          make setup

          # Makefile にまとめた Install コマンドを実行（例）
          # mint run yonaskolb/XcodeGen --quiet
          # bundle exec pod install
          # ...
          make install

      # Fastlane のユニットテストレーンを実行
      - name: Run Tests
        id: testing
        # 作業ディレクトリを指定し、以降のコマンドで cd 省略可能に
        working-directory: ./Product/
        env:
          # テストプラン：全テスト実行か単体テストのみか
          # PR トリガーなら run_unit_tests、そうでなければ inputs.TEST_LANE の値（デフォルト run_all_tests）
          TEST_LANE: ${{ github.event_name == 'pull_request' && 'run_unit_tests' \\|\\| github.event.inputs.TEST_LANE \\|\\| 'run_all_tests' }}
          
          # このジョブで使う Xcode バージョンを指定
          DEVELOPER_DIR: "/Applications/Xcode_${{ steps.read_xcode_version.outputs.xcode_version }}.app/Contents/Developer"
          
          # Repo -> Settings -> Actions secrets and variables -> variables
          # 使用するシミュレーター名
          SIMULATOR_NAME: ${{ vars.SIMULATOR_NAME }}
          # シミュレーターの iOS バージョン
          SIMULATOR_IOS_VERSION: ${{ vars.SIMULATOR_IOS_VERSION }}

          # 現在の Runner 名称
          RUNNER_NAME: ${{ runner.name }}
          
          # Xcodebuild コマンドのタイムアウト時間とリトライ回数を増やす
          # マシンの負荷が高いと3回で失敗することがあるため
          FASTLANE_XCODEBUILD_SETTINGS_TIMEOUT: 60
          FASTLANE_XCODEBUILD_SETTINGS_RETRIES: 10
        run: \\|

          # self-hosted で同一マシンに複数 Runner を起動するとシミュレーター競合が発生（後述）
          # 競合回避のため、シミュレーター名を Runner 名にして各 Runner に専用シミュレーターを割り当てるのが推奨
          # 例）bundle exec fastlane run_unit_tests device:"${RUNNER_NAME} (${SIMULATOR_IOS_VERSION})"
          # ここは GitHub Hosted Runner なので問題なく直接 device:"${SIMULATOR_NAME} (${SIMULATOR_IOS_VERSION})" を使用

          # エラー発生時も即終了せず、全出力を temp/testing_output.txt に記録
          # 後で内容を解析し Build Failed か Test Failed か判別し、PR に異なるコメントを投稿
          set +e
          
          # EXIT_CODE に実行結果の exit code を格納
          # 0 = 正常終了
          # 1 = 異常終了
          EXIT_CODE=0
          
          # 全出力をファイルに書き込み
          bundle exec fastlane ${TEST_LANE} device:"${SIMULATOR_NAME} (${SIMULATOR_IOS_VERSION})" \\| tee "$RUNNER_TEMP/testing_output.txt"
          # 現在 EXIT_CODE が0なら、${PIPESTATUS[0]}（fastlane 実行結果）を設定
          [[ $EXIT_CODE -eq 0 ]] && EXIT_CODE=${PIPESTATUS[0]}

          # エラー時は終了モードに戻す
          set -e

          # テスト出力の解析
          # "Error building" があれば is_build_error=true を Actions 環境変数に設定しビルド失敗扱い
          # "Tests have failed" があれば is_test_error=true を設定しテスト失敗扱い
          
          if grep -q "Error building" "$RUNNER_TEMP/testing_output.txt"; then
            echo "is_build_error=true" >> $GITHUB_OUTPUT
            echo "❌ Detected Build Error"
          elif grep -q "Tests have failed" "$RUNNER_TEMP/testing_output.txt"; then
            echo "is_test_error=true" >> $GITHUB_OUTPUT
            echo "❌ Detected Test Error"
          fi

          # exit code を復元して終了
          exit $EXIT_CODE
          
      # ========== 結果処理ステップ ==========
      
      # *.junit テストレポートを解析し結果をマーク、PR ならコメントも投稿
      - name: Publish Test Report
        # 他者作成の .junit パーサー Actions を利用：https://github.com/mikepenz/action-junit-report
        uses: mikepenz/action-junit-report@v5
        # if:
        # 前ステップ（Testing）が成功または
        # 前ステップが失敗かつ is_test_error（ビルド失敗はここをスキップ）
        if: ${{ (failure() && steps.testing.outputs.is_test_error == 'true') \\|\\| success() }}
        with:
          check_name: "Testing Report"
          comment: true
          updateComment: false
          require_tests: true
          detailed_summary: true
          report_paths: "./Product/fastlane/test_output/*.junit"

      # ビルド失敗時のコメント投稿
      - name: Build Failure Comment
        # if:
        # 前ステップ（Testing）が失敗かつ is_build_error かつ PR 番号がある場合
        if: ${{ failure() && steps.testing.outputs.is_build_error == 'true' && github.event.pull_request.number }}
        uses: actions/github-script@v6
        env:
          action_url: "${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}/attempts/${{ github.run_attempt }}"
        with:
            script: \\|
              const action_url = process.env.action_url
              const pullRequest = context.payload.pull_request \\|\\| {}
              const commitSha = pullRequest.head?.sha \\|\\| context.sha
              const creator = pullRequest.user?.login \\|\\| context.actor
        
              const commentBody = [
                `# プロジェクトまたはテストのビルド失敗 ❌`,
                `Pull Request が正しくビルド・テスト実行できるかご確認ください。`,
                ``,
                `🔗 **Action**: [View Workflow Run](${action_url})`,
                `📝 **Commit**: ${commitSha}`,
                `👤 **Author**: @${creator}`
              ].join('\n')
        
              await github.rest.issues.createComment({
                owner: context.repo.owner,
                repo: context.repo.repo,
                issue_number: context.payload.pull_request.number,
                body: commentBody
              })

# ワークフロー（Action）名
name: CD-Deploy

# Actions ログのタイトル名
run-name: "[CD-Deploy] ${{ github.ref }}"

# 同じ Concurrency Group に新しいジョブがある場合、実行中のものをキャンセルする
# 例：同じブランチのビルドジョブが重複トリガーされた場合、前のジョブをキャンセルする
concurrency:
  group: ${{ github.workflow }}-${{ github.event_name }}-${{ github.ref }}
  cancel-in-progress: true

# トリガーイベント
on:
  # 手動フォームトリガー
  workflow_dispatch:
    # フォームの入力項目
    inputs:
      # アプリのバージョン番号
      VERSION_NUMBER:
        description: 'アプリのバージョン番号（例：1.0.0）。空欄の場合はXcodeプロジェクトから自動検出します。'
        required: false
        type: string
      # アプリのビルド番号
      BUILD_NUMBER:
        description: 'アプリのビルド番号（例：1）。空欄の場合はタイムスタンプを使用します。'
        required: false
        type: string
      # アプリのリリースノート
      RELEASE_NOTE:
        description: 'デプロイのリリースノート。'
        required: false
        type: string
  # 他のワークフローからの呼び出しトリガー
  # Nightly Buildで使用
  workflow_call:
    inputs:
      # アプリのバージョン番号
      VERSION_NUMBER:
        description: 'アプリのバージョン番号（例：1.0.0）。空欄の場合はXcodeプロジェクトから自動検出します。'
        required: false
        type: string
      # アプリのビルド番号
      BUILD_NUMBER:
        description: 'アプリのビルド番号（例：1）。空欄の場合はタイムスタンプを使用します。'
        required: false
        type: string
      # アプリのリリースノート
      RELEASE_NOTE:
        description: 'デプロイのリリースノート。'
        required: false
        type: string
      BRANCH:
        description: 'ブランチ'
        type: string


# グローバル静的変数の定義
env:
  APP_STORE_CONNECT_API_KEY_FILE_NAME: "app_store_connect_api_key.json"

# ジョブ定義
# ジョブは並行実行される
jobs:
  # ジョブID
  deploy:
    # ジョブ名（省略可能。ログ表示用に設定推奨）
    name: Deploy - Firebase App Distribution
    
    # ランナーラベル - GitHubホストランナー macos-15 を使用
    # 注意：このプロジェクトはPublic Repoなので無制限に無料で使用可能
    # 注意：このプロジェクトはPublic Repoなので無制限に無料で使用可能
    # 注意：このプロジェクトはPublic Repoなので無制限に無料で使用可能
    # Private Repoの場合は従量課金、macOSマシンは最も高価（10倍）、10回実行で2,000分無料上限に達する可能性あり
    # self-hosted Runnerの使用を推奨
    runs-on: macos-15

    # 最大タイムアウト時間設定。異常時の無限待機を防止
    timeout-minutes: 30

    # zshを使用
    # 省略可能。私はzshを好むだけでデフォルトはbash
    defaults:
      run:
        shell: zsh {0}

    # ワークステップ
    # ステップは順番に実行される  
    steps:
      # git cloneして現在のリポジトリをチェックアウト、実行中のブランチへ
      - name: Checkout repository
        uses: actions/checkout@v3
        with:
          # Git Large File Storageはテスト環境では不要
          # default: false
          lfs: false
          
          # 指定があればそのブランチをチェックアウト、なければデフォルト（現在のブランチ）
          # on: schedule イベントはmainブランチのみなので、Nightly Buildなどは別ブランチ指定が必要
          # 例：on: schedule -> mainブランチ、Nightly Build -> masterブランチ
          ref: ${{ github.event.inputs.BRANCH \\|\\| '' }}

      # ========== 証明書関連ステップ ==========
      
      # Fastlane - Matchで開発証明書を管理し、Lane内でmatchを実行して設定することを推奨
      # Matchは別のPrivate Repoで証明書管理するが、SSH Agent設定が必要でprivate repoのgit clone権限が必要
      # ref: https://stackoverflow.com/questions/57612428/cloning-private-github-repository-within-organisation-in-actions
      #
      #
      # --- Fastlane - Matchを使わない場合に直接証明書をダウンロード＆インポートする方法 ---
      # ref: https://docs.github.com/en/actions/how-tos/use-cases-and-examples/deploying/installing-an-apple-certificate-on-macos-runners-for-xcode-development
      #
      # GitHub Actions Secretはファイルを保存できないため、証明書ファイルは全てBase64エンコードした文字列でSecretに保存
      # Step内で動的に読み込み、一時ファイルへ書き出しシステムで利用できる場所へ移動する
      # 詳細設定は記事を参照
      #
      - name: Install the Apple certificate and provisioning profile
        env:
          BUILD_CERTIFICATE_BASE64: ${{ secrets.BUILD_CERTIFICATE_BASE64 }}
          P12_PASSWORD: ${{ secrets.BUILD_CERTIFICATE_P12_PASSWORD }}
          BUILD_PROVISION_PROFILE_BASE64: ${{ secrets.BUILD_PROVISION_PROFILE_BASE64 }}
          # GitHub Hosted Runnerはカスタム文字列
          # Self-hosted Runnerはマシンログインパスワード
          KEYCHAIN_PASSWORD: ${{ secrets.KEYCHAIN_PASSWORD }}
        run: \\|
          # 変数作成
          CERTIFICATE_PATH=$RUNNER_TEMP/build_certificate.p12
          PP_PATH=$RUNNER_TEMP/build_pp.mobileprovision
          KEYCHAIN_PATH=$RUNNER_TEMP/app-signing.keychain-db

          # Secretから証明書とプロビジョニングプロファイルをデコードして書き出し
          echo -n "$BUILD_CERTIFICATE_BASE64" \\| base64 --decode -o $CERTIFICATE_PATH
          echo -n "$BUILD_PROVISION_PROFILE_BASE64" \\| base64 --decode -o $PP_PATH

          # 一時キーチェーン作成
          security create-keychain -p "$KEYCHAIN_PASSWORD" $KEYCHAIN_PATH
          security set-keychain-settings -lut 21600 $KEYCHAIN_PATH
          security unlock-keychain -p "$KEYCHAIN_PASSWORD" $KEYCHAIN_PATH

          # キーチェーンへ証明書インポート
          security import $CERTIFICATE_PATH -P "$P12_PASSWORD" -A -t cert -f pkcs12 -k $KEYCHAIN_PATH
          security set-key-partition-list -S apple-tool:,apple: -k "$KEYCHAIN_PASSWORD" $KEYCHAIN_PATH
          security list-keychain -d user -s $KEYCHAIN_PATH

          # プロビジョニングプロファイル適用
          mkdir -p ~/Library/MobileDevice/Provisioning\ Profiles
          cp $PP_PATH ~/Library/MobileDevice/Provisioning\ Profiles

      # App Store Connect API Fastlane JSON キー
      # ビルド環境でほぼ必須のApp Store Connect API Fastlane JSON キー (.json)
      # フォーマット: .json 内容：https://docs.fastlane.tools/app-store-connect-api/
      # App Store Connect APIの.p8キーを含む
      # FastlaneでTestflightやApp Store APIにアップロードする際に使用
      #
      # GitHub Actions Secretはファイル保存不可なのでBase64エンコード文字列として保存
      # Step内で動的に読み込み、一時ファイルへ書き出し他ステップで利用
      # 詳細は記事参照
      - name: Read and Write Apple Store Connect API Key to Temp
        env:
          APP_STORE_CONNECT_API_KEY_BASE64: ${{ secrets.APP_STORE_CONNECT_API_KEY_BASE64 }}
          APP_STORE_CONNECT_API_KEY_PATH: "${{ runner.temp }}/${{ env.APP_STORE_CONNECT_API_KEY_FILE_NAME }}"
        run: \\|
          # Secretからデコードして一時ファイルに書き出し
          echo -n "$APP_STORE_CONNECT_API_KEY_BASE64" \\| base64 --decode -o $APP_STORE_CONNECT_API_KEY_PATH

      # ========== 環境セットアップステップ ==========
      
      # プロジェクト指定のXcodeバージョンを読み込み
      # 後続で手動指定したXcode_x.x.x.appを使用
      # xcversionは非推奨で不安定のため使用しない
      - name: Read .xcode-version
        id: read_xcode_version
        run: \\|
          XCODE_VERSION=$(cat .xcode-version)
          echo "XCODE_VERSION: ${XCODE_VERSION}"
          echo "xcode_version=${XCODE_VERSION}" >> $GITHUB_OUTPUT

          # ここでグローバルにXcodeバージョン指定も可能
          # そうすれば後続でDEVELOPER_DIR指定不要
          # ただしsudo権限が必要。self-hosted runnerの場合は権限確認要
          # sudo xcode-select -s "/Applications/Xcode_${XCODE_VERSION}.app/Contents/Developer"

      # プロジェクト指定のRubyバージョンを読み込み
      - name: Read .ruby-version
        id: read_ruby_version
        run: \\|
          RUBY_VERSION=$(cat .ruby-version)
          echo "RUBY_VERSION: ${RUBY_VERSION}"
          echo "ruby_version=${RUBY_VERSION}" >> $GITHUB_OUTPUT

      # RunnerのRubyバージョンをプロジェクト指定にセットアップ
      - name: Set up Ruby
        uses: ruby/setup-ruby@v1
        with:
          ruby-version: "${{ steps.read_ruby_version.outputs.ruby_version }}"

      # 設定は任意。self-hostedで複数runnerが同時にCI/CD実行時にcocoapodsのrepos共有ディレクトリ問題を回避
      # 問題点：同時pod install時にreposの競合が発生する可能性がある（デフォルトは$HOME/.cocoapods/）
      # GitHub Hosted Runnerでは不要
      # - name: Change Cocoapods Repos Folder
      #   if: contains(runner.labels, 'self-hosted')
      #   run: \\|
      #     # 各Runnerごとに独自の.cocoapodsフォルダを使いリソース競合を防止
      #     mkdir -p "$HOME/.cocoapods-${{ env.RUNNER_NAME }}/"
      #     export CP_HOME_DIR="$HOME/.cocoapods-${{ env.RUNNER_NAME }}"
      #     rm -f "$HOME/.cocoapods-${{ env.RUNNER_NAME }}/repos/cocoapods/.git/index.lock"

      # ========== キャッシュ設定ステップ ==========
      # self-hostedでもキャッシュはクラウドキャッシュで容量計算される
      # ルール：7日間未ヒットで自動削除、単一キャッシュ最大10GB、Action成功時のみキャッシュ
      # Public Repo: 無料無制限
      # Private Repo: 5GBから
      # Self-hostedは独自にshellスクリプト等でキャッシュ戦略を作成可能
      
      # Bundle Cache (Gemfile)
      # MakefileでBundleインストール先を./vendorに指定している対応
      - name: Cache Bundle
        uses: actions/cache@v3
        with:
          path: \\|
            ./vendor
          key: ${{ runner.os }}-bundle-${{ hashFiles('Gemfile.lock') }}
          restore-keys: \\|
            ${{ runner.os }}-bundle-

      # CocoaPods Cache (Podfile)
      # デフォルトはプロジェクトのPodsディレクトリ
      - name: Cache CocoaPods
        uses: actions/cache@v3
        with:
          path: \\|
            ./Product/Pods
          key: ${{ runner.os }}-cocoapods-${{ hashFiles('Product/Podfile.lock') }}
          restore-keys: \\|
            ${{ runner.os }}-cocoapods-

      # Mint cache
      # MakefileでMintインストール先を./mintに指定している対応
      - name: Cache Mint
        uses: actions/cache@v3
        with:
          path: ./mint
          key: ${{ runner.os }}-mint-${{ hashFiles('Mintfile') }}
          restore-keys: \\|
            ${{ runner.os }}-mint-

      # ====================

      # プロジェクトセットアップ＆依存関係インストール
      - name: Setup & Install Dependency
        run: \\|
          # Makefileのsetupコマンド実行。具体的には：
          # brew install mint
          # bundle config set path 'vendor/bundle'
          # bundle install
          # mint bootstrap
          # ...
          # 等のセットアップ処理
          make setup

          # Makefileのinstallコマンド実行。具体的には：
          # mint run yonaskolb/XcodeGen --quiet
          # bundle exec pod install
          # ...
          # 等のインストール処理
          make install

      - name: Deploy Beta
        id: deploy
        # 作業ディレクトリ指定。以降のコマンドでcd不要
        working-directory: ./Product/
        env:
          # ビルド用入力パラメータ
          VERSION_NUMBER: ${{ inputs.VERSION_NUMBER \\|\\| '' }}
          BUILD_NUMBER: ${{ inputs.BUILD_NUMBER \\|\\| '' }}
          RELEASE_NOTE: ${{ inputs.RELEASE_NOTE \\|\\| '' }}
          AUTHOR: ${{ github.actor }}

          # Repo -> Settings -> Actions secrets and variables -> secrets
          # Firebase CLI トークン（取得方法は記事参照）
          FIREBASE_CLI_TOKEN: ${{ secrets.FIREBASE_CLI_TOKEN }}
          # Apple Developer Program Team ID
          TEAM_ID: ${{ secrets.TEAM_ID }}
                    
          # このジョブで使用するXCode_x.x.x指定バージョン
          DEVELOPER_DIR: "/Applications/Xcode_${{ steps.read_xcode_version.outputs.xcode_version }}.app/Contents/Developer"
        run: \\|
          # 現在のタイムスタンプ取得
          BUILD_TIMESTAMP=$(date +'%Y%m%d%H%M%S')

          # BUILD_NUMBERが空の場合、タイムスタンプをAppビルド番号に使用
          BUILD_NUMBER="${BUILD_NUMBER:-$BUILD_TIMESTAMP}"
  
          ID="${{ github.run_id }}"
          COMMIT_SHA="${{ github.sha }}"
          BRANCH_NAME="${{ github.ref_name }}"
          AUTHOR="${{ env.AUTHOR }}"

          # リリースノートを組み立て
          RELEASE_NOTE="${{ env.RELEASE_NOTE }}
          ID: ${ID}
          Commit SHA: ${COMMIT_SHA}
          Branch: ${BRANCH_NAME}
          Author: ${AUTHOR}
          "

          # Fastlaneでビルド＆デプロイLane実行
          bundle exec fastlane beta release_notes:"${RELEASE_NOTE}" version_number:"${VERSION_NUMBER}" build_number:"${BUILD_NUMBER}"

      # GitHub Actions推奨のself-hostedセキュリティ設定：
      # ref: https://docs.github.com/en/actions/how-tos/use-cases-and-examples/deploying/installing-an-apple-certificate-on-macos-runners-for-xcode-development#required-clean-up-on-self-hosted-runners
      # Step: Install the Apple certificate and provisioning profile に対応
      # マシン上のダウンロードした証明書・鍵を削除する目的
      # Matchを使う場合はMatchのクリーン処理に書き換えが必要
      - name: Clean up keychain and provisioning profile
        if: ${{ always() && contains(runner.labels, 'self-hosted') }}
        run: \\|
          security delete-keychain $RUNNER_TEMP/app-signing.keychain-db
          rm ~/Library/MobileDevice/Provisioning\ Profiles/build_pp.mobileprovision

- name: Deploy
  env:
    APP_STORE_CONNECT_API_KEY_PATH: "${{ runner.temp }}/${{ env.APP_STORE_CONNECT_API_KEY_FILE_NAME }}"
  run: \\|
    ....

name: Build

on:
  push:
    branches:
      - main
  workflow_call:
     inputs:
        RELEASE_NOTE:
          description: 'デプロイのリリースノート。'
          required: false
          type: string

jobs:
  build:
    runs-on: macos-latest

    steps:
      - name: コードのチェックアウト
        uses: actions/checkout@v4

      - name: 依存関係のインストール
        run: \\|
          make steup
          make instal

      - name: プロジェクトのビルド
        run: bundle exec fastlane build

      - name: ビルド成果物のアップロード
        uses: actions/upload-artifact@v4
        with:
          name: build-artifact
          path: ./fastlane/build/

name: Deploy Firebase

on:
  # ビルドアクション完了時に自動でトリガーされる
  workflow_run:
    workflows: ["Build"]
    types:
      - completed

jobs:
  deploy:
    runs-on: ubuntu-latest
    # 完了かつ成功した場合のみデプロイを実行
    if: ${{ github.event.workflow_run.conclusion == 'success' }}

    steps:
      - name: Checkout Code
        uses: actions/checkout@v4

      - name: Install Dependencies
        run: \\|
          make steup

      - name: Download Build Artifact
        uses: actions/download-artifact@v4
        with:
          name: build-artifact
          path: ./fastlane/build/

      - name: Deploy to Production
        run: \\|
          bundle exec fastlane deploy-firebase

name: Deploy Testflight

on:
  # Build Action が完了したときに自動で実行
  workflow_run:
    workflows: ["Build"]
    types:
      - completed

jobs:
  deploy:
    runs-on: ubuntu-latest
    # 完了かつ成功した場合にのみデプロイを実行
    if: ${{ github.event.workflow_run.conclusion == 'success' }}

    steps:
      - name: Checkout Code
        uses: actions/checkout@v4

      - name: Install Dependencies
        run: \\|
          make steup

      - name: Download Build Artifact
        uses: actions/download-artifact@v4
        with:
          name: build-artifact
          path: ./fastlane/build/

      - name: Deploy to Production
        run: \\|
          bundle exec fastlane deploy-testflight

name: Deploy Firebase

on:
  # 任意のトリガー条件、ここでは手動フォームトリガーの例
  workflow_dispatch:
    inputs:
      RELEASE_NOTE:
        description: 'デプロイのリリースノート。'
        required: false
        type: string
jobs:
  build:
    needs: Build
    uses: ./.github/workflows/CD-Build.yml
    secrets: inherit
    with:
      RELEASE_NOTE: ${{ inputs.RELEASE_NOTE }}

  deploy:
    runs-on: ubuntu-latest
    # ジョブはデフォルトで並列実行、needsでbuild完了待ちに制限
    needs: [build]
    # 成功時のみデプロイ実行
    if: ${{ always() && needs.deploy.result == 'success' }}
    steps:
      - name: Checkout Code
        uses: actions/checkout@v4

      - name: Install Dependencies
        run: \\|
          make steup

      - name: Download Build Artifact
        uses: actions/download-artifact@v4
        with:
          name: build-artifact
          path: ./fastlane/build/

      - name: Deploy to Production
        run: \\|
          bundle exec fastlane deploy-firebase

# ワークフロー（Action）名
name: CI-Nightly Build And Deploy

# Actions ログのタイトル名
run-name: "[CI-Nightly Build And Deploy] ${{ github.ref }}"

# トリガーイベント
on:
  # スケジュール定期自動実行
  # https://crontab.guru/
  # UTC時間
  schedule:
    # UTCの19:00 = 毎日 UTC+8 の 03:00
    - cron: '0 19 * * *'
  # 手動トリガー
  workflow_dispatch:

# ジョブの作業項目
# ジョブは並行実行される
jobs:
  # テストジョブ
  testing:
    # Reuse Workflow (workflow_call)
    uses: ./.github/workflows/CI-Testing.yml
    # すべての Secrets を CD-Testing.yml に渡す
    secrets: inherit
    with:
      # 全テスト実行
      TEST_LANE: "run_all_tests"
      # 対象ブランチ：main, develop, master など
      BRANCH: "main"

  deploy-env:
    runs-on: ubuntu-latest
    outputs:
      DATE_STRING: ${{ steps.get_date.outputs.DATE_STRING }}
    steps:
      - name: 日付文字列を取得
        id: get_date
        run: \\|
          VERSION_DATE=$(date -u '+%Y%m%d')
          echo "${VERSION_DATE}"
          echo "DATE_STRING=${VERSION_DATE}" >> $GITHUB_ENV
          echo "DATE_STRING=${VERSION_DATE}" >> $GITHUB_OUTPUT
    
  deploy:
    # ジョブはデフォルトで並行実行、needsでtestingとdeploy-env完了まで待機
    needs: [testing, deploy-env]
    # テスト成功時のみ実行
    if: ${{ needs.testing.result == 'success' }}
    # Reuse Workflow (workflow_call)
    uses: ./.github/workflows/CD-Deploy.yml
    # すべての Secrets を CD-Deploy.yml に渡す
    secrets: inherit
    with:
      VERSION_NUMBER: NightlyBuild-${{ needs.deploy-env.outputs.DATE_STRING }}
      RELEASE_NOTE: NightlyBuild-${{ needs.deploy-env.outputs.DATE_STRING }}
      # 対象ブランチ：main, develop, master など
      BRANCH: "main"

# ----- Slack 通知 -----
  testing-failed-slack-notify:
    needs: [testing]
    runs-on: ubuntu-latest
    if: ${{ needs.testing.result == 'failure' }}
    steps:
      - name: Slack チャンネルにテキストを投稿
        uses: slackapi/[email protected]
        with:
          method: chat.postMessage
          token: ${{ secrets.SLACK_BOT_TOKEN }}
          payload: \\|
            channel: ${{ vars.SLACK_TEAM_CHANNEL_ID }}
            text: ":x: Nightly Build - テスト失敗\nWorkflow: <${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}\\|実行を見る>"

  deploy-failed-slack-notify:
    needs: [deploy]
    runs-on: ubuntu-latest
    if: ${{ needs.deploy.result == 'failure' }}
    steps:
      - name: Slack チャンネルにテキストを投稿
        uses: slackapi/[email protected]
        with:
          method: chat.postMessage
          token: ${{ secrets.SLACK_BOT_TOKEN }}
          payload: \\|
            channel: ${{ vars.SLACK_TEAM_CHANNEL_ID }}
            text: ":x: Nightly Build デプロイ失敗\nWorkflow: <${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}\\|実行を見る>"

  deploy-success-slack-notify:
    needs: [deploy]
    runs-on: ubuntu-latest
    if: ${{ needs.deploy.result == 'success' }}
    steps:
      - name: Slack チャンネルにテキストを投稿
        uses: slackapi/[email protected]
        with:
          method: chat.postMessage
          token: ${{ secrets.SLACK_BOT_TOKEN }}
          payload: \\|
            channel: ${{ vars.SLACK_TEAM_CHANNEL_ID }}
            text: ":white_check_mark: Nightly Build デプロイ成功\nWorkflow: <${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}\\|実行を見る>"

name: Demo Git Clone Private Repo

on:
  workflow_dispatch:

jobs:
  clone-private-repo:
    name: Git Clone Private Repo
    runs-on: ubuntu-latest
    timeout-minutes: 30

    steps:
      # 🔐 SSHエージェントを起動し、秘密鍵を追加する
      - name: Setup SSH Agent
        uses: webfactory/[email protected]
        with:
          ssh-private-key: ${{ secrets.SSH_PRIVATE_KEY }}

      # 🛡️ github.comをknown_hostsに追加し、ホスト認証エラーを防ぐ
      - name: Add GitHub to known_hosts
        run: \\|
          mkdir -p ~/.ssh
          ssh-keyscan github.com >> ~/.ssh/known_hosts
      # 📦 SSHを使ってプライベートリポジトリをクローンし、検証する
      - name: Clone and Verify Private Repo
        run: \\|
          git clone [email protected]:ZhgChgLi/github-actions-ci-cd-demo-certificates.git ./fakeMatch/
          if [ -d "./fakeMatch/.git" ]; then
            echo "✅ ./fakeMatch/に正常にリポジトリをクローンしました"
            cd ./fakeMatch
            echo "📌 現在のコミット: $(git rev-parse --short HEAD)"
          else
            echo "❌ クローンに失敗しました。SSHエージェントの設定が正しくない可能性があります。"
            exit 1
          fi