문제 해결

이 플러그인의 설치 단계와 전체 마크다운 가이드를 포함한 설정 지시를 복사하세요.

Capgo 문제를 해결하는 방법

🚀 전문가의 도움을 받으세요.

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

전문가 지원 받기

업로드 실패

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

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

고급 업로드 옵션

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

--tus: 대용량 배ंडल 또는 네트워크 연결이 좋지 않은 경우 더 신뢰할 수 있는 업로드를 위해 tus 재시작 업로드 프로토콜을 사용합니다. 배ंडल이 10MB를 초과하거나 네트워크 연결이 좋지 않다면 터미널 창 클립보드 복사 --tus:
및
```
npx @capgo/cli@latest bundle upload --tus
```
--package-json 및 --node-modules앱이 모노레포 또는 Capgo 워크스페이스를 사용하는 경우 루트의 경로를 전달하고 루트의 경로를 package.json __CAPGO_KEEP_0__ node_modules if your app uses a non-standard structure like a monorepo or npm workspace. Pass the path to the root package.json __CAPGO_KEEP_0__ --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 docs 업데이트 디버깅

__CAPGO_KEEP_0__ Capgo support __CAPGO_KEEP_0__

__CAPGO_KEEP_0__

실시간 업데이트와 관련된 문제가 발생하는 경우 Capgo 디버그 명령어는 문제 해결을 위한 도구입니다. 사용 방법은 다음과 같습니다.

프로젝트 디렉토리에서 다음 명령어를 실행하세요:
터미널 창
```
npx @capgo/cli@latest app debug
```
디바이스 또는 에뮬레이터에서 앱을 실행하고 업데이트를 트리거하는 액션(예: 새로운 번들을 업로드 한 후 앱을 다시 열기)을 수행하세요.
디버그 명령어의 출력을 확인하세요. 업데이트 프로세스에 대한 정보를 로깅합니다.
- 앱이 업데이트 확인을 시작합니다.
- 업데이트가 발견되었는지 여부와 버전
- 업데이트 다운로드 및 설치 진행 상황
- 업데이트 프로세스 중 오류
디버그 로그를 사용하여 문제가 발생하는 위치를 식별하세요. 예를 들어:
- 업데이트가 발견되지 않으면, 배포가 성공적으로 업로드되었는지 다시 확인하고 앱이 올바른 채널을 사용하도록 구성되어 있는지 확인하세요.
- 업데이트가 다운로드되지만 설치되지 않는다면, __CAPGO_KEEP_0__을 확인하십시오. CapacitorUpdater.notifyAppReady() 앱이 완전히 닫혀서 다시 열렸습니다.
- 에러 메시지가 나타나면, 해당 에러를 Capgo 문서에서 찾아보거나 지원팀에 문의하여 도움을 받으세요.

업데이트 다운로드 및 설치 과정을 해결하기 위한 문제를 식별하는 데 특히 유용한 debug 명령어를 사용합니다. 로그가 기대되는 업데이트 버전이 발견되었지만 최종적으로 적용되지 않았다면, 다운로드 후의 단계에 집중하여 문제를 해결하세요.

로깅을 통해 네이티브 로그 디버깅

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

안드로이드 로그

안드로이드 로그를 확인하려면:

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

__CAPGO_KEEP_1__ __CAPGO_KEEP_0__ 업데이트 프로세스 중 키 이벤트를 로깅합니다. 예를 들어: adb logcat 업데이트 체크가 시작될 때 Capgo 업데이트가 발견되었을 때 및 그 버전

The Capgo SDK will log key events during the update process, such as:

업데이트 설치가 트리거될 때
__CAPGO_KEEP_1__ __CAPGO_KEEP_0__
__CAPGO_KEEP_0__
__CAPGO_KEEP_0__
Any errors that occur during the native update steps

Android에서 로그에 보이는 일반적인 문제들

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

iOS 로그

iOS 로그에 접근하려면

장치에 연결하거나 시뮬레이터를 시작하세요
Xcode를 열고 “Window > Devices and Simulators”를 클릭하세요
장치 선택 후 “Open Console”을 클릭하세요
In 콘솔 출력에서 __CAPGO_KEEP_0__ 라인 중 __CAPGO_KEEP_0__ 포함하는 라인을 찾으세요. Capgo SDK 로그를 찾기 위해

또는 터미널에서 명령어를 사용하여 __CAPGO_KEEP_0__ 로그를 필터링하세요. log stream iOS __CAPGO_KEEP_1__ __CAPGO_KEEP_1__와 유사하게, iOS에서 __CAPGO_KEEP_1__ __CAPGO_KEEP_1__는 다음 iOS-side 이벤트를 로깅합니다: Capgo 업데이트 체크 시작 및 결과

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

