본문 바로가기
PR 미리보기

실제 폰에서 모든 pull request 리뷰

CI가 각 pull request의 web build를 전용 Capgo 채널에 업로드합니다. 리뷰어는 QR code를 스캔하거나 앱에서 채널을 전환해 기기에서 직접 테스트해 볼 수 있고, PR이 닫히면 채널은 삭제됩니다. 네이티브 code 변경 사항은 여전히 새 build가 필요합니다.

  • 풀 리퀘스트당 채널 하나
  • QR code 미리보기
  • PR이 닫히면 정리

문제점

웹 변경 사항을 리뷰하는 데 새 바이너리가 필요해서는 안 됩니다

스토어 테스트 빌드로 PR을 검토하는 과정

  1. 개발자가 PR을 생성합니다

    변경 사항은 리뷰할 준비가 되었지만, 아직 아무도 폰에서 직접 사용해 볼 수 없습니다.

  2. 빌드, 서명, 업로드

    누군가 해당 브랜치의 네이티브 바이너리를 빌드하고 서명한 뒤, TestFlight나 Play 테스트 트랙에 업로드하고 처리를 기다립니다.

  3. 초대 및 설치

    리뷰어를 테스터로 추가하고 해당 빌드를 직접 설치해야 합니다.

  4. 수정할 때마다 반복

    code을 변경하는 리뷰 코멘트마다 빌드, 업로드, 설치를 또 해야 합니다.

JavaScript만 바뀌었더라도 리뷰는 매번 네이티브 빌드를 기다려야 합니다.

팀이 치르는 비용

모든 빌드

스토어 처리 대기

TestFlight 또는 Play 테스트 트랙에 업로드한 각 빌드는 테스터가 설치하기 전에 처리됩니다. 모든 빌드에서 이 과정이 반복됩니다.

모든 PR

테스트하려면 네이티브 빌드가 따로 필요

Live Updates가 없으면, 웹만 바뀌어도 누군가 새 바이너리를 빌드하고 서명해 업로드해야만 리뷰어가 브랜치를 테스트할 수 있습니다.

늦은 피드백

작성자가 다음 작업으로 넘어간 뒤 리뷰 진행

리뷰가 빌드를 기다리면 피드백이 늦게 오고, 작성자는 다른 작업을 하며, 브랜치는 main에서 점점 멀어집니다.

작동 방식

Capgo로 풀 리퀘스트를 미리 보는 방법

CI 4단계: 스코프된 키를 한 번 설정하고, 푸시마다 업로드, 미리보기 공유, 닫을 때 정리. 아래 모든 명령은 Capgo 문서에서 가져왔습니다.

  1. App Preview 키 생성 및 프리뷰 활성화

    관리자가 CI용 App Preview API 키를 생성합니다. 이 키로 프리뷰 채널을 만들고 bundle을 업로드할 수 있지만, 기본 채널이나 프로덕션 채널은 변경할 수 없습니다. 프리뷰는 앱당 한 번만 활성화하면 됩니다.

    # once, run by an admin (not the preview key)
    npx @capgo/cli@latest app set com.example.app --preview
    App Preview API 키
  2. PR 빌드를 전용 채널에 업로드

    푸시할 때마다 CI가 웹 앱을 빌드하고 고유한 bundle 버전으로 업로드합니다. bundle upload --channel 명령은 pr-<number> 채널이 없으면 생성하고 bundle을 해당 채널에 연결합니다.

    npx @capgo/cli@latest bundle upload com.example.app \
      --apikey "$CAPGO_PREVIEW_KEY" \
      --path ./dist \
      --channel "pr-$PR_NUMBER" \
      --bundle "1.2.3-pr.$PR_NUMBER.$GITHUB_RUN_NUMBER"
    채널 문서에서 PR 프리뷰 보기
  3. PR에 프리뷰 게시

    get-qr는 채널용 QR code를 출력하거나, --url로 프리뷰 URL을 출력해 CI가 PR 코멘트에 추가할 수 있게 합니다.

    npx @capgo/cli@latest get-qr com.example.app \
      --channel "pr-$PR_NUMBER" \
      --apikey "$CAPGO_PREVIEW_KEY" \
      --url
    get-qr 참조
  4. PR이 닫히면 채널 삭제

    pull request closed 이벤트 발생 시 실행하세요. App Preview 키를 사용하면 해당 키가 만든 채널과 연결된 bundle만 삭제합니다.

    npx @capgo/cli@latest channel delete \
      "pr-$PR_NUMBER" com.example.app \
      --apikey "$CAPGO_PREVIEW_KEY" \
      --delete-bundle \
      --success-if-not-found
    채널 CLI 참조

