🚀[기능개선][CICD][iOS] App Store 심사 자동 제출 누락 + 거짓 성공 제거

[Cassiiopeia]

📝 현재 문제점

• iOS 배포 워크플로우(ROMROM-IOS-TESTFLIGHT.yaml)가 TestFlight 업로드까지만 하고, App Store production 심사 제출은 하지 않는다. pilot()(TestFlight 업로드)만 호출하고 deliver(App Store 심사 제출) 코드가 없다.
• 그래서 매 릴리스마다 App Store Connect 웹에서 수동으로 심사를 제출해야 한다. 이미 production 출시 중인 앱이라, 플랫폼마다 심사를 따로 입력하는 게 큰 불편이다.
• 추가 문제 — 거짓 성공: 워크플로우 487줄이 fastlane upload_testflight || echo "⚠️ 권한 에러 발생했지만 업로드는 성공적으로 완료됨"로 되어 있어, **업로드가 실제로 실패해도 워크플로우가 초록불(success)**로 끝난다. 실패가 가려진다.
• 이는 Android 🚀[기능개선][CICD][PlayStore] 배포 success인데 심사 제출 안 되는 거짓 성공 문제 수정 및 실측 검증 #930(배포 success인데 심사 제출 안 되는 거짓 성공)과 같은 결의 문제다. iOS는 거짓 성공에 더해 심사 제출 기능 자체가 없다.

🛠️ 해결 방안 / 제안 기능

• pilot()(TestFlight 업로드) 다음에 deliver로 App Store production 심사 자동 제출 단계를 추가한다. 메타데이터/스크린샷은 App Store Connect 웹에서 관리하므로 빌드만 심사에 제출한다.
  • submit_for_review: true — 심사 자동 제출 (수동 입력 제거, 이 작업의 핵심)
  • automatic_release: true — 심사 통과 즉시 자동 출시
  • skip_binary_upload: true — pilot으로 올린 빌드 사용 (재업로드 안 함)
  • skip_metadata: true / skip_screenshots: true — 메타/스샷은 웹 관리
• pilot의 skip_waiting_for_build_processing를 false로 바꿔 빌드 처리 완료를 기다린 뒤 deliver가 심사 제출하도록 한다. (처리 중인 빌드는 심사 제출 불가)
• 거짓 성공 제거: 487줄 || echo "...성공적으로 완료됨"를 제거한다. 업로드/심사 제출이 실패하면 워크플로우가 정직하게 빨간불로 표면화된다.

⚙️ 작업 내용

