Rork × Fastlane × EAS リリース自動化 — スクリーンショット生成・メタデータ同期・TestFlight/Play Console 配信をワンコマンド化する実装パターン

# fastlane/Fastfile
default_platform(:ios)
 
fastlane_require 'dotenv'
before_all do
  Dotenv.load '.env.default'
  Dotenv.load '.env.secret' if File.exist?('.env.secret')
  ensure_git_status_clean unless ENV['SKIP_GIT_CHECK']
end
 
desc "iOS TestFlight 配信: EAS でビルド → pilot でアップロード → メタデータ更新"
lane :ios_beta do
  # 1) EAS Build でバイナリ生成（--non-interactive で CI 挙動に揃える）
  sh("cd .. && eas build --platform ios --profile preview --non-interactive --wait")
 
  # 2) 最新ビルドアーティファクトの URL を取得
  build_json = sh("cd .. && eas build:list --platform ios --limit 1 --json --non-interactive")
  artifact_url = JSON.parse(build_json).first["artifacts"]["buildUrl"]
  UI.user_error\!("Build URL not found") if artifact_url.nil? || artifact_url.empty?
 
  # 3) ローカルにダウンロードしてから pilot で TestFlight にアップロード
  ipa_path = "/tmp/rork-#{Time.now.to_i}.ipa"
  sh("curl -L -o #{ipa_path} #{artifact_url}")
 
  pilot(
    api_key_path: ENV['APP_STORE_CONNECT_API_KEY_PATH'],
    ipa: ipa_path,
    skip_waiting_for_build_processing: true,
    distribute_external: false,
    changelog: File.read("metadata/ios/ja/release_notes.txt")
  )
 
  # 4) メタデータ・スクリーンショットを同期
  deliver(
    api_key_path: ENV['APP_STORE_CONNECT_API_KEY_PATH'],
    submit_for_review: false,
    automatic_release: false,
    skip_binary_upload: true,
    skip_screenshots: false,
    overwrite_screenshots: true,
    force: true
  )
ensure
  File.delete(ipa_path) if ipa_path && File.exist?(ipa_path)
end

# Expo プロジェクトのプレビルド（初回のみ）
npx expo prebuild --platform ios --clean
 
# Xcode を開いて UITest ターゲットを追加
open ios/YourApp.xcworkspace

// ios/YourAppUITests/YourAppUITests.swift
import XCTest
 
class YourAppUITests: XCTestCase {
    override func setUp() {
        continueAfterFailure = false
        let app = XCUIApplication()
        setupSnapshot(app)   // Fastlane の SnapshotHelper.swift で定義される
        app.launchArguments += ["-UITest", "YES"]
        app.launch()
    }
 
    func testTakeScreenshots() {
        let app = XCUIApplication()
 
        // React Native 側が描画完了するまで少し待つ
        let homeTitle = app.staticTexts["home-title"]
        XCTAssertTrue(homeTitle.waitForExistence(timeout: 8.0))
 
        snapshot("01_Home")
 
        app.buttons["tab-explore"].tap()
        snapshot("02_Explore")
 
        app.buttons["tab-profile"].tap()
        snapshot("03_Profile")
    }
}

// app/index.tsx （Rork 生成コードをベースにした例）
import { View, Text } from 'react-native';
 
export default function Home() {
  return (
    <View>
      <Text testID="home-title">こんにちは、ようこそ</Text>
      {/* ... */}
    </View>
  );
}

# fastlane/Snapfile
devices([
  "iPhone 16 Pro Max",       # 6.9 inch
  "iPhone 15 Plus",          # 6.7 inch
  "iPhone 8 Plus"            # 5.5 inch （もし Legacy を残すなら）
])
languages(["ja", "en-US"])
scheme("YourApp")
output_directory("./fastlane/screenshots/ios")
clear_previous_screenshots(true)
stop_after_first_error(true)
concurrent_simulators(true)

desc "メタデータ・スクリーンショットを App Store Connect に反映"
lane :metadata_push do
  # 事前バリデーション: 文字数オーバーを検出
  validate_metadata_lengths
 
  deliver(
    api_key_path: ENV['APP_STORE_CONNECT_API_KEY_PATH'],
    submit_for_review: false,
    automatic_release: false,
    skip_binary_upload: true,
    skip_metadata: false,
    skip_screenshots: false,
    overwrite_screenshots: true,
    force: true,
    precheck_include_in_app_purchases: false
  )
end
 
def validate_metadata_lengths
  limits = {
    "name.txt" => 30,
    "subtitle.txt" => 30,
    "promotional_text.txt" => 170,
    "keywords.txt" => 100,
    "description.txt" => 4000,
    "release_notes.txt" => 4000
  }
 
  %w[ja en-US].each do |locale|
    limits.each do |file, limit|
      path = "metadata/ios/#{locale}/#{file}"
      next unless File.exist?(path)
      length = File.read(path).strip.length
      if length > limit
        UI.user_error\!("#{path}: #{length} 文字（上限 #{limit}）")
      end
    end
  end
