🚀 [기능개선][테스트배포] 테스트용 브랜치별 앱 버전·빌드 관리 전략 수립

[Cassiiopeia]

📝 현재 문제점

• 현재 TestFlight 배포 구조에서는 main 브랜치에서만 버전 및 빌드 번호가 증가하도록 설계되어 있어,
  개별 기능 개발 브랜치에서 생성되는 테스트용 앱 빌드를 독립적으로 관리하고 배포하는 데 제약이 발생하고 있습니다.

여러 기능을 병렬로 개발·테스트하는 상황에서,
각 브랜치별로 TestFlight에 테스트 버전을 안전하게 올릴 수 있는 버전/빌드 관리 규칙 수립이 필요합니다.

현재 빌드 워크플로우의 문제점에 대한 정리입니다

main push 시 버전·빌드 자동 증가
→ feature 브랜치에서 TestFlight 테스트 빌드 생성 불가

동일 버전에서 빌드 번호 충돌 발생 가능
→ Apple 정책상 같은 Version 내에서 Build는 겹칠 수 없음

브랜치별 테스트 버전이 구분되지 않아 QA가 어렵고 충돌 위험 증가

TestFlight 상에서 여러 테스트 기능을 동시에 검증하기 불편한 구조

🛠️ 해결 방안 / 제안 기능

아래 조건을 만족하는 테스트 배포용 버전 관리 전략이 필요함:

각 기능 브랜치별 테스트용 Version / Build 번호 규칙 정의

TestFlight에 여러 테스트 빌드가 동시에 존재할 수 있도록 구조 설계

main/deploy 브랜치의 정식 버전 증가 로직과 충돌하지 않을 것

CI/CD(Fastlane + GitHub Actions) 자동화에 무리가 없는 방식일 것

QA가 TestFlight에서 테스트 빌드를 명확히 식별 가능할 것

🙋‍♂️ 담당자

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

[github-actions]

Guide by SUH-LAB

브랜치

20251208_#388_기능개선_테스트배포_테스트용_브랜치별_앱_버전빌드_관리_전략_수립

커밋 메시지

테스트용 브랜치별 앱 버전빌드 관리 전략 수립 : feat : 변경 사항에 대한 설명 https://github.com/TEAM-ROMROM/RomRom-FE/issues/388

[Cassiiopeia]

참고로 테스트 배포에 대한 트리거에 대한 인터페이스는 간단하게

test 브랜치로 PR올리면 자동으로 처리되게 할것입니다

[Cassiiopeia]

트리거 정상 작동 확인

https://github.com/TEAM-ROMROM/RomRom-FE/actions/runs/20020402822

https://github.com/TEAM-ROMROM/RomRom-FE/actions/runs/20020388187

[Cassiiopeia]

트리거 정상 작동 확인
PR에 다음 명령어 필요

@suh-lab app build

@suh-lab build app

• 홈화면 UI 수정 반영 및기존 카드 올라갔다 내려가는 카드 애니메이션 변경점 적용 필요 #382