출시 준비 상태와 검증 기록
프로젝트의 설정·구현·배포·실기기 검증을 구분하고 서비스별 완료 조건과 증거를 남기는 방법입니다.
목차
출시 준비는 콘솔에서 기능을 켜는 것부터 실제 기기에서 사용하는 것까지 이어집니다. 이 문서는 어떤 프로젝트에도 적용할 수 있는 상태 구분과 기록 기준을 안내합니다. 아래 표는 확인 항목이며 특정 서비스의 작업 완료 상태를 뜻하지 않습니다.
준비물
대상 환경, 플랫폼별 앱 식별자, 검증할 빌드, 기능별 요구사항을 준비합니다. 실제 프로젝트의 도메인·계정·릴리스 이력은 접근 권한이 있는 내부 기록에서 관리하고 공개 가이드에는 넣지 않습니다.
단계
- 상태를 구분합니다. 설정 완료, 코드 구현, 환경 배포, 실제 동작 검증을 각각 기록합니다. 코드 작성이나 업로드 성공을 기능 전체의 완료로 표시하지 않습니다.
- 완료 조건을 정합니다. 각 기능에 필요한 콘솔 상태, 앱·서버 동작, 실제 기기 확인 항목을 적습니다.
- 같은 빌드를 검증합니다. 소스 커밋, 빌드 번호, 서명, 설치 경로와 서버 환경을 대조합니다.
- 증거와 후속 작업을 남깁니다. 성공·실패 결과, 재현 방법, 다음 조치와 담당 범위를 기록합니다. 계정 승인이나 외부 심사는 대기 상태로 표시합니다.
상태 구분
| 상태 | 기록할 내용 | 다음 확인 |
|---|---|---|
| 설정 완료 | 프로젝트·앱·권한·구성값이 준비됨 | 앱·서버에서 실제 사용 가능한지 확인 |
| 구현 완료 | 필요한 코드와 자동 검사가 준비됨 | 대상 환경에 배포한 버전 확인 |
| 배포 완료 | 서버나 테스트 트랙에 대상 버전이 반영됨 | 설치·로그인·핵심 기능 검증 |
| 검증 완료 | 정해 둔 환경과 시나리오에서 실제 동작 확인 | 검증 범위와 결과 보관 |
| 외부 처리 대기 | 개발자 등록·계약·심사 등 선행 조건이 남음 | 승인 뒤 설정·배포·검증 재개 |
| 해당 없음 | 제품에서 해당 기능을 사용하지 않음 | 기능을 도입할 때 기준 재검토 |
Firebase·GCP·스토어
| 항목 | 설정·구현에서 확인할 것 | 배포·실기기에서 확인할 것 |
|---|---|---|
| Firebase 프로젝트·플랫폼 앱 | 환경별 프로젝트와 앱 식별자 일치 | 실제 앱이 의도한 프로젝트에 연결됨 |
| Android 서명 | 업로드 키와 Play 앱 서명 키의 인증서 구분 | Play 설치본에서 인증과 앱 링크 동작 |
| Play 내부 테스트 | 트랙·테스터·빌드 번호·출시 상태 | 대상 테스터가 올바른 버전을 설치·실행 |
| App Distribution | 바이너리 처리·출시 노트·테스터 배포 | 초대 수락·설치·실행 |
| Cloud Billing·Phone OTP | 프로젝트 결제 연결·Phone 제공자·SMS 지역 정책 | 실제 SMS 수신과 서버 검증 |
| OAuth·서버 로그인 | 원본·콜백·공개 클라이언트 ID·서버 비밀 연결 | 로그인·취소·로그아웃·계정 충돌 처리 |
| Play Developer API | API 활성화·서비스 계정·대상 앱 권한 | CI의 트랙 조회·업로드·출시 결과 재조회 |
| Remote Config | 기본값·템플릿 게시·가져오기·활성화 | 네트워크 실패 시 기본값 또는 마지막 활성값 사용 |
| FCM | 앱 권한·기기 등록·서버 발송 권한·로그아웃 정리 | 전경·백그라운드·종료 상태의 수신과 이동 |
| Android PNV | 지원 여부·동의·서버 토큰 검증·기존 번호 연결 | 지원 기기 인증과 미지원·취소 시 대체 경로 |
| Apple 개발자 기능 | 등록·계약·실제 Team ID·로그인·APNs 구성 | 해당 Apple 기기에서 인증과 알림 동작 |
| 앱 링크 | 도메인 연결 파일·서명·경로·인증 콜백 제외 | 설치·미설치 상태와 로그인 필요 경로 동작 |
표의 모든 항목이 모든 제품에 필요한 것은 아닙니다. 사용할 기능만 선택하고, 사용하지 않는 기능은 해당 없음으로 기록합니다. 기능을 선택했다면 설정과 실제 동작 확인을 함께 마칩니다.
검증 기록에 넣을 정보
- 검증 날짜, 대상 환경과 사용한 기기·OS
- 소스 커밋, 빌드 번호, 아티팩트 해시와 설치 경로
- 실행한 시나리오, 기대 결과와 실제 결과
- 실패 재현 방법, 남은 제약과 다음 확인 항목
이 정보는 팀의 내부 검증 기록에 보관합니다. 공개 문서를 만들 때는 프로젝트명·도메인·식별자·계정 정보·운영 이력을 제거하고 예시임이 분명한 값이나 일반 절차로 바꿉니다. 화면 캡처와 파일 이름·경로·검색 색인에도 같은 기준을 적용합니다.
확인
- 각 기능에 설정·구현·배포·검증 상태가 각각 기록되어 있습니다.
- 검증한 빌드와 실제 배포 버전이 일치합니다.
- 외부 승인 대기와 미검증 항목이 완료로 표시되지 않았습니다.
- 공개 자료에서 특정 프로젝트를 식별할 수 있는 글자·주소·이미지를 제거했습니다.
자주 겪는 문제
API를 켜거나 파일을 업로드했으면 완료인가요?
그 단계의 완료입니다. 사용할 앱·서버에서의 권한과 동작, 대상 기기 설치·실행까지 확인해야 기능 전체를 완료로 기록할 수 있습니다.
Apple 등록이나 외부 심사를 기다리는 동안 어떻게 기록하나요?
외부 처리 대기로 표시하고 승인 뒤 이어갈 작업을 적습니다. 다른 기능의 설정과 검증은 별도로 진행합니다. 실제로 발급되지 않은 ID나 키를 임의 값으로 채우지 않습니다.
다음 단계
설정은 Firebase 초기화와 GCP 인증·Play API를, 설치 확인은 Android 내부 테스트·App Distribution을 따르세요. 배포 이후에는 업데이트 운영 기준으로 기록을 갱신합니다.