문제 해결

복사할 수 있는 설정 지시

Capgo 문제를 해결하는 방법

🚀 전문가의 도움이 필요하세요?

복잡한 문제로 막혔나요? 전문가 팀이 도와드립니다! 개인화된 지원, code 리뷰, 및 사용자 맞춤형 솔루션을 제공합니다.

전문가 지원

업로드 실패

bundle 업로드가 실패하면 다음을 확인하세요:

애플리케이션 ID capacitor.config.ts 애플리케이션 ID가 Capgo 대시보드에 표시되는 것과 일치합니다.
Capacitor 프로젝트의 루트 디렉토리에서 업로드 명령을 실행 중입니다.
웹 자산이 빌드되고 최신 상태입니다.

고급 업로드 옵션

Capgo CLI은 업로드 문제를 해결하는 데 도움이 되는 추가 플래그를 제공합니다.

--tus: Uses the 터미널 창 클립보드 복사 --tus:
__CAPGO_KEEP_2__ : tus
```
npx @capgo/cli@latest bundle upload --tus
```
--package-json 그리고 --node-modules: Capgo에서 루트를 찾는 위치를 알려줍니다 package.json 그리고 node_modules 만약 앱이 모노레포나 npm 워크스페이스를 사용한다면 루트 경로를 전달하세요 package.json 그리고 --node_modules 경로:
터미널 창
```
npx @capgo/cli@latest bundle upload --package-json=path/to/package.json --node_modules=path/to/node_modules
```
Capgo는 앱의 의존성을 올바르게 패키징하기 위해 이 정보가 필요합니다

필요한 대로 이 플래그를 다른 옵션과 combination할 수 있습니다 --channel 필요한 대로 Capgo CLI 문서를 참조하세요 업로드 옵션에 대한 자세한 내용은

업로드 문제가 여전히 발생한다면 Capgo 지원 업데이트 디버깅

업데이트 디버깅 섹션

라이브 업데이트 문제가 발생하는 경우, Capgo 디버그 명령어는 문제 해결에 도움이 됩니다. 사용 방법은 다음과 같습니다.

터미널 창
클립보드에 복사
```
npx @capgo/cli@latest app debug
```
디버그 명령어의 출력을 확인합니다. 업데이트 프로세스에 대한 정보를 로깅합니다.
업데이트 프로세스에 대한 정보를 로깅합니다.
- 업데이트를 확인할 때 앱이 어떻게 동작하는지
- 업데이트가 발견되었는지 및 어떤 버전인지
- 업데이트 다운로드 및 설치 진행 상황
- 업데이트 과정에서 발생하는 오류
예를 들어, 디버그 로그를 사용하여 문제가 발생한 위치를 식별하세요.
- 업데이트가 발견되지 않으면, 번들을 올려서 성공적으로 업로드되었는지 확인하고 올바른 채널을 사용하는지 확인하세요.
- 업데이트가 다운로드되지만 설치되지 않는다면, CapacitorUpdater.notifyAppReady() 앱이 완전히 닫혀서 다시 열렸는지 확인하세요.
- 에러 메시지가 나타나면, 해당 에러를 Capgo 문서에서 찾아보거나 지원팀에 문의하여 도움을 받으세요.

업데이트 다운로드 및 설치 과정에서 문제가 발생하는 경우 디버그 로그가 업데이트된 버전이 발견되었지만 최종적으로 적용되지 않았다면, 로그가 보여주는 것과 달리 다운로드가 진행된 후의 단계에 집중하세요.

디버그 로그는 업데이트 다운로드 및 설치 과정에서 문제가 발생하는 경우 특히 유용합니다. 로그가 업데이트된 버전이 발견되었지만 최종적으로 적용되지 않았다면, 다운로드 후의 단계에 집중하세요.

Capgo debug 명령어 이외에도, Android, iOS, Electron에서 native 로그는 업데이트 프로세스의 native 측에서 발생하는 문제를 해결하는 데 유용한 정보를 제공합니다.