end

desc "Android Internal Testing への配信 + メタデータ同期"
lane :android_beta do
  sh("cd .. && eas build --platform android --profile preview --non-interactive --wait")
 
  build_json = sh("cd .. && eas build:list --platform android --limit 1 --json --non-interactive")
  artifact_url = JSON.parse(build_json).first["artifacts"]["buildUrl"]
 
  aab_path = "/tmp/rork-#{Time.now.to_i}.aab"
  sh("curl -L -o #{aab_path} #{artifact_url}")
 
  supply(
    json_key: ENV['GOOGLE_PLAY_JSON_KEY_PATH'],
    package_name: ENV['ANDROID_PACKAGE_NAME'],
    aab: aab_path,
    track: "internal",
    release_status: "completed",
    skip_upload_metadata: false,
    skip_upload_images: false,
    skip_upload_screenshots: false,
    validate_only: false
  )
ensure
  File.delete(aab_path) if aab_path && File.exist?(aab_path)
end

# .github/workflows/release.yml
name: Release
 
on:
  workflow_dispatch:
    inputs:
      platform:
        type: choice
        options: [ios, android, both]
        default: both
 
jobs:
  ios:
    if: inputs.platform == 'ios' || inputs.platform == 'both'
    runs-on: macos-14-xlarge
    steps:
      - uses: actions/checkout@v4
 
      - uses: ruby/setup-ruby@v1
        with:
          ruby-version: '3.3.0'
          bundler-cache: true
 
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'
 
      - name: Install dependencies
        run: npm ci
 
      - name: Install EAS CLI
        run: npm i -g eas-cli
 
      - name: Restore App Store Connect API Key
        env:
          ASC_API_KEY_BASE64: ${{ secrets.ASC_API_KEY_BASE64 }}
        run: |
          mkdir -p ~/.appstoreconnect/private_keys
          echo "$ASC_API_KEY_BASE64" | base64 -d > ~/.appstoreconnect/private_keys/AuthKey_${{ secrets.ASC_API_KEY_ID }}.p8
          cat > /tmp/asc_api_key.json <<EOF
          {
            "key_id": "${{ secrets.ASC_API_KEY_ID }}",
            "issuer_id": "${{ secrets.ASC_ISSUER_ID }}",
            "key": "$(cat ~/.appstoreconnect/private_keys/AuthKey_${{ secrets.ASC_API_KEY_ID }}.p8 | base64 -w 0)",
            "in_house": false,
            "is_key_content_base64": true
          }
          EOF
          echo "APP_STORE_CONNECT_API_KEY_PATH=/tmp/asc_api_key.json" >> $GITHUB_ENV
 
      - name: EAS Login
        env:
          EXPO_TOKEN: ${{ secrets.EXPO_TOKEN }}
        run: eas whoami
 
      - name: Fastlane ios_beta
        env:
          FASTLANE_HIDE_CHANGELOG: 1
          FASTLANE_SKIP_UPDATE_CHECK: 1
        run: bundle exec fastlane ios_beta
 
      - name: Cleanup secrets
        if: always()
        run: |
          rm -f /tmp/asc_api_key.json
          rm -rf ~/.appstoreconnect/private_keys

  android:
    if: inputs.platform == 'android' || inputs.platform == 'both'
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: ruby/setup-ruby@v1
        with:
          ruby-version: '3.3.0'
          bundler-cache: true
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'
      - run: npm ci
      - run: npm i -g eas-cli
 
      - name: Restore Google Play JSON key
        env:
          PLAY_KEY_BASE64: ${{ secrets.GOOGLE_PLAY_JSON_KEY_BASE64 }}
        run: |
          echo "$PLAY_KEY_BASE64" | base64 -d > /tmp/google-play-key.json
          echo "GOOGLE_PLAY_JSON_KEY_PATH=/tmp/google-play-key.json" >> $GITHUB_ENV
 
      - name: Fastlane android_beta
        env:
          ANDROID_PACKAGE_NAME: ${{ secrets.ANDROID_PACKAGE_NAME }}
          EXPO_TOKEN: ${{ secrets.EXPO_TOKEN }}
        run: bundle exec fastlane android_beta
 
      - name: Cleanup secrets
        if: always()
        run: rm -f /tmp/google-play-key.json

desc "iOS: 審査取り下げ + 前バージョンのリリースノートに戻す"
lane :ios_rollback do
  UI.message("⚠️  App Store Connect で手動で 'Remove from Review' を実行してください")
  UI.message("  その後このレーンを再実行してメタデータを前バージョンに戻します")
 
  sh("git checkout HEAD~1 -- fastlane/metadata/ios/")
  deliver(
    api_key_path: ENV['APP_STORE_CONNECT_API_KEY_PATH'],
    submit_for_review: false,
    skip_binary_upload: true,
    skip_screenshots: true,
    force: true
  )
  sh("git checkout HEAD -- fastlane/metadata/ios/")  # ワークツリーを元に戻す
end