리뷰어가 PR 채널로 전환하는 다른 방법

두 방식 모두 사용자가 직접 할당할 수 있는 채널이 필요합니다. App Preview 키로는 이 설정이 되지 않으므로, 이 키를 사용할 때는 QR 프리뷰를 공유하거나 콘솔에서 디바이스 오버라이드를 설정하세요.

Shake 메뉴

내부 빌드에서 흔들기 메뉴를 켜세요. 테스터가 기기를 흔들면 Capgo의 테스트 메뉴가 열리고, 흔들기 채널 선택기에서 채널을 고를 수 있습니다.

// capacitor.config.ts (internal builds)
CapacitorUpdater: {
  shakeMenu: true,
}

인앱 스위처

개발자 설정 화면에 채널 필드를 추가하고, PR 채널 이름으로 setChannel()을 호출하세요.

import { CapacitorUpdater } from '@capgo/capacitor-updater'

await CapacitorUpdater.setChannel({
  channel: 'pr-123',
  triggerAutoUpdate: true,
})
setChannel() 레퍼런스

PR preview는 누가 사용하나요?

작성자뿐만 아니라 PR을 리뷰하는 누구나 모바일 기기에서 직접 확인할 수 있습니다.

QA 엔지니어

  • PR의 web build를 내 기기에서 테스트하세요
  • 앱 재설치 없이 PR 채널 간 이동 가능
  • 채널 이름이 PR 번호와 일치하므로, 현재 어떤 code를 실행 중인지 즉시 알 수 있습니다.

프로젝트 매니저

  • 기능이 머지되기 전에 모바일에서 미리 확인하세요
  • PR에 게시된 QR code를 스캔하세요
  • PR에서 직접 피드백을 남기세요

개발자

  • PR이 열려 있는 동안 기기 피드백을 받으세요
  • 푸시할 때마다 PR 채널이 업데이트됩니다
  • JS 변경 사항에는 Native Build가 필요 없습니다

스토어 테스트 빌드 vs Capgo PR 채널

  • PR을 휴대폰에 올리는 방법

    TestFlight / Play 테스트
    Native Build, 서명 및 스토어 처리
    Capgo PR 채널
    CI에서 Web build 및 bundle upload
  • PR 간 전환

    TestFlight / Play 테스트
    다른 빌드 설치
    Capgo PR 채널
    다른 QR code 스캔 또는 채널 전환
  • 리뷰어 설정

    TestFlight / Play 테스트
    테스터 초대 후 각 빌드 설치
    Capgo PR 채널
    앱을 한 번만 설치
  • Native code 및 플러그인 변경 사항

    TestFlight / Play 테스트
    지원
    Capgo PR 채널
    아니요, Native Build가 필요합니다

Capacitor로 빌드된 앱

제품 앱에는 검토 가능한 모바일 변경이 필요합니다

학습, 이벤트, 커뮤니티 앱은 온보딩, 연습, 라이브 세션, 구독 변경 사항을 동시에 검토 단계에 둘 수 있습니다. PR preview를 사용하면 제품, QA, 지원 팀이 머지 전에 모바일에서 바로 확인할 수 있는 빌드를 검토할 수 있습니다.

StudySmarter - 학교 및 대학 앱 아이콘 교육

StudySmarter - 학교 및 대학교

수업, 코스, 구독 변경 사항을 이해관계자가 검토해야 하는 교육 앱.

Google Play 설치 수
650만
스토어 평점
4.8
Poll Everywhere 앱 아이콘 비즈니스

Poll Everywhere

