🚀[기능개선][CICD][CustomCommand] @suh-lab 댓글 빌드 트리거 정상 작동

[Cassiiopeia]

📝 현재 문제점

• @suh-lab build app, @suh-lab apk build, @suh-lab ios build 댓글 명령어로 빌드를 트리거하는 기능이 현재 정상 작동하지 않음
• 트리거 워크플로우(PROJECT-FLUTTER-SUH-LAB-APP-BUILD-TRIGGER)가 기존 로직으로 구성되어 있어 최신 템플릿 기준과 맞지 않음
• Android/iOS 테스트 빌드 워크플로우에 진행 상황 댓글 시스템이 없어 빌드 상태를 PR/이슈에서 실시간으로 확인할 수 없음

🛠️ 해결 방안 / 제안 기능

• @suh-lab build app : Android + iOS 동시 빌드
• @suh-lab apk build : Android APK만 빌드
• @suh-lab ios build : iOS TestFlight만 빌드
• 댓글 트리거 시 즉시 진행 상황 댓글이 PR/이슈에 생성되고, 각 단계(준비→빌드→배포) 완료 시 댓글이 자동 업데이트됨
• 브랜치가 존재하지 않는 경우 에러 댓글로 안내

⚙️ 작업 내용

• PROJECT-FLUTTER-SUH-LAB-APP-BUILD-TRIGGER : 개별 빌드 명령어 지원 추가, 브랜치 사전 확인, 빌드 카운트 로직 개선, 트리거 완료 댓글 제거(각 플랫폼 댓글로 대체)
• PROJECT-FLUTTER-ANDROID-TEST-APK : 브랜치 사전 확인, 진행 상황 댓글 시스템(생성→단계별 업데이트→최종), Release Keystore 경로 통일, google-services.json 생성 방식 통일
• PROJECT-FLUTTER-IOS-TEST-TESTFLIGHT : notify-start job 분리(빠른 댓글 생성), 3단계 진행 상황 댓글, Xcode 26/macos-26 적용, 기존 Secrets.xcconfig 로직 유지

🙋‍♂️ 담당자

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

[EM-H20]

Guide by SUH-LAB

브랜치

20260305_#49_suh_lab_댓글_빌드_트리거_정상_작동

커밋 메시지

@suh-lab 댓글 빌드 트리거 정상 작동 : feat : {변경 사항에 대한 설명} https://github.com/SpaceStudyShip/SpaceStudyShip-FE/issues/49

[Cassiiopeia]

📌 작업 개요

@suh-lab 댓글 명령어로 Android/iOS 테스트 빌드를 트리거하는 GitHub Actions 시스템 전면 재구성.
기존 트리거 워크플로우가 최신 템플릿 기준과 맞지 않아 정상 동작하지 않던 문제를 해결하고,
빌드 과정에서 PR/이슈에 단계별 진행 상황 댓글이 실시간으로 업데이트되도록 구현.

---

🎯 구현 목표

• @suh-lab build app / @suh-lab apk build / @suh-lab ios build 3종 명령어 각각 지원
• 댓글 트리거 시 즉시 진행 상황 댓글 생성, 단계 완료마다 자동 업데이트
• 브랜치 존재 여부 사전 확인 후 오류 안내 댓글 출력
• Android, iOS 빌드 과정을 현재 운영 워크플로우(PLAYSTORE-CICD, IOS-TESTFLIGHT)와 동일한 방식으로 유지

---

✅ 구현 내용

1. 빌드 트리거 워크플로우 재구성

• 파일: .github/workflows/PROJECT-FLUTTER-SUH-LAB-APP-BUILD-TRIGGER.yaml
• 변경 내용:
  • build app / apk build / ios build 3종 개별 명령어 판별 로직 추가
  • check_branch 스텝 추가 → 브랜치 부재 시 에러 댓글 즉시 출력
  • 빌드 카운트: 플랫폼별 통합 카운트 방식 적용 (iOS는 ios build + build app 합산, Android도 동일)
  • 빌드 번호 형식: {소스번호}{2자리카운트} (예: 38800, 38801)
  • 트리거 완료 댓글 제거 → 각 플랫폼 진행 상황 댓글로 대체

2. Android 테스트 APK 빌드 워크플로우 재구성

• 파일: .github/workflows/PROJECT-FLUTTER-ANDROID-TEST-APK.yaml
• 변경 내용:
  • verify_branch 스텝 추가 (repository_dispatch 트리거 시 브랜치 존재 확인)
  • 진행 상황 댓글 시스템: 생성(준비 중) → 준비 완료 → APK 빌드 완료, 각 단계 소요 시간 표시
  • Release Keystore 경로 운영 파일과 동일하게 통일: android/app/keystore/key.jks
  • google-services.json 생성 방식: heredoc(cat << 'EOF') 방식으로 운영 파일과 통일
  • .env 파일 생성: ENV_FILE || ENV fallback 방식 적용

