StudySmarter - 학교 및 대학교
수업, 코스, 구독 변경 사항을 이해관계자가 검토해야 하는 교육 앱.
- Google Play 설치 수
- 650만
- 스토어 평점
- 4.8
CI가 각 pull request의 web build를 전용 Capgo 채널에 업로드합니다. 리뷰어는 QR code를 스캔하거나 앱에서 채널을 전환해 기기에서 직접 테스트해 볼 수 있고, PR이 닫히면 채널은 삭제됩니다. 네이티브 code 변경 사항은 여전히 새 build가 필요합니다.
문제점
개발자가 PR을 생성합니다
변경 사항은 리뷰할 준비가 되었지만, 아직 아무도 폰에서 직접 사용해 볼 수 없습니다.
빌드, 서명, 업로드
누군가 해당 브랜치의 네이티브 바이너리를 빌드하고 서명한 뒤, TestFlight나 Play 테스트 트랙에 업로드하고 처리를 기다립니다.
초대 및 설치
리뷰어를 테스터로 추가하고 해당 빌드를 직접 설치해야 합니다.
수정할 때마다 반복
code을 변경하는 리뷰 코멘트마다 빌드, 업로드, 설치를 또 해야 합니다.
JavaScript만 바뀌었더라도 리뷰는 매번 네이티브 빌드를 기다려야 합니다.
모든 빌드
스토어 처리 대기
TestFlight 또는 Play 테스트 트랙에 업로드한 각 빌드는 테스터가 설치하기 전에 처리됩니다. 모든 빌드에서 이 과정이 반복됩니다.
모든 PR
테스트하려면 네이티브 빌드가 따로 필요
Live Updates가 없으면, 웹만 바뀌어도 누군가 새 바이너리를 빌드하고 서명해 업로드해야만 리뷰어가 브랜치를 테스트할 수 있습니다.
늦은 피드백
작성자가 다음 작업으로 넘어간 뒤 리뷰 진행
리뷰가 빌드를 기다리면 피드백이 늦게 오고, 작성자는 다른 작업을 하며, 브랜치는 main에서 점점 멀어집니다.
작동 방식
CI 4단계: 스코프된 키를 한 번 설정하고, 푸시마다 업로드, 미리보기 공유, 닫을 때 정리. 아래 모든 명령은 Capgo 문서에서 가져왔습니다.
관리자가 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 키 푸시할 때마다 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 프리뷰 보기 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 참조 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 참조 두 방식 모두 사용자가 직접 할당할 수 있는 채널이 필요합니다. App Preview 키로는 이 설정이 되지 않으므로, 이 키를 사용할 때는 QR 프리뷰를 공유하거나 콘솔에서 디바이스 오버라이드를 설정하세요.
내부 빌드에서 흔들기 메뉴를 켜세요. 테스터가 기기를 흔들면 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을 리뷰하는 누구나 모바일 기기에서 직접 확인할 수 있습니다.
팀의 요구에 맞는 솔루션을 찾아보세요
Capacitor로 빌드된 앱
학습, 이벤트, 커뮤니티 앱은 온보딩, 연습, 라이브 세션, 구독 변경 사항을 동시에 검토 단계에 둘 수 있습니다. PR preview를 사용하면 제품, QA, 지원 팀이 머지 전에 모바일에서 바로 확인할 수 있는 빌드를 검토할 수 있습니다.
수업, 코스, 구독 변경 사항을 이해관계자가 검토해야 하는 교육 앱.
이벤트 플로우를 병합 전에 테스트해야 하는 실시간 참여 앱.
토너먼트 및 분석 화면을 디바이스 프리뷰로 확인할 수 있는 커뮤니티 앱입니다.
Private CTO
“설정은 하루도 안 걸렸습니다. 채널 기반 롤아웃 덕분에 프로덕션 사용자에게 배포되기 전에 제 기기에서 먼저 테스트할 수 있었습니다.”
데이터 지표
“업데이터 플러그인 정말 잘 만드셨네요. 제 환경에서는 완벽하게 동작하고, 라이브 업데이트 덕분에 테스트 주기가 훨씬 빨라졌습니다.”
Webincode 개발자
“Device ID를 특정 그룹에 추가하고 변경 사항을 해당 그룹에만 푸시할 수 있다는 점이 정말 큰 도움이 됩니다.”
자주 묻는 질문
CI를 설정하는 담당자와 리뷰어를 위한 명확한 답변을 확인하세요.
PR이 웹 레이어만 변경한다면 그럴 필요 없습니다. 리뷰어는 앱을 한 번만 설치하면 되고, 각 PR의 JavaScript, HTML, CSS, 에셋은 해당 PR의 채널로 전송됩니다. PR에서 플러그인을 추가하거나 네이티브 code를 변경하면 네이티브 빌드가 필요합니다. CI에서 build needed를 실행하면 이를 감지할 수 있습니다.
Native Build가 필요한 경우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 참조pull request closed 이벤트에 --delete-bundle과 --success-if-not-found 옵션으로 channel delete를 실행하는 job을 추가하세요. App Preview 키를 사용하면 해당 채널과 연결된 번들이 함께 삭제됩니다. 이전 푸시로 생긴 번들은 삭제 권한이 있는 키로 bundle cleanup을 실행해 정리할 수 있습니다.
채널 CLI 참조네. 단계가 Capgo CLI 명령어라서 어떤 CI에서도 실행됩니다. 문서에 GitHub Actions, GitLab CI, Bitbucket Pipelines, Azure DevOps 통합 가이드가 있습니다.
CI/CD 통합CI에 upload, QR, cleanup 단계를 추가하고 무료 체험 기간 동안 실제 앱에서 직접 테스트해 보세요.
Capgo PR preview를 사용해 보세요: 각 pull request가 자체 live update 채널을 갖습니다.
Martin이 직접 제공하는 지원
14일간 무제한 무료 체험. 카드 등록 불필요 14일 환불 보장. 언제든 취소 가능.
14일 무료 체험, 신용카드 필요 없음. 네이티브 변경 사항은 여전히 새 빌드가 필요합니다.