App Center
App Center는 tapflow 대시보드 안의 빌드 목록 화면입니다. Microsoft App Center와는 관계가 없습니다. 팀이 올린 iOS·Android 빌드가 앱별, 버전별로 모이고 여기서 빌드를 골라 QA 세션을 시작합니다. 대시보드에 로그인하면 가장 먼저 열리는 화면입니다.
사용 방법
- 왼쪽 Apps 목록에서 앱을 고릅니다. 앱은 bundle ID(iOS 번들 ID 또는 Android 패키지 이름)와 플랫폼으로 구분됩니다.
- 빌드는 버전 이름별로 접고 펼 수 있는 묶음(릴리스)에 모입니다. 버전 이름을 읽을 수 없는 빌드는 Unversioned 묶음에 들어갑니다.
- 테스트할 빌드 행에서 Start QA를 누릅니다. 그 빌드의 QA 세션이 열립니다.
빌드 행에는 빌드 번호, 플랫폼, 리뷰 상태 배지, 삭제 예약 배지, 업로더, 업로드 날짜가 표시됩니다.
빌드 찾기
- Search version… 검색창에 버전 이름의 일부를 입력하면 그 문자열이 들어간 버전의 빌드만 보입니다.
- 상태 필터(기본값 All statuses)에서 Backlog, In Progress, Done, Rejected 중 하나를 고르면 그 상태의 빌드만 보입니다.
조건에 맞는 빌드가 없으면 No matching builds가 표시됩니다.
빌드 업로드
- 화면 오른쪽 위의 Upload build를 누릅니다.
- File 영역을 클릭해 파일을 고르거나 파일을 끌어다 놓습니다.
- iOS: 시뮬레이터용 빌드인
.app.zip또는.tar.gz/.tgz..app.zip은 커맨드라인으로 빌드해.app폴더를 압축한 파일입니다. EAS 같은 클라우드 시뮬레이터 빌드의.tar.gz/.tgz는 그대로 올립니다. - Android:
.apk
- iOS: 시뮬레이터용 빌드인
- 필요하면 **Status (optional)**에서 리뷰 상태를 미리 고릅니다. 기본값 None이면 상태 없이 올라갑니다.
- Upload를 누릅니다. 올라가면 Build uploaded 알림이 뜨고 목록에 빌드가 추가됩니다.
iOS .ipa 파일은 지원하지 않습니다
.ipa는 실제 기기용 포맷입니다. tapflow는 시뮬레이터용 .app.zip과 .tar.gz/.tgz를 받습니다. 업로드 오류가 나면 빌드와 업로드 문제 해결을 참고하세요.
업로드한 빌드는 bundle ID를 기준으로 앱에 연결됩니다. 같은 bundle ID의 앱이 없으면 새 앱이 만들어집니다. 앱을 고른 상태에서 올리면 그 앱에 연결됩니다. 단, 빌드의 bundle ID가 그 앱과 다르면 그 bundle ID의 앱으로 갑니다.
Apps 목록 아래의 Add App으로 앱을 먼저 만들어 둘 수도 있습니다. Name, Bundle ID, Platform(iOS, Android, Both)을 입력합니다.
CI 파이프라인에서 빌드를 자동으로 올리는 방법은 CI에서 빌드 올리기를 참고하세요.
리뷰 상태
리뷰 상태는 빌드를 어디까지 확인했는지 팀에 알리는 표시입니다. 빌드 행의 상태 메뉴에서 바꿉니다.
| 상태 | 의미 |
|---|---|
| — | 상태 없음 |
| Backlog | 준비 전 |
| In Progress | 리뷰 준비 완료 |
| Done | 이해관계자 승인 완료 |
| Rejected | 문제 발견, 수정 필요 |
- Done인 빌드는 Start QA 버튼이 비활성화됩니다. 승인이 끝난 빌드를 다시 테스트하려면 상태를 먼저 바꿉니다.
- QA 세션을 열면 Mac을 고르기 전 화면 위쪽 경로 표시(breadcrumb) 옆에 상태 배지가 보입니다.
- 상태가 Done이나 Rejected로 바뀌면 운영자가 등록한 리뷰 웹훅이 호출됩니다.
빌드 삭제 예약
더 이상 필요 없는 빌드는 휴지통 아이콘(Schedule deletion)으로 삭제를 예약합니다. 확인 창에서 Schedule deletion을 누르면 7일 뒤 빌드 파일이 삭제되고 행에 Deletes in 6d 같은 남은 시간 배지가 붙습니다.
그 전에는 타이머 아이콘(Cancel scheduled deletion)을 눌러 언제든 취소할 수 있습니다. 삭제 예약은 리뷰 상태와 따로 움직입니다.
플랫폼 지원
| iOS | Android | |
|---|---|---|
| 업로드 파일 | .app.zip, .tar.gz/.tgz (시뮬레이터 빌드) | .apk |
| 앱을 구분하는 값 | 번들 ID | 패키지 이름 |
제한 사항
- Viewer 역할은 읽기 전용입니다. Viewer가 Upload build나 Add App을 누르면 창 대신 QA나 Developer 권한이 필요하다는 알림이 뜹니다. Viewer에게는 상태 메뉴와 삭제 예약 버튼이 보이지 않고 Start QA와 상태 배지만 보입니다. 역할별 권한은 팀·역할·토큰을 참고하세요.
- 목록에는 앱마다 최근에 올린 빌드 100개까지 보입니다. 더 오래된 빌드는 버전 검색으로 찾습니다.
- App Center에서는 앱 이름을 바꾸거나 앱을 지울 수 없습니다. Admin, Developer, QA 역할은 Settings → Default의 Apps 카드에서 할 수 있습니다. 앱을 지우면 그 앱의 빌드도 모두 지워집니다.
- 삭제 예약 확인 창은 항상 7일이라고 안내합니다. 운영자가 릴레이의
TAPFLOW_BUILD_TTL_DAYS를 바꿨다면 실제 기간은 그 값을 따릅니다.
문제 해결
- 업로드가
400오류로 실패하면 iOS 빌드 업로드 오류를 참고하세요. - APK가 Unversioned로 표시되거나 다른 앱에 합쳐지면 빌드와 업로드 페이지를 참고하세요.
관련 문서
- QA 세션: Start QA를 누른 뒤 Mac과 기기를 고르는 방법
- CI에서 빌드 올리기: 파이프라인에서 빌드를 자동으로 올리는 방법
- 리뷰 웹훅: 리뷰 상태가 바뀔 때 외부 시스템에 알리는 방법