문제 해결

설치 단계와 이 플러그인의 전체 마크다운 가이드를 포함한 설정 프롬프트를 복사하십시오.

Here are some common issues you might encounter while using Capgo and how to resolve them.

복잡한 문제로 막혔나요? 전문가 팀이 도와드리겠습니다! 개인화된 지원, __CAPGO_KEEP_0__ 리뷰, 그리고 고객님의 특정 요구에 맞춘 맞춤 솔루션을 제공합니다.

Stuck with a complex issue? Our expert team is here to help! Get personalized support, code reviews, and custom solutions tailored to your specific needs.

업로드 실패

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

__CAPGO_KEEP_0__ 대시보드에 등록된 앱 ID가 capacitor.config.ts Capgo 프로젝트의 루트 디렉토리에서 업로드 명령을 실행하고 있는지
You’re running the upload command from the root of your Capacitor project
고급 업로드 옵션

고급 업로드 옵션

The Capgo CLI provides some additional flags to help with common upload issues:

--tus대형 배달 또는 네트워크 연결이 좋지 않은 경우 더 신뢰할 수 있는 업로드를 위해 10MB 이상의 배달이거나 네트워크 연결이 좋지 않은 경우 __CAPGO_KEEP_2__ 프로토콜을 사용하는 것을 고려해 보세요. 터미널 창 --tus:
__CAPGO_KEEP_2__
```
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 needs this information to correctly bundle your app’s dependencies.

__CAPGO_KEEP_0__은 앱의 종속성을 올바르게 패키징하기 위해 이 정보가 필요합니다. --channel 이 플래그를 다른 옵션과 함께 combining할 수 있습니다. Capgo CLI 문서 업로드 옵션에 대한 자세한 내용은 여기서 확인하실 수 있습니다.

업로드 문제가 해결되지 않으시면, Capgo 지원팀 추가 도움을 받으시려면.

디버깅 업데이트

If you’re encountering issues with live updates, the Capgo debug command is a helpful tool for troubleshooting. To use it:

__CAPGO_KEEP_0__ 디버깅 명령어는 문제 해결을 위한 도구입니다. 사용 방법은 다음과 같습니다.
프로젝트 디렉토리에서 다음 명령어를 실행하세요.
```
npx @capgo/cli@latest app debug
```
복사
업데이트 명령의 출력을 관찰하세요. 업데이트 프로세스에 대한 정보를 포함하여:
- 앱이 업데이트 확인을 할 때
- 업데이트가 발견되었는지 및 어떤 버전인지
- 업데이트 다운로드 및 설치 진행 상황
- 업데이트 프로세스 중 오류가 발생한 경우
__CAPGO_KEEP_0__ 문서에서 해당 오류를 검색하거나 지원팀에 문의하여 도움을 받으세요.
- 디버그 로그를 사용하여 문제가 발생한 위치를 식별하세요. 예를 들어:
- 업데이트가 발견되지 않는 경우, 번들 업로드가 성공적으로 완료되었는지 확인하고 올바른 채널을 사용하는지 확인하세요. CapacitorUpdater.notifyAppReady() 업데이트가 다운로드되지만 설치되지 않는 경우, __CAPGO_KEEP_0__.call()이 호출되었는지 확인하고 앱이 완전히 종료되었는지 확인한 후 다시 열어보세요.
- If you see an error message, look up that specific error in the Capgo docs or reach out to support for help.

네이티브 로그를 사용한 디버깅

Debugging with Native Logs

Capgo 디버그 명령 외에도 안드로이드, iOS, Electron에서 제공하는 네이티브 로그는 업데이트 프로세스의 네이티브 측에서 발생하는 문제를 해결하는 데 유용한 정보를 제공할 수 있습니다.

안드로이드 로그

안드로이드 로그에 접근하려면:

장치에 연결하거나 에뮬레이터를 시작하십시오.
안드로이드 스튜디오를 열고 “보기 > 도구 창 > 로그캣”을 선택하십시오.
로그캣 창에서 로그를 필터링하여 앱 프로세스만 선택하십시오.
__CAPGO_KEEP_0__ 로그를 찾으려면 Capgo 또는 명령어를 사용하여 grep으로 SDK 로그를 찾으십시오.

__CAPGO_KEEP_0__ 로그 adb logcat 명령어 Capgo 로그를 필터링합니다.

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

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

로그에서 일반적으로 Android에서 볼 수 있는 문제로는 다음과 같은 것이 있습니다:

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

iOS 로그

iOS 로그에 접근하려면:

디바이스를 연결하거나 시뮬레이터를 시작하세요
Xcode를 열고 "Window > Devices and Simulators"를 클릭하세요
디바이스를 선택하고 "Open Console"을 클릭하세요
콘솔 출력에서 __CAPGO_KEEP_0__ 로그를 찾으세요 Capgo 디바이스에서 SDK 로그를 찾으세요

터미널에서 __CAPGO_KEEP_2__ 명령어를 사용하세요 log stream 로그를 필터링하려면 __CAPGO_KEEP_3__를 grep하세요 Capgo iOS에서 __CAPGO_KEEP_1__ 이벤트를 로깅합니다

Similar to Android, the Capgo SDK will log key iOS-side events:

업데이트 확인 시작 및 결과
다운로드 시작, 진행, 완료
설치 트리거 및 결과
자연어 업데이트 과정에서 발생하는 오류

iOS 관련 로그에서 식별할 수 있는 문제:

업데이트 다운로드 시 SSL 인증서 문제
업데이트 다운로드가 앱 전송 보안으로 차단됨
업데이트 패키지 저장소 공간 부족
업데이트 패키지를 올바르게 추출하거나 적용하지 못함

Electron 로그

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

터미널에서 Electron 앱을 실행하세요. 일반적인 런치 명령어를 사용하세요 (예를 들어 bun run electron:dev 또는 bun run electron:serve). 시작, 업데이트 확인, 네트워크 오류와 같은 터미널 출력을 감시하세요.
렌더러 창에서 DevTools를 열어 (View → Toggle Developer Tools) 콘솔 로그와 업데이트 흐름 중 실패한 네트워크 요청을 검사하세요.
패키징된 앱의 경우 OS 로그 도구에서 충돌이나 시작 오류를 확인하세요:
- macOS: open Console.app 및 앱 이름으로 필터링하세요
- Windows: Event Viewer Windows Logs → Windows Logs → Application
- 리눅스: 데스크톱 로그 뷰어 또는 journalctl 앱 프로세스

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

플랫폼 간에 네이티브 로그는 업데이트 프로세스에 대한 더 낮은 수준의 시각화를 제공하며, 네이티브 구현에 대한 더 많은 세부 정보를 제공합니다. 특히 Capgo 자바스크립트层 외부에서 발생하는 문제를 식별하는 데 특히 유용합니다.

트러블 슈팅 중에 어려운 라이브 업데이트 문제가 발생하는 경우, Capgo 디버그 로그와 네이티브 로그를 모두 캡처하는 것이 좋습니다. 두 로그를 함께 사용하면 문제를 식별하고 해결하는 데 가장 좋은 기회가 될 것입니다.

업데이트가 적용되지 않음

업로드한 번들을 장치에 표시되지 않는 경우:

__CAPGO_KEEP_0__을 CapacitorUpdater.notifyAppReady() in your app code as shown in the quickstart
인터넷에 연결된 기기를 확인하고 Capgo 디버그 로그가 업데이트가 다운로드 된 것을 보여주고 있는지 확인하세요.
앱을 완전히 종료하고 다시 열어보세요. 업데이트는 새로 고침 시에만 적용됩니다.
업데이트를 적용하는 문제가 있는지 native 로그를 확인하세요.

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

업데이트 실패 코드

백엔드 에러가 로그에 나타나면 disable_auto_update_to_major, semver_error백엔드 에러가 로그에 나타나면 cannot_update_via_private_channel__CAPGO_KEEP_0__ 가이드를 사용하세요.

일반적인 업데이트 문제

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

SDK 설치

Capgo SDK을 설치하는 데 문제가 있으시면, 다음을 확인하세요:

앱이 Capacitor의 지원되는 버전 (4.0 이상)을 사용하고 있는지 확인하세요.
__CAPGO_KEEP_0__ 설치 후에 앱을同步한 후에 빠른 시작 steps in order, including syncing your app after installing the SDK

CI/CD 통합

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

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

더 많은 문제 해결 팁을 찾으려면 CI/CD 통합 문서를 참조하세요. 또한 npx @capgo/cli@latest app debug 명령을 사용하여 CI/CD 트리거된 업데이트가 앱에 수신되는지 확인하세요.