설치 트리거 및 결과
네이티브 업데이트 프로세스 중 오류
로그에서 식별할 수 있는 iOS 전용 문제는 다음과 같습니다:
다운로드 중 SSL 인증서 문제

iOS __CAPGO_KEEP_1__ __CAPGO_KEEP_1__는 iOS-side 이벤트를 로깅합니다.

iOS __CAPGO_KEEP_1__ __CAPGO_KEEP_1__는 iOS-side 이벤트를 로깅합니다.
앱 전송 보안이 업데이트 다운로드를 차단합니다.
업데이트 패키지에 충분한 저장 공간이 없습니다.
업데이트 패키지를 제대로 추출하거나 적용하지 못했습니다.

Electron 로그

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

터미널에서 Electron 앱을 실행하세요. (예를 들어, ) bun run electron:dev 업데이트 흐름을 재현하는 동안 콘솔 로그와 실패한 네트워크 요청을 검사하세요. bun run electron:serve패키지된 앱의 경우, OS 로그 도구를 사용하여 충돌이나 시작 실패를 확인하세요.
macOS
macOS
- macOS: Console.app 앱 이름으로 필터링하세요
- Windows: 열기 Event Viewer → Windows 로그 → Application
- Linux: 데스크톱 로그 뷰어를 사용하세요 또는 journalctl 앱 프로세스

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

플랫폼 간에 네이티브 로그는 업데이트 프로세스의 하위 수준의 시각화로 더 많은 세부 정보를 제공하며, 네이티브 구현에 대한 더 많은 세부 정보를 제공합니다. 특히 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.

업데이트가 적용되지 않습니다.

If you’ve uploaded a bundle but aren’t seeing the changes on your device:

앱에서 __CAPGO_KEEP_0__을 호출했는지 확인하세요. CapacitorUpdater.notifyAppReady() in your app code as shown in the 네트워크가 연결되어 있는지 확인하고 __CAPGO_KEEP_0__ debug 로그에서 업데이트 다운로드가 완료된 것을 확인하세요.
Check that your device is connected to the internet and the Capgo debug logs show the update was downloaded
native 로그에서 업데이트 적용에 문제가 있는지 확인하세요.
deploying live updates

deploying live updates deploying live updates 업데이트 프로세스에 대한 자세한 내용은 이 안내서를 참조하십시오. 여전히 막혔으면, 업데이트 명령어와 네이티브 로그를 사용하여 더 많은 정보를 얻으십시오. npx @capgo/cli@latest app debug 업데이트 명령어와 네이티브 로그를 사용하여 더 많은 정보를 얻으십시오.

업데이트 실패 코드

백엔드 에러가 표시되는 경우, 예를 들어, 또는, 사용자 지정 안내서를 참조하십시오. disable_auto_update_to_major, semver_error업데이트 문제 cannot_update_via_private_channel업데이트 문제에 대한 설명은 이 안내서를 참조하십시오.

업데이트 문제에 대한 설명은 이 안내서를 참조하십시오.

It explains what each common code means, why it happens, and how to fix it.

SDK Installation

If you’re having trouble installing the Capgo SDK, make sure:

앱은 Capacitor (4.0 이상)의 지원 버전을 사용하고 있습니다.
CI/CD 통합 CI/CD 통합 CI/CD pipeline에서 SDK 업로드를 트리거하는 문제에 대한

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

For issues with triggering Capgo uploads from your CI/CD pipeline:

Double check your Capgo authentication token is set up correctly
CI/CD 통합
CI/CD 통합

CI/CD 통합 CI/CD 통합 docs 에서 더 많은 문제 해결 팁을 찾을 수 있습니다. 또한 CI/CD-트리거된 업데이트 여부를 확인하기 위해 npx @capgo/cli@latest app debug 명령어를 사용할 수 있습니다.

Keep going from Troubleshooting

Capgo를 사용하는 경우 Troubleshooting 를 사용하여 저장소 및 파일 처리를 계획하고, @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-data-storage-sqlite에 연결하세요. Capgo를 사용하는 경우 @capgo/capacitor-data-storage-sqlite의 구현 세부 정보를 @capgo/capacitor-data-storage-sqlite에서 참조하세요. Capgo를 사용하여 @capgo/capacitor-data-storage-sqlite를 사용하여 native 기능을 사용하는 경우 @capgo/capacitor-data-storage-sqlite를 사용하세요. @capgo/capacitor-file을 사용하세요. @capgo/capacitor-file을 사용하세요. @capgo/capacitor-파일의 구현 세부 정보에 대해 @capgo/capacitor-파일을 사용하여 @capgo/capacitor-파일을 사용하여 원본 기능을 구현하는 데 사용되는 @capgo/capacitor-업로더 @capgo/capacitor-업로더의 구현 세부 정보에 대해