개요

이 퀵스타트 튜토리얼에서는 Capgo의 핵심 개념을 하나씩 살펴봅니다! 다룰 개념은 다음과 같습니다:

1. Capgo 계정에 앱 추가하기

2. CI/CD에 Capgo 통합하기

3. 커밋 푸시로 Capgo 번들 업로드 트리거하기

4. Capgo 번들 퍼블리싱 설정 및 커스터마이징

5. Capgo를 통한 Live Update 활성화 설정

6. Capgo에서 앱으로 Live Update 배포하기

가이드를 단계별로 따라 하거나, 관심 있는 컴포넌트의 문서를 바로 확인해 보세요.

튜토리얼 시작하기

퀵스타트 튜토리얼을 따라 Capgo를 빠르게 시작해 보세요!

CLI 온보딩 가이드

인터랙티브 CLI 온보딩을 위한 단계별 가이드입니다.

업데이트 배포하기

Capgo 대시보드에서 앱에 업데이트를 배포하세요.

업데이트 자동화

Capgo를 CI/CD에 통합하여 커밋 푸시만으로 Capgo에 번들 업로드를 트리거할 수 있습니다.

Troubleshooting

자주 발생하는 문제와 해결 방법입니다.

마무리

튜토리얼을 마치며 학습한 내용을 빠르게 정리해 봅니다.

팁

Over-the-Air (OTA) 업데이트 기능은 HTML, CSS, JavaScript 파일 수정에만 적용됩니다.

Capacitor 플러그인 업데이트와 같이 네이티브 code를 변경한 경우, 반드시 앱 스토어에 다시 제출하여 승인을 받아야 합니다.

Bundle 기밀성

Capgo 암호화를 활성화하지 않으면 Capgo에 업로드된 모든 bundle은 공개 웹 에셋으로 취급됩니다. Private channel은 업데이트를 받을 기기를 제어하지만, 업로드된 bundle을 기밀로 만들지는 않습니다. 암호화는 전달 경로를 보호하고 제3자가 유효한 암호화된 업데이트를 생성하는 것을 방지하지만, 공개 키가 바이너리에 포함되어 있으므로 충분한 노력을 기울이면 앱에서 배포된 웹 에셋을 역공학할 수 있습니다. 자세한 내용은 Live Update 암호화.

Discord 커뮤니티 참여하기

Capgo Discord 서버에 참여하세요!

유지보수

Plugin 버전	Capacitor 호환성	유지보수 중
v7.*.* (≥7.25.0)	v7.*.*	✅ 완벽 지원
v6.*.* (≥6.25.0)	v6.*.*	✅ 완벽 지원
v5.*.* (≥5.10.0)	v5.*.*	✅ 완벽 지원
v5.*.* (<5.10.0)	v5.*.*	⚠️ 지원 중단 예정
v4.*.*	v4.*.*	❌ 지원 종료
v3.*.*	v3.*.*	❌ 지원 종료
>= 8	v4.*.*	⚠️ CI 프로세스 버전 이슈로 인해 사용이 권장되지 않습니다

스토어 가이드라인 준수

Android Google Play와 iOS App Store에는 관련 가이드라인이 있습니다. 애플리케이션에 Capacitor-updater 솔루션을 통합하기 전에 반드시 해당 규칙을 숙지해야 합니다.

Google Play

~의 세 번째 단락 기기 및 네트워크 악용 주제에서는 Google Play 업데이트 메커니즘 외의 방법으로 code 소스를 업데이트하는 것이 제한된다고 설명합니다. 하지만 이 제한은 JavaScript bundle 업데이트에는 적용되지 않습니다.

이 제한은 가상 머신에서 실행되며 Android API에 대한 액세스가 제한된 code에는 적용되지 않습니다(예: webview 또는 브라우저의 JavaScript).

따라서 Capacitor-updater는 JS bundle만 업데이트하고 네이티브 code은 업데이트하지 않으므로 완전히 허용됩니다.

App Store

