본문 바로가기

베타 테스트

새 TestFlight 빌드 없이 웹 변경 사항을 베타 테스터에게 배포하세요

테스터는 앱을 한 번만 설치하면 됩니다. 그다음부터는 각 JavaScript, HTML, CSS 변경 사항이 테스터가 앱에서 참여한 베타 채널로 전달되고, 다음 업데이트 확인 때 받습니다. 네이티브 code 변경 사항은 여전히 TestFlight 또는 Play 테스트 트랙을 거쳐야 합니다.

테스터가 앱에서 직접 참여

--self-assign으로 채널에서 셀프 할당을 허용하세요. 앱에서 listChannels()로 채널 목록을 불러오고 setChannel()로 디바이스를 이동하므로, 테스터가 설정 화면에서 베타에 참여할 수 있습니다.

setChannel() 레퍼런스

콘솔에서 디바이스 하나 고정

Capgo 콘솔에서 디바이스 오버라이드를 설정하면 앱을 변경하지 않고 테스터 한 명의 폰을 채널에 할당할 수 있습니다. 오버라이드는 마지막으로 설정된 후 90일이 지나면 제거됩니다.

디바이스 오버라이드

QR code로 빌드 공유

앱의 프리뷰를 한 번 활성화하세요. 그다음 get-qr을 실행하거나 upload 시 --qr-preview를 사용하면, QA 스레드에 게시할 수 있는 번들 또는 채널의 QR code와 프리뷰 링크가 출력됩니다.

get-qr 참조

Native 변경은 TestFlight가 계속 담당합니다

Live Update는 JavaScript, HTML, CSS, 에셋을 변경합니다. 플러그인을 추가하거나 Native code를 수정할 때는 새 TestFlight 또는 Play 테스트 빌드를 올린 뒤, 채널로 계속 이터레이션하세요.

Native Build가 필요한 경우

TestFlight와 Capgo 채널은 역할이 다릅니다

  • 테스터에게 새 빌드 전달하기

    TestFlight / Play 테스트
    빌드, 서명, 업로드 후 스토어 처리 대기
    Capgo beta 채널
    CLI로 번들 업로드. 테스터는 다음 업데이트 확인 때 받습니다
  • 테스터 추가하기

    TestFlight / Play 테스트
    App Store Connect 또는 Play Console에서 초대
    Capgo beta 채널
    테스터가 앱에서 채널에 참여하거나 디바이스 오버라이드를 설정
  • 테스터를 다른 빌드로 전환하기

    TestFlight / Play 테스트
    다른 빌드 설치
    Capgo beta 채널
    setChannel()로 앱에서 채널 전환
  • Native code 및 플러그인 변경 사항

    TestFlight / Play 테스트
    지원
    Capgo beta 채널
    아니요, 새 바이너리를 배포해야 합니다

테스터는 TestFlight, Play 테스트 트랙 또는 스토어에서 앱을 한 번은 설치해야 합니다. 이후 웹 레이어 변경은 채널이 처리합니다. Native Build가 필요한 경우

작동 방식

QA 팀이 Capgo를 활용해 베타를 진행하는 방법

설치된 빌드 하나, 테스터가 참여할 수 있는 채널 하나, 변경마다 CLI 업로드 한 번이면 됩니다. 아래 명령어는 모두 Capgo 문서에서 가져왔습니다.

  1. 테스터가 참여할 수 있는 베타 채널 생성

    Self-assignment를 사용하면 앱이 기기를 해당 채널로 이동시킬 수 있습니다. 프로덕션 채널에서는 이 기능을 꺼두세요.

    npx @capgo/cli@latest channel add beta com.example.app --self-assign
    Channels 문서
  2. 앱에 베타 참여 스위치 추가하기

    setChannel()은 Capgo에 채널의 self-assignment 허용 여부를 묻고, 기기에 저장합니다. triggerAutoUpdate는 즉시 업데이트 확인을 시작합니다.

    import { CapacitorUpdater } from '@capgo/capacitor-updater'
    
    // Join beta and check for its bundle now
    await CapacitorUpdater.setChannel({ channel: 'beta', triggerAutoUpdate: true })
    
    // Leave beta and go back to the default channel
    await CapacitorUpdater.unsetChannel({ triggerAutoUpdate: true })
    setChannel() 레퍼런스
  3. 변경 사항을 베타에 업로드하기

    프리뷰를 한 번 활성화하세요. 그다음부터는 업로드할 때마다 QR code를 출력해 테스터와 리뷰어가 새 bundle을 열 수 있게 합니다.

    # once
    npx @capgo/cli@latest app set com.example.app --preview
    # every change
    npx @capgo/cli@latest bundle upload --channel beta --qr-preview
    get-qr 참조
  4. QA 통과 항목 승격하기

    테스트한 bundle을 프로덕션에 연결하거나, 먼저 일부 프로덕션 기기에 배포하세요. 테스터는 베타를 떠나기 전까지 베타에 남습니다.

    npx @capgo/cli@latest channel set production com.example.app \
      --bundle 1.4.2
    # or roll it out to 10% of production first
    npx @capgo/cli@latest channel set production com.example.app \
      --rollout-bundle 1.4.2 --rollout-percentage 10 --rollout-enable
    Progressive rollouts 문서