• ROMROM-IOS-TESTFLIGHT.yaml의 fastlane lane에 deliver(심사 제출) 추가 + lane 재명명(deploy_appstore)
• pilot의 skip_waiting_for_build_processing: false로 빌드 처리 대기
• 487줄 || echo 거짓 성공 제거 + 호출부를 fastlane deploy_appstore로 교체
• 검증 (Android #930과 1회 배포로 동시 수행, /suh-changelog-deploy):
  • CI 로그에서 deliver 심사 제출 step이 성공 또는 실패 시 빨간불로 표면화되는지 확인
  • App Store Connect → 앱 → 버전이 **"심사 대기 중(Waiting for Review)"**으로 실제 진입했는지 확인
  • 수동 심사 제출 없이 자동으로 심사에 들어가는지 확인
• 검증 성공 시, 검증된 형태를 템플릿(SUH-DEVOPS-TEMPLATE 마이페이지의 이용약관 페이지 추가 필요 #399)에 이식

연계 이슈 (Android, 같은 "심사까지 자동 + 거짓 성공 제거" 철학):

• 🚀[기능개선][CICD][PlayStore] 배포 success인데 심사 제출 안 되는 거짓 성공 문제 수정 및 실측 검증 #930

🙋‍♂️ 담당자

• 백엔드: 이름
• 프론트엔드: @Cassiiopeia
• 디자인: 이름

[SeoHyun1024]

Guide by SUH-LAB

브랜치

20260620_#931_App_Store_심사_자동_제출_누락_거짓_성공_제거

커밋 메시지

App Store 심사 자동 제출 누락 + 거짓 성공 제거 : feat : {변경 사항에 대한 설명} https://github.com/TEAM-ROMROM/RomRom-FE/issues/931

[Cassiiopeia]

🔍 1단계 — iOS 심사 자동제출 실패 근본 원인 진단 + 수정 완료 (배포 대기)

자동 작업 기록 — 진행 상황을 이 이슈에 단계별로 영구 기록합니다.

실패한 런

• Run: https://github.com/TEAM-ROMROM/RomRom-FE/actions/runs/27874024036
• Project-iOS-TestFlight-Deploy #170, 빌드 1.10.97 (170)

무엇이 됐고 / 무엇이 안 됐나

단계	상태	설명
빌드 · 코드사인 · IPA Export	✅	정상
TestFlight 업로드 (pilot)	✅	1.10.97 (170) 빌드가 Validated 상태로 업로드 + 내부 테스터 배포 완료
App Store 심사 제출 (deliver)	❌	Bundle ID를 추론하지 못해 시작도 못 하고 crash → 심사 큐 진입 실패

➡️ 결론: TestFlight까지만 올라갔고, App Store 심사 큐에는 진입조차 못 했다. App Store Connect의 iOS History가 여전히 1.10.5에 머물러 있고 1.10.97이 안 보이는 게 그 증거.

근본 원인 (CI 로그 스택트레이스로 확정)

deliver/lib/deliver/detect_values.rb:35:in 'Deliver::DetectValues#find_app_identifier'
[14:52:08]: The Bundle Identifier of your App:
[14:52:08]: Could not retrieve response as fastlane runs in non-interactive mode
[!] Could not infer your App's Bundle Identifier

• pilot(TestFlight)은 IPA 파일에서 Bundle ID를 읽어 동작 → 성공.
• deliver는 skip_binary_upload: true라 IPA를 보지 않는다. 이미 올라간 빌드를 App Store Connect API로 찾아 심사 제출만 한다. 그래서 app_identifier(Bundle ID)를 별도로 알아야 하는데:
  • deliver(...) 호출에 app_identifier 파라미터 없음
  • ios/fastlane/Appfile 없음 (인라인 Fastfile만 생성, Appfile 미생성)
  • 환경변수 PRODUCE_APP_IDENTIFIER도 안 줌
• → find_app_identifier가 마지막 수단으로 터미널에 Bundle ID 입력을 요청하다가, CI는 non-interactive라 crash! 발생.

기각된 가설: ❌ 인증서/프로비저닝 문제(그러면 pilot부터 실패) / ❌ API Key 문제(pilot에서 같은 api_key로 성공) / ❌ 빌드 처리 미완료(Successfully finished processing the build 로그 확인됨).

수정 (ROMROM-IOS-TESTFLIGHT.yaml 인라인 Fastfile)

app_id = ENV["APP_IDENTIFIER"] || "com.alom.romrom"

pilot(
  api_key: api_key,
  app_identifier: app_id,        # Bundle ID 명시 (비대화형 안전)
  ...
)

deliver(
  api_key: api_key,
  app_identifier: app_id,        # ⭐ 근본 원인 수정 — 미전달 시 crash
  submit_for_review: true,
  automatic_release: true,
  force: true,
  run_precheck_before_submit: false,  # 메타 스킵 상태에서 precheck 비대화형 충돌 선제 차단
  skip_binary_upload: true,
  skip_metadata: true,
  skip_screenshots: true,
  ...
)

• step 환경변수에도 export APP_IDENTIFIER="com.alom.romrom" 추가 (단일 소스).
• run_precheck_before_submit: false: skip_metadata: true 상태에서 precheck가 또 다른 비대화형 충돌을 일으킬 수 있어 선제 차단.

다음 단계 (자동 진행 중)

• 커밋 · main 푸시
• 배포 워크플로우 트리거
• Actions 로그 polling — deliver step이 성공(심사 제출) 또는 실패 시 빨간불로 표면화되는지 실측
• App Store Connect에서 1.10.97이 **"심사 대기 중(Waiting for Review)"**으로 실제 진입했는지 확인
• 실패 시 로그 분석 → 재수정 → 재배포 (성공할 때까지 반복)

결과가 나오는 대로 이 이슈에 후속 댓글로 기록합니다.

[Cassiiopeia]

🚀 2단계 — 배포 트리거 완료 (appstore_submit 모드, polling 중)

적용한 추가 설계: 배포 모드 옵션화

심사 자동제출을 켜고 끌 수 있도록 옵션화했습니다 (사용자 요청). CI/CD 워크플로우 내부 환경변수 DEPLOY_MODE로 제어합니다 (Flutter .env가 아니라 GitHub Actions 변수).

모드	동작
testflight_only (기본·안전값)	pilot(TestFlight 업로드)까지만
appstore_submit	pilot 후 deliver로 App Store production 심사 자동 제출

제어 우선순위: workflow_dispatch input deploy_mode > repo variable IOS_DEPLOY_MODE > 폴백 testflight_only

• 평소 자동 배포는 testflight_only(생 기본값)로 안전하게 — 실수로 심사 들어가지 않음.
• 심사까지 보낼 때만 명시적으로 appstore_submit 지정.
• testflight-wizard 템플릿(templates/Fastfile)에도 동일한 deploy lane을 이식 → 앞으로 wizard로 세팅하는 새 프로젝트도 동일 옵션 지원.
• 부수: 최신 마법사 코드와 동기화하며 Ruby 3.4 frozen-string 호환 + fastlane 2.228 + multi_json gem(google-apis 의존성 버그 회피, ❗[버그][CICD] Android 테스트 APK 빌드 실패 - Fastlane multi_json 의존성 누락 #917 연계) 반영.

이번 배포

• 커밋: 4edd36d (main) → deploy 브랜치 머지(c482f78)
• IOS_DEPLOY_MODE=appstore_submit로 1회 설정 → 이번 배포는 심사까지 자동 제출
• 트리거: deploy push → Run deploy #171 진행 중
  • https://github.com/TEAM-ROMROM/RomRom-FE/actions/runs/27926341180
• 대상 버전: 1.10.98

검증 중 (polling)

• pilot(TestFlight 업로드) 성공
• deliver(심사 제출) step이 Bundle ID crash 없이 통과 ← 이번 핵심
• App Store Connect에서 1.10.98 "심사 대기 중" 실제 진입
• 실패 시 로그 분석 → 재수정 → 재배포

배포 후 처리

• 검증 성공 시 IOS_DEPLOY_MODE variable을 제거/원복 → 기본값 testflight_only로 복귀 (평소엔 심사 자동 안 들어가도록)

결과 나오는 대로 후속 댓글로 기록합니다.

[Cassiiopeia]

🔁 3단계 — 1차 근본원인 해결 확인 + 2차 원인 발견 (재수정 진행)

Run #171 결과: 실패 — 단, 이전과 다른 지점에서 실패 (= 1차 수정 성공)

• Run: https://github.com/TEAM-ROMROM/RomRom-FE/actions/runs/27926341180
• 모드: appstore_submit, 버전 1.10.98 (build 171)

✅ 1차 근본원인(app_identifier 누락)은 해결됨

deliver Summary 로그에 Bundle ID가 정확히 들어갔고, 이전의 Could not infer your App's Bundle Identifier crash가 사라졌습니다:

| app_identifier   | com.alom.romrom |
| submit_for_review| true            |

• TestFlight 업로드도 정상: Successfully finished processing the build 1.10.98 - 171 → 내부 테스터 배포 완료
• 즉 pilot 성공 + deliver가 crash 없이 실행 단계까지 진입 (이전엔 진입조차 못 했음)

❌ 2차 원인: 심사 제출 가능한 App Store 버전이 없음

deliver가 실행됐지만 다음 에러로 실패:

[!] Cannot submit for review - could not find an editable version for 'IOS'

진단: submit_for_review: true는 App Store Connect에 "준비 중(Prepare for Submission)" 상태의 editable App Store 버전이 있어야 동작한다. 현재 ASC에는 1.10.5(Ready for Distribution)가 마지막이고 1.10.98 App Store 버전 페이지가 생성되어 있지 않다. skip_metadata:true + skip_binary_upload:true라 deliver가 기존 editable 버전을 "찾기만" 하고 새로 만들지 않아 실패.

🛠️ 2차 수정

deliver에 app_version을 명시해 해당 버전의 editable App Store 버전을 생성/선택하도록 한다. 워크플로우의 prepare-build.outputs.version(=1.10.98)을 APP_VERSION 환경변수로 deliver에 전달.

deliver(
  ...
  app_version: ENV["APP_VERSION"],   # ⭐ 2차 수정 — editable 버전 생성/선택
  ...
)

다음

• 수정 커밋 → deploy 재배포 (appstore_submit)
• deliver가 1.10.98 editable 버전 생성 후 심사 제출 성공하는지 실측
• 안 되면 다음 가설(메타 최소 제공 등)로 재시도

systematic-debugging: 한 번에 하나씩 변경하며 실측. 진행 상황 계속 기록합니다.

[Cassiiopeia]

🔁 4단계 — 2차 수정 재배포 (Run #172, polling 중)

• 커밋: 4e8ffad (main) → deploy 머지(e6bf33f)
• 재배포: Run deploy #172 — https://github.com/TEAM-ROMROM/RomRom-FE/actions/runs/27927296681
• 모드: appstore_submit, 버전 1.10.98

적용한 2차 수정

deliver에 app_version: ENV["APP_VERSION"](=1.10.98) 추가 → ASC에 editable App Store 버전을 생성/선택한 뒤 빌드를 붙여 심사 제출하도록 함. (이전 #171은 editable 버전이 없어 could not find an editable version으로 실패)

검증 중

• deliver가 1.10.98 editable 버전 생성/선택
• 심사 제출 성공 (submit_for_review)
• App Store Connect에서 1.10.98 "심사 대기 중(Waiting for Review)" 진입
• 실패 시: 다음 가설(메타 디렉토리 최소 제공 등)로 재시도

polling 추적 중. 결과 나오는 대로 기록.

[Cassiiopeia]

🔁 5단계 — 2차 수정 성공 + 3차 원인 발견 (whatsNew 릴리스 노트 누락)

Run #172 결과: 실패 — 단, 또 한 단계 전진 (2차 수정 성공)

• Run: https://github.com/TEAM-ROMROM/RomRom-FE/actions/runs/27927296681

✅ 2차 수정(app_version) 성공 확인

deliver가 editable 버전 생성 + 빌드 선택까지 성공했습니다:

| app_version | 1.10.98 |
Making sure the latest version on App Store Connect matches '1.10.98'...
Successfully set the version to '1.10.98'      ← editable 버전 생성/선택 OK
Selecting build 1.10.98 (172)...
Successfully selected build                     ← 빌드 선택 OK

이전 #171의 could not find an editable version은 사라졌습니다.

❌ 3차 원인: 심사 제출 마지막 단계에서 whatsNew(릴리스 노트) 누락

appStoreVersions ... is not in valid state. - This resource cannot be reviewed
The provided entity is missing a required attribute -
You must provide a value for the attribute 'whatsNew' with this request

진단: App Store는 업데이트 버전(2번째 이후) 심사 제출 시 whatsNew(이 버전의 새로운 기능 = 릴리스 노트)를 필수로 요구한다. 그런데 skip_metadata: true라서 deliver가 새로 생성한 1.10.98 버전에 릴리스 노트를 하나도 안 채워 → 버전이 "리뷰 불가 상태"가 되어 제출 거부.

핵심 깨달음: "메타는 웹에서 관리, 빌드만 제출"(skip_metadata: true) 전략은 deliver가 새 버전을 생성하는 경우엔 성립하지 않는다. 새 버전에는 최소한 릴리스 노트(whatsNew)가 있어야 심사 제출이 가능하다.

🛠️ 3차 수정 방향

deliver가 릴리스 노트만이라도 채우도록 한다. 워크플로우엔 이미 final_release_notes.txt(= RELEASE_NOTES)가 있으므로:

• skip_metadata: false로 전환하고, 릴리스 노트만 담은 최소 메타데이터 디렉토리(fastlane/metadata/ko-KR/release_notes.txt 등)를 동적 생성해 whatsNew만 채운다.
• 나머지 메타(설명/키워드 등)는 파일을 안 만들면 deliver가 기존 ASC 값을 건드리지 않는다(존재하는 파일만 업로드).

다음

• 릴리스 노트 메타 디렉토리 생성 로직 추가 → 재배포
• deliver 심사 제출 성공 + ASC "심사 대기 중" 진입 실측

3개 원인을 순차 제거 중: ①Bundle ID 누락(해결) → ②editable 버전 없음(해결) → ③릴리스 노트 누락(수정 중). 계속 기록.

[Cassiiopeia]

🔁 6단계 — 3차 수정(whatsNew) 재배포 (Run #173, polling 중)

• 커밋: 515e4a0 → main(7b556ab) → deploy(a66f27e)
• 재배포: Run deploy #173 — https://github.com/TEAM-ROMROM/RomRom-FE/actions/runs/27928110897
• 모드: appstore_submit, 버전 1.10.99 (반복 배포로 버전 자동 증가)

적용한 3차 수정

deliver 호출 직전, 릴리스 노트(whatsNew)만 담은 메타 디렉토리를 동적 생성:

• fastlane/metadata/ko/release_notes.txt, fastlane/metadata/ko-KR/release_notes.txt 에 RELEASE_NOTES 기록 (로케일 코드 불일치 방어로 양쪽 작성)
• skip_metadata: false + metadata_path 명시 → release_notes만 업로드, 다른 메타 파일은 안 만들어 ASC 기존 메타(설명/키워드 등) 보존

누적 진행 (원인 순차 제거)

#	원인	상태
1	app_identifier(Bundle ID) 누락 → crash	✅ 해결 (#171에서 deliver 진입 성공)
2	editable App Store 버전 없음	✅ 해결 (#172에서 버전 생성+빌드 선택 성공)
3	whatsNew(릴리스 노트) 누락 → 제출 거부	🔄 이번 #173에서 검증 중

검증 중

• deliver가 릴리스 노트(whatsNew) 채우고 심사 제출 성공
• ASC에서 1.10.99 "심사 대기 중(Waiting for Review)" 진입
• 실패 시 로그 분석 후 재시도

polling 추적 중. 결과 나오는 대로 기록.