Android 로그

Android 로그에 접근하려면:

장치에 연결하거나 에뮬레이터를 시작하세요
Android Studio를 열고 "보기 > 도구 창 > 로그캣"을 선택하세요
로그캣 창에서 로그를 필터링하여 앱 프로세스만 선택하세요. 상단의 드롭다운에서 앱 프로세스를 선택하세요
__CAPGO_KEEP_0__ 로그를 찾으려면 로그의 라인 중에서 찾으세요 Capgo to find the SDK logs

명령어를 사용하여 로그를 필터링할 수 있습니다: adb logcat 명령어를 사용하여 로그를 필터링할 수 있습니다: Capgo 명령어를 사용하여 로그를 필터링할 수 있습니다:

Capgo SDK은 업데이트 프로세스 중 키 이벤트를 로깅합니다. 예를 들어:

업데이트 체크가 시작될 때
업데이트가 발견되고 어떤 버전인지
업데이트 다운로드가 시작되고 완료될 때
업데이트 설치가 트리거될 때
업데이트 단계에서 발생하는 오류

로그에서 보통 Android 관련 문제로 발생하는 문제들에는:

네트워크 연결 문제로 업데이트 다운로드가 실패하는 경우
업데이트 패키지를 저장하거나 읽을 때 파일 권한 오류
업데이트 패키지 저장 공간 부족
업데이트가 설치된 후 앱이 재시작되지 않는 경우

iOS 로그

iOS 로그에 접근하려면:

디바이스를 연결하거나 시뮬레이터를 시작하세요
Xcode를 열고 "Window > Devices and Simulators"를 클릭하세요
디바이스를 선택하고 "Open Console"을 클릭하세요
콘솔 출력에서 __CAPGO_KEEP_0__ 로그를 포함하는 줄을 찾으세요 Capgo SDK 로그를 찾으려면 터미널에서 다음 명령어를 실행하세요

터미널에서 다음 명령어를 실행하고 grep으로 로그를 필터링하세요 log stream terminal에서 명령어를 실행하고 grep 명령어를 사용하여 Capgo __CAPGO_KEEP_0__ __CAPGO_KEEP_1__는 iOS 측에서 중요한 이벤트를 로깅합니다:

iOS에서 Android와 유사하게 Capgo SDK은 iOS 측의 주요 이벤트를 로그합니다.

업데이트 체크 시작 및 결과
다운로드 시작, 진행, 완료
설치 트리거 및 결과
자연어 업데이트 프로세스 중 오류

iOS 관련 로그에서 식별할 수 있는 문제점은 다음과 같습니다:

다운로드 중 SSL 인증서 문제
업데이트 다운로드를 차단하는 앱 전송 보안
업데이트 패키지 저장소 공간 부족
업데이트 패키지를 제대로 추출하거나 적용하지 못함

Electron 로그

Electron 앱의 경우, 메인 프로세스와 렌더러 프로세스 출력을 모두 확인하십시오:

터미널에서 Electron 앱을 실행하십시오. 일반적인 런치 명령어를 사용하십시오 (예를 들어 bun run electron:dev 또는 bun run electron:serve)과 터미널 출력을 시작, 업데이트 확인 및 네트워크 오류를 확인하세요.
렌더러 창에서 개발자 도구를 열고 (보기 → 개발자 도구 토글) 업데이트 흐름을 재현하는 동안 콘솔 로그 및 실패한 네트워크 요청을 검사하세요.
패키지 앱의 경우, OS 로그 도구를 사용하여 충돌이나 시작 오류를 확인하세요:
- macOS: 열기 Console.app 앱 이름으로 필터링
- Windows: 열기 이벤트 뷰어 → Windows 로그 → 응용 프로그램
- Linux: journalctl 데스크톱 로그 뷰어를 사용하거나

업데이트 디버깅 중에 메인 프로세스와 렌더러 프로세스 로그에서 메시지를 비교하여 Electron 부트스트랩 문제와 Capgo 업데이트 라이프 사이클 문제를 분리하세요.