베타 채널 사용자

내부 QA

QA는 설치된 빌드 하나를 유지하고, JavaScript가 바뀔 때마다 재설치하는 대신 qa, beta, feature 채널을 오갑니다.

베타 참여 사용자

setChannel()을 호출하는 '베타 참여' 스위치를 추가하세요. 참여를 해제하면 unsetChannel()이 호출되어 기본 채널로 돌아갑니다.

이해관계자 리뷰

get-qr에서 QR code를 보내 제품 담당자가 특정 bundle 또는 channel의 프리뷰를 열 수 있도록 하세요.

Capacitor로 빌드된 앱

커뮤니티 앱은 기능을 신중하게 노출해야 합니다

사용량이 많은 소비자용 앱은 모든 사용자에게 새로운 경험을 제공하기 전, 폐쇄형 테스터 그룹을 통해 게임, 학습 또는 예측 플로우를 검증할 수 있습니다.

lichess • 무료 온라인 체스 앱 아이콘 게임 보드

lichess • 무료 온라인 체스

토너먼트, 분석 및 소셜 기능에 대해 세심한 검증이 필요한 대규모 커뮤니티 앱입니다.

Google Play 설치 수
1,130만
스토어 평점
4.3
StudySmarter - 학교 및 대학 앱 아이콘 교육

StudySmarter - 학교 및 대학교

onboarding 및 연습 과정의 변경 사항을 출시 전에 검토해야 하는 교육 워크플로우.

Google Play 설치 수
650만
스토어 평점
4.8
Windy.com - 날씨 예보 앱 아이콘 날씨

Windy.com - 날씨 예보

제품 변경을 확장하기 전 확신이 필요한 상호작용을 예측하고 매핑하세요.

Google Play 설치 수
3,290만
스토어 평점
4.7

고객 사례

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

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

네이트 판 졸

Private CTO

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

no-tone @ Webincode

Webincode 개발자

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

Michael Haberler의 인물 사진

Michael Haberler

데이터 지표

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

자주 묻는 질문

QA 및 제품 팀이 묻는 질문

테스터, 빌드, 그리고 여전히 TestFlight가 필요한 항목에 대한 짧은 답변입니다.

Capgo가 TestFlight나 Play 내부 테스트를 대체할 수 있나요?

웹 레이어 변경 사항에만 해당됩니다. 테스터는 TestFlight, Play 테스트 트랙 또는 스토어를 통해 앱을 한 번 설치합니다. 그 이후에는 JavaScript, HTML, CSS 및 에셋 변경 사항을 채널을 통해 전달할 수 있습니다. 플러그인을 추가하거나, Capacitor를 업그레이드하거나, 네이티브 code 또는 Capacitor 설정을 변경하려면 새로운 바이너리가 필요합니다.

Native Build가 필요한 경우

테스터가 베타에 참여하거나 탈퇴하려면 어떻게 하나요?

베타 채널에 대해 self-assignment를 활성화한 다음, 앱의 화면에서 setChannel({ channel: 'beta' })를 호출하세요. Capgo가 채널이 이를 허용하는지 확인하고, 기기가 선택값을 저장합니다. unsetChannel()은 기기를 기본 채널로 되돌립니다. 기본 채널 자체는 setChannel()로 참여할 수 없습니다.

setChannel() 레퍼런스

앱을 변경하지 않고 테스터 한 명의 폰만 옮길 수 있나요?

네. Capgo 콘솔에서 해당 기기를 열고 채널 오버라이드를 설정하세요. 모든 엣지 서버에 도달하는 데 최대 2분이 걸릴 수 있고, 마지막으로 설정된 뒤 90일이 지나면 제거됩니다. 앱에서 setChannel()로 선택한 채널은 이 목록에 나타나지 않습니다.

디바이스 오버라이드

이전 live update가 위에 남지 않은 상태로 새 네이티브 빌드를 테스트하려면 어떻게 해야 하나요?

모든 네이티브 빌드마다 CapacitorUpdater.version을 올리세요. 기본 설정에서는 새 빌드를 설치하면 이전 빌드용으로 다운로드된 번들이 제거됩니다. 채널에서 개발 빌드와 에뮬레이터의 업데이트를 끌 수도 있습니다.

라이브 업데이트 없이 Native Build 테스트하기

베타 번들이 시작할 때 크래시가 나면 어떻게 되나요?

앱이 로드되면 notifyAppReady()를 한 번 호출하세요. 새 번들이 10초 안에 이를 호출하지 않으면 기기는 해당 번들을 실패로 표시하고 이전에 정상 작동하던 번들로 돌아갑니다.

notifyAppReady()와 자동 롤백

내 앱에 베타 채널 설정하기

테스터가 참여할 채널을 만들고, 스위치를 추가하고, 14일 무료 체험 기간에 첫 번들을 보내세요. 신용카드 필요 없음.