Troubleshooting

Capgo를 사용하는 동안 발생할 수 있는 일반적인 문제와 해결 방법입니다.

🚀 전문적인 도움을 원하세요?

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

전문적인 지원을 받으세요

업로드 실패

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

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

고급 업로드 옵션

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

• --tus: __CAPGO_KEEP_0__를 사용하는 tus 재시도 업로드 프로토콜을 사용하여 대형 배ंडल 또는 느린 네트워크 연결에서 더 신뢰할 수 있는 업로드를 위해. 만약 배ंडल이 10MB를 초과하거나 네트워크 연결이 좋지 않다면 --tus:

  npx @capgo/cli@latest bundle upload --tus

• --package-json 와 --node-modules: Capgo의 루트 위치를 알려줍니다. package.json 루트 node_modules 만약 앱이 모노레포 또는 npm 워크스페이스를 사용한다면 루트 경로와 package.json 경로: --node_modules __CAPGO_KEEP_0__

  npx @capgo/cli@latest bundle upload --package-json=path/to/package.json --node_modules=path/to/node_modules

  Capgo __CAPGO_KEEP_1__

__CAPGO_KEEP_0__ --channel __CAPGO_KEEP_0__ Capgo CLI docs __CAPGO_KEEP_0__

__CAPGO_KEEP_0__ Capgo Debugging Updates

__CAPGO_KEEP_0__

Capgo 문제 해결을 위해 debug 명령어는 유용한 도구입니다. 사용 방법은 다음과 같습니다.

1. 프로젝트 디렉토리에서 다음 명령어를 실행하세요.

   npx @capgo/cli@latest app debug

2. 앱을 기기나 에뮬레이터에서 실행하고 업데이트를 트리거하는 액션(예: 새로운 번들을 업로드 한 후 앱을 다시 열기)을 수행하세요.

3. debug 명령어의 출력을 관찰하세요. 업데이트 프로세스에 대한 정보를 로깅합니다.

   • 앱이 업데이트 확인을 시작합니다.
   • 업데이트가 발견되었는지 여부와 버전
   • 업데이트 다운로드 및 설치 진행 상황
   • 업데이트 프로세스 중 오류가 발생하는 경우

4. debug 로그를 사용하여 문제가 발생하는 위치를 식별하세요. 예를 들어:

   • 업데이트가 발견되지 않으면, 번들이 성공적으로 업로드되었는지 확인하고 앱이 올바른 채널을 사용하는지 확인하세요.
   • 업데이트가 다운로드되지만 설치되지 않는다면, __CAPGO_KEEP_0__를 호출했는지 확인하고 앱이 완전히 닫혔는지 확인한 후 다시 열어보세요. CapacitorUpdater.notifyAppReady() 앱이 완전히 닫혔는지 확인한 후 다시 열어보세요.
   • 에러 메시지를 보게 된다면, Capgo 문서에서 해당 에러를 검색하거나 지원팀에 문의하세요.

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

디버그 명령어와 함께 Native 로그

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 로그

Android 로그에 접근하려면

1. 디바이스를 연결하거나 에뮬레이터를 시작하세요.
2. Android Studio를 열고 ‘보기 > 도구 창 > 로그캣’을 선택하세요.
3. In Logcat 창에서 로그를 필터링하여 앱의 프로세스만 선택하세요.
4. 다음과 같은 라인을 찾으세요. Capgo SDK 로그를 찾으세요.

대안으로, 다음 명령어를 사용하여 grep로 로그를 필터링하세요. adb logcat 명령어를 사용하여 grep로 로그를 필터링하세요. Capgo __CAPGO_KEEP_0__ __CAPGO_KEEP_1__는 업데이트 프로세스 중 키 이벤트를 로깅합니다. 예를 들어:

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__
• __CAPGO_KEEP_0__
• __CAPGO_KEEP_0__

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__

1. __CAPGO_KEEP_0__
2. __CAPGO_KEEP_0__
3. __CAPGO_KEEP_0__
4. __CAPGO_KEEP_0__ Capgo SDK 로그를 찾기 위해

You can also use the log stream 명령어를 터미널에서 실행하고 grep으로 Capgo 로그를 필터링하기 위해

iOS와 마찬가지로, Capgo SDK는 iOS 측의 중요한 이벤트를 로깅합니다:

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

로그에서 식별할 수 있는 iOS 전용 문제로는

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

Electron 로그

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