업데이트 중 오류를 디버깅할 때, 메인 프로세스와 렌더러 프로세스 로그에서 메시지를 비교하여 Electron 부트스트랩 문제와 Capgo 업데이트 라이프 사이클 문제를 분리하세요.

When troubleshooting a tricky live update problem, it’s a good idea to capture both the Capgo debug logs and the native logs for a comprehensive picture of what’s happening. The two logs together will give you the best chance of identifying and resolving the issue.

어떤 __CAPGO_KEEP_0 문제를 해결하기 어려울 때, CAPGO_KEEP_1__ 디버그 로그와 네이티브 로그를 모두 캡처하는 것이 좋습니다. 두 로그를 함께 사용하면 문제를 식별하고 해결하는 데 도움이 됩니다.

업데이트가 적용되지 않음

업로드한 번들을 장치에 적용되지 않으면: CapacitorUpdater.notifyAppReady() code을 호출하여 quickstart
인터넷에 연결된 장치가 있는지 확인하고 Capgo 디버그 로그가 업데이트가 다운로드 된 것을 보여주고 있습니다.
앱을 완전히 닫고 다시 열어보세요. 업데이트는 새로운 시작 시만 적용됩니다.
업데이트를 적용하는 문제가 있는지 native 로그를 확인하세요.

업데이트에 대한 자세한 내용은 실시간 업데이트 배포 가이드를 참조하세요. 문제가 해결되지 않으면 명령어와 native 로그를 사용하여 더 자세한 정보를 얻으세요. npx @capgo/cli@latest app debug 업데이트 실패 코드

업데이트 실패 코드

백엔드 에러가 표시되는 경우 (예: , ), disable_auto_update_to_major, semver_error, or cannot_update_via_private_channel실시간 업데이트 배포 가이드

일반 업데이트 문제

이것은 각 일반적인 code이 무엇을 의미하고 왜 발생하는지, 그리고 어떻게 고칠 수 있는지 설명합니다.

SDK 설치

설치 중 문제가 발생하는 경우 Capgo SDK이 올바르게 설치되었는지 확인하세요.

앱이 Capacitor의 지원되는 버전(4.0 이상)을 사용하고 있는지 확인하세요.
__CAPGO_KEEP_0__ 설치 후 앱을同步하는 등 순서대로 quickstart 단계를 따랐는지 확인하세요. CI/CD 통합 앱을 설치한 후 SDK를 동기화하는 단계를 순서대로 수행합니다.

CI/CD pipeline에서 __CAPGO_KEEP_0__ 업로드를 트리거하는 문제가 발생하는 경우

CI/CD pipeline에서 Capgo 업로드를 트리거하는 문제가 발생하는 경우

Capgo 인증 토큰이 올바르게 설정되어 있는지 확인하세요.
웹 자산이 빌드된 후 업로드 명령어를 실행하는 것을 확인하세요.
업로드 명령어가 올바른 채널 이름을 사용하여 대상 환경을 확인하세요.

See the CI/CD 통합 docs를 더 자세히 살펴보세요. 더 많은 문제 해결 팁을 찾으려면 npx @capgo/cli@latest app debug 도큐먼트를 참조하세요. 또한 CI/CD 트리거된 업데이트가 앱에 수신되는지 확인하려면 명령어를 사용하세요.

문제 해결에서 계속 진행하세요.

문제 해결을 사용하여 문제 해결 파일 처리 및 저장소 계획을 위해 연결하세요. @capgo/capacitor-SQLite 데이터 저장소 @capgo/capacitor-data-storage-sqlite 구현 세부 사항 @capgo/capacitor-data-storage-sqlite 사용 @capgo/capacitor-data-storage-sqlite의 원시 기능 @capgo/capacitor-파일 @capgo/capacitor-file 구현 세부 사항 @capgo/capacitor-file 사용 @capgo/capacitor-file의 원시 기능 @capgo/capacitor-업로더 @capgo/capacitor-uploader 구현 세부 사항