이벤트 플로우를 병합 전에 테스트해야 하는 실시간 참여 앱.

Google Play 설치 수
110만
스토어 평점
3.2
lichess • 무료 온라인 체스 앱 아이콘 게임 보드

lichess • 무료 온라인 체스

토너먼트 및 분석 화면을 디바이스 프리뷰로 확인할 수 있는 커뮤니티 앱입니다.

Google Play 설치 수
1,130만
스토어 평점
4.3

고객 사례

Capgo로 배포하는 팀들의 이야기

5.0/5 개발 팀 평점 9,400+ 팀 리뷰 보기

네이트 판 졸

Private CTO

“설정은 하루도 안 걸렸습니다. 채널 기반 롤아웃 덕분에 프로덕션 사용자에게 배포되기 전에 제 기기에서 먼저 테스트할 수 있었습니다.”

Michael Haberler의 인물 사진

Michael Haberler

데이터 지표

“업데이터 플러그인 정말 잘 만드셨네요. 제 환경에서는 완벽하게 동작하고, 라이브 업데이트 덕분에 테스트 주기가 훨씬 빨라졌습니다.”

no-tone @ Webincode

Webincode 개발자

“Device ID를 특정 그룹에 추가하고 변경 사항을 해당 그룹에만 푸시할 수 있다는 점이 정말 큰 도움이 됩니다.”

자주 묻는 질문

PR preview에 대해 팀이 자주 묻는 질문

CI를 설정하는 담당자와 리뷰어를 위한 명확한 답변을 확인하세요.

리뷰어가 PR마다 새로운 빌드를 받아야 하나요?

PR이 웹 레이어만 변경한다면 그럴 필요 없습니다. 리뷰어는 앱을 한 번만 설치하면 되고, 각 PR의 JavaScript, HTML, CSS, 에셋은 해당 PR의 채널로 전송됩니다. PR에서 플러그인을 추가하거나 네이티브 code를 변경하면 네이티브 빌드가 필요합니다. CI에서 build needed를 실행하면 이를 감지할 수 있습니다.

Native Build가 필요한 경우

CI 키가 프로덕션 채널에 접근할 수 있나요?

App Preview API 키로는 불가능합니다. 이 키는 프리뷰 채널 생성, 번들 업로드, 자신이 만든 채널과 번들 삭제만 할 수 있습니다. 기본(default) 채널이나 메인 채널은 변경할 수 없습니다. GitHub Actions에서는 pull_request_target이 아닌 pull_request에서 job을 실행하고, 같은 리포지토리의 PR로만 제한하세요.

App Preview API 키

리뷰어는 프리뷰를 어떻게 열까요?

관리자가 app set --preview로 프리뷰를 한 번만 활성화하면 됩니다. 그다음 get-qr이 PR 채널의 QR code를 출력하고, --url은 웹 프리뷰 URL과 딥링크를 출력합니다. 이걸 PR 코멘트에 남기면 됩니다.

get-qr 참조

이전 PR 채널과 번들은 어떻게 되나요?

pull request closed 이벤트에 --delete-bundle과 --success-if-not-found 옵션으로 channel delete를 실행하는 job을 추가하세요. App Preview 키를 사용하면 해당 채널과 연결된 번들이 함께 삭제됩니다. 이전 푸시로 생긴 번들은 삭제 권한이 있는 키로 bundle cleanup을 실행해 정리할 수 있습니다.

채널 CLI 참조

GitLab, Bitbucket 또는 Azure DevOps에서도 작동하나요?

네. 단계가 Capgo CLI 명령어라서 어떤 CI에서도 실행됩니다. 문서에 GitHub Actions, GitLab CI, Bitbucket Pipelines, Azure DevOps 통합 가이드가 있습니다.

CI/CD 통합

다음 Pull Request를 휴대폰에서 미리 보세요

CI에 upload, QR, cleanup 단계를 추가하고 무료 체험 기간 동안 실제 앱에서 직접 테스트해 보세요.

14일 무료 체험, 신용카드 필요 없음. 네이티브 변경 사항은 여전히 새 빌드가 필요합니다.