문제 해결

__CAPGO_KEEP_0__

Capgo

🚀 전문가의 도움을 필요로 합니까?

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

전문가 지원 받기

업로드 실패

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

__CAPGO_KEEP_0__ 앱 ID가 capacitor.config.ts Capgo 앱과 일치하는지 확인하세요.
Capacitor 프로젝트의 루트 디렉토리에서 업로드 명령을 실행하고 있는지 확인하세요.
웹 자산이 빌드되고 최신 상태인지 확인하세요.

고급 업로드 옵션

Capgo CLI은 일반적인 업로드 문제를 해결하기 위해 추가적인 플래그를 제공합니다.

--tus: __CAPGO_KEEP_1__을 사용합니다. tus 재시도 업로드 프로토콜을 사용합니다. 대용량 패키지 업로드나 느린 네트워크 연결 시 더 신뢰할 수 있는 업로드를 위해 사용하세요. 10MB 이상의 패키지를 업로드하거나 네트워크 연결이 좋지 않다면 대용량 패키지 업로드를 고려하세요. --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_KEEP_0__ __CAPGO_KEEP_1__ 문서를 참조하십시오. 업로드 옵션에 대한 자세한 내용은 Capgo CLI 문서를 참조하십시오. 업로드에 문제가 계속 발생하는 경우 __CAPGO_KEEP_0__ 지원팀에 문의하십시오.

업로드에 문제가 계속 발생하는 경우 __CAPGO_KEEP_0__ 지원팀에 문의하십시오. Capgo support Debugging Updates

실시간 업데이트와 관련된 문제가 발생하는 경우 __CAPGO_KEEP_0__ debug 명령어는 문제 해결을 위한 도구입니다.

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

터미널 창
Debugging Updates
```
npx @capgo/cli@latest app debug
```
앱을 기기나 에뮬레이터에서 실행하고 업데이트를 트리거하는 동작을 수행하세요 (예: 새로운 번들을 업로드 한 후 앱을 다시 열람).
디버그 명령어의 출력을 관찰하세요. 업데이트 프로세스에 대한 정보를 로깅합니다.
- 앱이 업데이트를 확인할 때
- 업데이트가 발견되었는지 여부와 버전
- 업데이트 다운로드 및 설치 진행 상황
- 업데이트 프로세스 중 발생하는 오류
디버그 로그를 사용하여 문제가 발생하는 위치를 식별하세요. 예를 들어:
- 업데이트가 발견되지 않으면, 번들이 올바르게 업로드되었는지 확인하고 앱이 올바른 채널을 사용하고 있는지 확인하세요.
- 업데이트가 다운로드되지만 설치되지 않으면, __CAPGO_KEEP_0__를 호출했는지 확인하고 앱이 완전히 닫혔는지 여부와 다시 열람했는지 확인하세요. CapacitorUpdater.notifyAppReady() 오류 메시지를 보게 되면, __CAPGO_KEEP_0__ 문서를 참조하거나 지원팀에 문의하세요.
- Capgo

The debug command is especially useful for identifying issues with the update download and installation process. If the logs show the expected update version was found but not ultimately applied, focus your troubleshooting on the steps after the download.

__CAPGO_KEEP_0__

In addition to the Capgo debug command, the native logs on Android, iOS, and Electron can provide valuable troubleshooting information, especially for issues on the native side of the update process.

Android Logs

To access the Android logs:

Android 기기를 연결하거나 에뮬레이터를 시작하세요.
Android Studio를 열고 "View > Tool Windows > Logcat"을 선택하세요.
Logcat 창에서 로그를 필터링하여 앱 프로세스만 선택하세요.
__CAPGO_KEEP_0__ Capgo SDK 로그를 찾으세요.

대안적으로, adb logcat 명령어와 grep 명령어를 사용하여 Capgo 로그를 필터링할 수 있습니다.

업데이트 프로세스 중 Capgo SDK에서 키 이벤트를 로깅할 것입니다. 예를 들어:

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

로그에서 일반적으로 Android에서 볼 수 있는 문제들 중 하나는:

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

iOS 로그

iOS 로그를 열기 위해:

장치에 연결하거나 시뮬레이터를 시작하세요.
Xcode를 열고 "Window > Devices and Simulators"를 클릭하세요.
장치 선택 후 "Open Console"을 클릭하세요.
콘솔 출력에서 __CAPGO_KEEP_0__ 로그를 포함하는 줄을 찾으세요. Capgo to find the SDK logs

업데이트가 설치된 후 앱을 다시 시작할 수 없습니다. log stream 터미널에서 다음 명령어를 실행하고 grep으로 로그를 찾으세요. Capgo 로그를 필터링합니다.

안드로이드와 유사하게, Capgo SDK는 iOS 측 이벤트를 로깅합니다:

업데이트 확인 시작 및 결과
다운로드 시작, 진행률 및 완료
설치 트리거 및 결과
업데이트 프로세스 중 네이티브 오류

로그에서 식별할 수 있는 iOS 전용 문제는 다음과 같습니다:

다운로드 중 SSL 인증서 문제
업데이트 다운로드를 차단하는 앱 전송 보안
업데이트 패키지에 대한 충분한 저장 공간이 없습니다.
업데이트 패키지를 올바르게 추출하거나 적용하지 못했습니다.

Electron Logs

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

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

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

Across platforms, the native logs provide a lower-level view into the update process, with more details on the native implementation. They are especially useful for identifying issues that occur outside of the Capgo JavaScript layer.

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

업데이트가 적용되지 않음

업로드 한 번들을 장치에 표시되지 않으면서 변경 사항을 확인할 수 없는 경우:

업데이트를 적용하려면 먼저 __CAPGO_KEEP_0__을 호출해야 합니다. CapacitorUpdater.notifyAppReady() 앱에서 code을 다음과 같이 호출하십시오. quickstart
인터넷에 연결된 장치가 있는지 확인하고 Capgo 디버그 로그에서 업데이트가 다운로드된 것을 확인하십시오.
앱을 완전히 종료하고 다시 열어보십시오. 업데이트는 새로고침 시에만 적용됩니다.
업데이트를 적용하는 데 문제가 있는지 native 로그를 확인하십시오.

업데이트 프로세스에 대한 자세한 내용은 live updates guide npx @capgo/cli@latest app debug 업데이트 프로세스에 대한 자세한 내용은

guide

로그가 백엔드 오류를 보여주고 있는 경우, 예를 들어 disable_auto_update_to_major, semver_error 또는 cannot_update_via_private_channel를 사용하세요.

일반적인 업데이트 문제

이것은 일반적인 code의 의미, 발생 이유, 그리고 해결 방법을 설명합니다.

SDK 설치

Capgo SDK 설치에 문제가 있는 경우, 다음을 확인하세요:

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

CI/CD 통합

CI/CD pipeline에서 Capgo 업로드를 트리거하는 문제에 대해:

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

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

Troubleshooting 섹션

만약에 사용 중이라면 문제 해결 저장소와 파일 처리를 계획하고, @capgo/capacitor-data-storage-sqlite @capgo/capacitor-data-storage-sqlite의 구현 세부 사항에 대해 @capgo/capacitor-data-storage-sqlite 사용 @capgo/capacitor-data-storage-sqlite의 원시 기능을 위해 @capgo/capacitor-file @capgo/capacitor-file의 구현 세부 사항에 대해 @capgo/capacitor-file 사용 @capgo/capacitor-file의 원시 기능을 위해 @capgo/capacitor-file, 그리고 @capgo/capacitor-업로더에 대한 구현 세부 정보.