1. 터미널에서 Electron 앱을 실행하고(예를 들어, bun run electron:dev 업데이트 흐름을 재현하는 동안 터미널 출력을 감시하여 시작, 업데이트 확인 및 네트워크 오류를 확인하십시오. bun run electron:serve렌더러 창에서 개발자 도구를 열고(보기 → 개발자 도구 토글) 콘솔 로그 및 실패한 네트워크 요청을 검사하십시오.
2. 패키지 앱의 경우, OS 로그 도구를 사용하여 충돌이나 시작 오류를 확인하십시오.
3. macOS
   • : open__CAPGO_KEEP_0__ Console.app 앱 이름으로 필터링하고
   • Windows: 열기 이벤트 뷰어 → Windows 로그 → 애플리케이션
   • 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.

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

업데이트 패키지를 업로드했지만 장치에서 변경 사항을 보지 못하는 경우:

• 업데이트 패키지를 적용하려면 CapacitorUpdater.notifyAppReady() 앱에서 code을 호출해야 합니다. quickstart에서 설명한 것과 같이 quickstart
• 인터넷에 연결된 장치가 있는지 확인하고 Capgo debug 로그에서 업데이트 다운로드가 완료된 것을 확인합니다.
• 앱을 완전히 종료하고 다시 열어보세요. 업데이트 패키지는 새로 고침 시에만 적용됩니다.
• native 로그에서 오류를 찾으세요. 업데이트 패키지를 적용하는 문제가 있는지 확인하세요.

deploying live updates 업데이트 프로세스에 대한 자세한 내용은 guide를 참조하세요. 여전히 문제가 있는 경우 사용하세요. deploying live updates guide npx @capgo/cli@latest app debug 명령어와 네이티브 로그를 더 많은 시각성을 얻기 위해 가져오십시오.

일반적인 업데이트 실패 코드

로그가 백엔드 오류를 보여주고 있는 경우, 예를 들어 "__CAPGO_KEEP_0__" 또는 "__CAPGO_KEEP_0__" 오류가 발생한 경우, 다음 전용 안내서를 사용하십시오: disable_auto_update_to_major, semver_error일반적인 업데이트 문제 cannot_update_via_private_channel각 일반적인 "__CAPGO_KEEP_0__"가 무엇을 의미하는지, 왜 발생하는지, 그리고 어떻게 고칠 수 있는지 설명합니다.

• "__CAPGO_KEEP_0__" 설치

제목 "code" 설치

만약 "SDK" "__CAPGO_KEEP_1__" 설치에 어려움을 겪는다면, 다음을 확인하십시오:

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

• If your logs show backend errors such as Capacitor or Capacitor , use the dedicated guide: is translated to "로그가 백엔드 오류를 보여주고 있는 경우, 예를 들어 "Capacitor" 또는 "Capacitor" 오류가 발생한 경우, 다음 전용 안내서를 사용하십시오:"
• You’ve followed the quickstart steps in order, including syncing your app after installing the SDK

CI/CD 통합

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

• CI/CD pipeline에서 Capgo 업로드를 트리거하는 문제가 있는 경우:
• Double check your __CAPGO_KEEP_0__ 인증 토큰이 올바르게 설정되어 있는지 확인하세요
• 웹 자산이 빌드된 후 업로드 명령어를 실행하는지 확인하세요

업로드 명령어가 올바른 채널 이름을 사용하는지 확인하세요 See the CI/CD 통합 문서 npx @capgo/cli@latest app debug CI/CD 트리거된 업데이트가 앱에 도달하는지 확인하는 명령어입니다.

Troubleshooting에서 계속

__CAPGO_KEEP_0__에서 __CAPGO_KEEP_1__ 데이터 저장소 SQLite와 함께 연결하는 경우 __CAPGO_KEEP_0__에서 __CAPGO_KEEP_1__ 데이터 저장소 SQLite의 구현 세부 정보 __CAPGO_KEEP_0__에서 __CAPGO_KEEP_1__ 데이터 저장소 SQLite 사용 capgo에서 capacitor 데이터 저장소 SQLite의 네이티브 기능 capgo에서 capacitor 파일과 함께 연결하는 경우 capgo에서 capacitor 파일의 구현 세부 정보 capgo에서 capacitor 파일 사용 capgo에서 capacitor 파일의 네이티브 기능 capgo에서 capacitor @capgo/capacitor-파일을 사용하여 native capability을 위한 @capgo/capacitor-파일을 사용하여 @capgo/capacitor-업로더 @capgo/capacitor-업로더의 implementation detail을 위한