[leesengjun]

💡 개요

Issue #351 작업입니다.

배포 환경에서 사용하는 Ruby gem 의존성을 Gemfile.lock으로 고정하고,
GitHub Actions와 Xcode Cloud가 동일한 Bundler 기반 환경을 사용하도록 정리했습니다.

같은 commit에서도 설치 시점에 따라 Fastlane/CocoaPods gem 버전이 달라질 수 있던 문제를 줄이고,
CI가 lock 파일을 암묵적으로 변경하지 못하도록 frozen 정책을 적용했습니다.

🔗 관련 이슈

• 🔧 :: Fastlane·CocoaPods gem lock과 배포 환경 재현성 확보 #351

📃 작업내용

• Gemfile.lock 추가

  • Fastlane 2.240.1
  • CocoaPods 1.16.2
  • Bundler 2.6.9

• GitHub Actions 배포 workflow에 lock 누락 검사 및 frozen Bundler 설치 적용

  • release-android.yml
  • release-ios.yml
  • testflight-ios-manual.yml

• Xcode Cloud post-clone 스크립트 수정

  • lock 기반 Bundler 설치
  • bundle exec pod install 사용
  • 글로벌 CocoaPods 우회 방지

• root ci_scripts/ci_post_clone.sh fallback 경로도 동일하게 Bundler 기준으로 정리

🔍 테스트

Windows 환경에서 다음 검증을 진행했습니다.

• YAML 3개 파싱 확인
• frozen / lock 검사 위치 확인
• post-clone shell script 문법 검사
• mock 기반 post-clone 검증 12개 통과
• Gemfile 불일치 시 frozen 설치 실패 확인
• Fastfile 문법 검사 통과
• git diff --check 통과
• ios/Podfile.lock 변경 없음 확인

현재 Windows 환경에서는 아래 항목을 직접 검증하지 못했습니다.

• 실제 macOS pod install
• Xcode build
• Xcode Cloud 실제 실행
• macOS에서 bundle exec fastlane lanes
• 승인된 dry_run=true 배포 workflow

PR 이후 macOS CI에서 추가 검증이 필요합니다.

🙋‍♂️ 확인사항

• ios/Podfile.lock은 수정하지 않았습니다.
• pubspec.yaml, pubspec.lock은 🔧 :: Fastlane·CocoaPods gem lock과 배포 환경 재현성 확보 #351 작업에 포함하지 않았습니다.
• 🔧 :: Dart 플러그인 의존성과 iOS Podfile.lock 드리프트 정리 #352 범위의 Podfile.lock 재생성 작업은 진행하지 않았습니다.
• Fastfile 동작 및 Ruby 버전 설정은 변경하지 않았습니다.
• 실제 Store 업로드는 수행하지 않았습니다.

✅ 체크리스트

• Gemfile.lock 추가
• Fastlane/CocoaPods gem 버전 고정
• GitHub Actions frozen 정책 적용
• Xcode Cloud Bundler 호출 통일
• ios/Podfile.lock 변경 없음
• 🔧 :: Dart 플러그인 의존성과 iOS Podfile.lock 드리프트 정리 #352 범위 미침범
• Windows에서 가능한 정적/로컬 검증 완료
• macOS CI에서 Bundler 설치 검증
• macOS에서 Fastlane lane 로드 검증
• 승인된 dry-run 검증

[inryeok-bot]

리뷰 결과

변경된 6개 파일을 검토했습니다. 인라인 관찰 1개를 게시했습니다.

심각도	개수
치명적	0
높음	0
중간	0
낮음	1

유형: 필수 수정 0, 수정 권장 0, 제안 0, 확인 질문 0, 좋았던 점 1

주요 관찰

• 좋았던 점 · LOW 배포용 Ruby 의존성을 잠금 상태로 검증합니다

검토한 head: c7e1e521ac7e · 최신 head는 /review로 검토하세요.

[inryeok-bot]

🔹 좋았던 점 · LOW

배포용 Ruby 의존성을 잠금 상태로 검증합니다

커밋된 Gemfile.lock를 추가한 뒤 배포 작업에 BUNDLE_FROZEN을 설정해, Gemfile과 잠금 파일이 불일치하면 임의로 의존성을 다시 해석하지 않고 즉시 실패하도록 했습니다. iOS 및 수동 TestFlight 워크플로에도 같은 정책이 적용되어 배포 경로 간 동작도 일관됩니다.

이유: 스토어 배포는 재현성과 실패의 조기 탐지가 중요하므로, 잠금 파일을 자동 수정하지 않는 설정이 운영 안정성을 직접 개선합니다.