단락 3.3.2, 2015년의 Apple Developer Program 라이선스 계약 JavaScript 및 에셋의 over-the-air 업데이트를 완전히 허용하며, 최신 버전(20170605)에서도 마찬가지입니다. 여기서 다운로드 가능 이 판결은 훨씬 더 광범위합니다:

해석된 code는 애플리케이션에 다운로드될 수 있지만, 해당 code가 다음 조건을 충족하는 경우에만 가능합니다: (a) App Store에 제출된 애플리케이션의 의도 및 홍보된 목적과 일치하지 않는 기능이나 동작을 제공하여 애플리케이션의 주요 목적을 변경하지 않아야 하며, (b) 다른 code 또는 애플리케이션을 위한 스토어나 스토어프론트를 만들지 않아야 하고, (c) OS의 서명, 샌드박스 또는 기타 보안 기능을 우회하지 않아야 합니다.

Capacitor Updater를 사용하면 푸시하는 업데이트가 App Store에서 승인된 제품의 원래 의도에서 크게 벗어나지 않는 한 이 규칙을 완전히 준수할 수 있습니다.

Apple 가이드라인을 계속 준수하려면 App Store를 통해 배포되는 앱에서는 다음을 활성화하지 않는 것을 권장합니다: Force update 시나리오는, ...에서 App Store 리뷰 가이드라인 다음과 같이 명시합니다:

앱은 사용자가 기능, 콘텐츠 또는 앱 이용에 접근하기 위해 앱 평가, 리뷰 작성, 다른 앱 다운로드 또는 이와 유사한 행동을 하도록 강제해서는 안 됩니다.

백그라운드 업데이트의 기본 동작은 사용자가 다음에 앱을 종료할 때까지 새 버전 적용을 강제하지 않으므로 문제가 되지 않습니다. 하지만 해당 기능을 노출하기로 결정했다면 최소한 그 역할은 알고 있어야 합니다.

오픈 소스

이 플러그인은 LGPL-3.0 라이선스를 따르며, 백엔드는 AGPL-3.0 라이선스를 따릅니다.

💡 LGPL-3.0은 플러그인의 code를 수정하면 동일한 라이선스로 오픈소스에 공개해야 함을 의미합니다. code을 수정 없이 사용한다면 해당되지 않습니다. 자세한 내용은 아래 이슈에서 링크를 확인하세요 👇

라이선스?

문서를 읽는 대신 GPTS Capgo를 통해 도움을 받아보세요

걱정 없이 앱에 포함할 수 있습니다

마치며

직접 호스팅하며 이 도구가 유용하다고 느끼셨다면, 제 작업을 후원하는 방법으로 GitHub 스폰서가 되어주세요.

저는 유료화하는 대신 제가 여기서 만든 모든 code를 오픈소스로 공개하기로 결심했습니다. 싸우거나 숨기기보다 공개함으로써 더 나은 세상을 만들 수 있다고 믿습니다.

이를 실현하려면 여러분을 포함한 우리 모두가 각자 역할을 해야 합니다 🥹. Capgo cloud가 니즈에 맞지 않는다면, GitHub Sponsors에서 자력으로 시작한 메이커를 후원할 수 있습니다 원하는 방식으로.

간단한 수학 연산

기본 플랜 가격: $14*12 = 연간 $168. 평균 개발자 시급 = $60. 즉, 셀프 호스팅에 개발 시간 3시간을 허비하면 1년 치 비용이 나가는 셈입니다. 3시간 이상 쓰신다면 오히려 손해예요 ^^

개요에서 계속하기

사용 중이라면 개요 CI/CD 자동화를 계획하려면, 다음을 연결하세요 Capgo CI/CD 설정하기 Capgo CI/CD의 제품 워크플로우용, Capgo Native Build Capgo Native Builds의 제품 워크플로우용, Capgo 연동 서비스 Capgo Integrations의 제품 워크플로우용, CI/CD 통합 CI/CD Integration의 구현 세부 사항은, 그리고 GitHub Actions 연동 GitHub Actions Integration의 구현 세부 사항을 참고하세요.