3. iOS TestFlight 테스트 빌드 워크플로우 재구성

• 파일: .github/workflows/PROJECT-FLUTTER-IOS-TEST-TESTFLIGHT.yaml
• 변경 내용:
  • notify-start job 분리 (ubuntu-latest) → macOS runner 시작 전 댓글 빠르게 선점
  • 3단계 진행 상황 댓글: 준비 → IPA 빌드 → TestFlight 배포, 단계별 소요 시간 표시
  • macos-26 + Xcode 26 적용 (iOS 26 SDK, TestFlight 경고 90725 대응)
  • Secrets.xcconfig 생성 로직 운영 파일 그대로 유지: SECRETS_XCCONFIG 시크릿 우선, 없으면 GOOGLE_MAPS_API_KEY 개별 시크릿으로 fallback
  • Fastlane: bundle exec fastlane 방식 유지 (CFPropertyList 의존성 충돌 방지)
  • .env 파일 생성: ENV_FILE || ENV fallback 방식으로 Android와 일관성 확보

---

🔧 주요 변경사항 상세

진행 상황 댓글 시스템 (공통)

단계별 댓글 업데이트 방식으로 PR/이슈에서 실시간 빌드 상태 확인 가능.
array.join('\n') 패턴으로 GitHub 마크다운 표 들여쓰기 문제를 방지하여 표 렌더링이 정상적으로 표시됨.

단계	상태 표시
준비 중	⏳ 진행 중
준비 완료	✅ 완료 + 소요 시간
빌드/배포 완료	✅ 완료 + 소요 시간
실패	❌ 실패 + 워크플로우 로그 링크

notify-start job 패턴 (iOS)

iOS 빌드는 macOS runner 할당에 수 분이 소요될 수 있어,
ubuntu-latest 기반의 notify-start job이 먼저 실행되어 즉시 댓글 생성.
이후 prepare-test-build job은 notify-start.outputs.branch_valid == 'true'일 때만 실행.

특이사항:

• notify-start job은 repository_dispatch 트리거 시에만 실행 (workflow_dispatch 수동 실행 시 스킵)
• prepare-test-build의 if 조건: needs.notify-start.result == 'skipped' || branch_valid == 'true'로 수동 실행도 정상 동작

빌드 방식 운영 파일과 동일하게 유지

항목	유지 방식
Release Keystore	android/app/keystore/key.jks (PLAYSTORE-CICD 동일)
google-services.json	heredoc 방식 (PLAYSTORE-CICD 동일)
Secrets.xcconfig	SECRETS_XCCONFIG 우선, 없으면 GOOGLE_MAPS_API_KEY fallback (IOS-TESTFLIGHT 동일)
Fastlane	bundle exec fastlane (IOS-TESTFLIGHT 동일)
Xcode	macos-26 + Xcode 26 (IOS-TESTFLIGHT 동일)

---

🧪 테스트 및 검증

• PR 댓글에 @suh-lab build app 작성 시 Android + iOS 동시 빌드 트리거 확인
• @suh-lab apk build → Android만, @suh-lab ios build → iOS만 선택 트리거
• 브랜치 미존재 시 에러 댓글 정상 출력 확인
• 진행 상황 댓글이 각 단계 완료 시 자동 업데이트되는지 확인

---

📌 참고사항

• .env 생성 시 ENV_FILE || ENV fallback: ENV_FILE 시크릿이 없는 경우 ENV 시크릿으로 자동 대체
• 빌드 번호 예시: PR #388에서 첫 빌드 → 38800, 두 번째 빌드 → 38801
• iOS notify-start는 ubuntu-latest 실행이므로 macOS 비용 절감 효과도 있음

[Cassiiopeia]

@suh-lab app build

[Cassiiopeia]

@suh-lab app build

[github-actions]

🤖 ❌ Android 테스트 APK 빌드 실패

단계	상태	소요 시간
🔧 준비	✅ 완료	13초
🔨 APK 빌드	❌ 실패	28초

항목	값
앱 버전	0.0.0(4903)
브랜치	20260305_#49_suh_lab_댓글_빌드_트리거_정상_작동
커밋	da495dd

❌ APK 빌드 중 오류가 발생했습니다.

🔗 워크플로우 실행 로그 확인

[github-actions]

🍎 ✅ iOS TestFlight 배포 완료

단계	상태	소요 시간
🔧 준비	✅ 완료	32초
🔨 IPA 빌드	✅ 완료	7분 53초
📤 TestFlight 배포	✅ 완료	6분 42초

총 소요 시간: 15분 7초

항목	값
앱 버전	0.0.0(4903)
브랜치	20260305_#49_suh_lab_댓글_빌드_트리거_정상_작동
커밋	da495dd

📱 TestFlight에서 테스트 앱을 다운로드할 수 있습니다.

🔗 워크플로우 실행 로그