본문으로 건너뛰기
Capgo - Capacitor Live Updates Capgo

문제 해결

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

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

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

업로드 실패

업로드 실패

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

  • 앱 ID가 __CAPGO_KEEP_0__ 대시보드에 등록된 앱과 일치하는지 확인하세요. capacitor.config.ts Capgo 프로젝트의 루트 디렉토리에서 업로드 명령을 실행하는지 확인하세요.
  • Capacitor 프로젝트의 루트에서 업로드 명령을 실행하고 있습니다.
  • 업로드 실패

고급 업로드 옵션

고급 업로드 옵션 섹션

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

  • --tus: Uses the tus 재시도 업로드 프로토콜 대형 패키지 또는 느린 네트워크 연결에서 더 신뢰할 수 있는 업로드를 위해 --tus:

    10MB 이상의 패키지를 업로드하거나 네트워크 연결이 좋지 않다면
    npx @capgo/cli@latest bundle upload --tus

  • --package-json 클립보드 복사 --node-modules: Capgo의 루트 위치를 알려줍니다. package.json 클립보드 복사 node_modules : npm이 __CAPGO_KEEP_1__의 루트 디렉토리를 찾는 위치를 알려줍니다. package.json 그리고 --node_modules 경로:

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

    Capgo은 앱의 종속성을 올바르게 패키징하기 위해 이 정보가 필요합니다.

필요한 경우 다른 옵션과 함께 이 플래그를 결합할 수 있습니다. --channel 필요한 경우 다른 옵션과 함께 이 플래그를 결합할 수 있습니다. Capgo CLI의 자세한 설명을 보려면 __CAPGO_KEEP_0__의 자세한 설명을 보려면

__CAPGO_KEEP_0__의 자세한 설명을 보려면 Capgo의 자세한 설명을 보려면 __CAPGO_KEEP_0__의 자세한 설명을 보려면

업데이트 디버깅

업데이트 디버깅

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

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

    터미널 창
    npx @capgo/cli@latest app debug

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

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

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

  4. 이 문제를 해결하기 위해 디버그 로그를 사용하세요. 예를 들어:

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

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

자연 로그 디버깅

자연 로그 디버깅 섹션

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

Android 로그

Android 로그 섹션

Android 로그를 열기:

  1. 장치에 연결하거나 에뮬레이터를 시작하세요.
  2. 안드로이드 스튜디오를 열고 "보기 > 도구 창 > 로그캣"을 선택하세요.
  3. 로그캣 창에서 로그를 필터링하여 앱 프로세스만 선택하세요.
  4. 다음과 같은 줄을 찾으세요. Capgo SDK 로그를 찾으세요.

대안으로 다음 명령어를 사용하고 __CAPGO_KEEP_0__를 grep하여 로그를 필터링하세요. adb logcat __CAPGO_KEEP_0__ __CAPGO_KEEP_1__는 업데이트 프로세스 중 키 이벤트를 로깅합니다. Capgo 업데이트 체크가 시작될 때

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

  • 업데이트 다운로드가 시작되고 완료되었는지
  • __CAPGO_KEEP_0__ __CAPGO_KEEP_1__
  • __CAPGO_KEEP_0__
  • 업데이트 설치가 트리거 될 때
  • 네이티브 업데이트 단계 중 발생하는 모든 오류

로그에서 보이는 일반적인 안드로이드 관련 문제는 다음과 같습니다:

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

iOS 로그

iOS 로그 섹션

iOS 로그에 접근하려면:

  1. 장치에 연결하거나 시뮬레이터를 시작하세요
  2. Xcode를 열고 "Window > Devices and Simulators"로 이동하세요
  3. __CAPGO_KEEP_0__
  4. 콘솔을 열기 위해 기기를 선택하고 클릭하세요. Capgo 콘솔 출력에서 SDK 로그를 찾으세요.

콘솔을 열기 위해 터미널에서 __CAPGO_KEEP_0__ 명령어를 사용하세요. log stream 로그를 필터링하기 위해 터미널에서 __CAPGO_KEEP_0__ 명령어를 사용하세요. Capgo __CAPGO_KEEP_0__ __CAPGO_KEEP_1__

iOS에서 Capgo SDK은 iOS 측의 주요 이벤트를 로그합니다.

  • 다운로드 시작, 진행, 완료
  • 설치 트리거 및 결과
  • 네이티브 업데이트 프로세스 중 오류
  • iOS 관련 로그에서 식별할 수 있는 문제

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

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

Electron 로그

Electron 로그

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

  1. 터미널에서 Electron 앱을 실행하여 일반 런치 명령어를 사용하십시오 (예를 들어) bun run electron:dev 또는 bun run electron:serveElectron 앱을 터미널에서 실행하여 일반 런치 명령어를 사용하십시오 (예를 들어)
  2. 그리고 터미널 출력을 확인하십시오.
  3. 개발자 도구를 렌더러 창에서 열고 (View → Toggle Developer Tools) 콘솔 로그와 업데이트 흐름 중 실패한 네트워크 요청을 확인하십시오.
    • macOS: 열기 Console.app 및 앱 이름으로 필터링
    • Windows: 열기 이벤트 뷰어 → Windows 로그 → Application
    • LinuxLinux journalctl : 데스크톱 로그 뷰어를 사용하거나

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

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

어떤 live update 문제를 해결하려고 할 때, Capgo 디버그 로그와 네이티브 로그를 모두 캡처하는 것이 좋습니다. 두 로그를 함께 사용하면 문제를 식별하고 해결하는 데 가장 좋은 기회가 될 것입니다.

업데이트가 적용되지 않음

업데이트가 적용되지 않음

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

  • 앱에서 __CAPGO_KEEP_0__을 호출하십시오. 다음 예제를 참조하십시오. CapacitorUpdater.notifyAppReady() app에서 code처럼 표시된 곳에 quickstart
  • 네트워크 연결이 잘 되는지 확인하고 Capgo 디버그 로그에서 업데이트 다운로드가 완료된 것을 확인하세요.
  • 네이티브 로그에서 업데이트를 적용하는 문제가 있는지 확인하십시오.
  • 업데이트를 적용하는 문제를 해결하려면

참조 배포 중 Live 업데이트 업데이트 프로세스에 대한 자세한 내용은 이 npx @capgo/cli@latest app debug 명령어와 네이티브 로그를 사용하여 더 많은 정보를 얻으려면 여기를 클릭하세요.

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

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

로그에 백엔드 오류가 나타나면 disable_auto_update_to_major, semver_error또는 cannot_update_via_private_channel를 사용하세요.

이 문서는 각 일반적인 code의 의미, 발생 이유 및 해결 방법을 설명합니다.

SDK 설치

제목: SDK 설치

설치 중 문제가 발생하는 경우 Capgo SDK를 설치했는지 확인하세요.

  • Capacitor의 지원 버전을 사용 중인지 확인하세요 (4.0 이상)
  • __CAPGO_KEEP_0__를 설치한 후 앱을同步한 후에 quickstart 앱을 설치한 후 SDK를同步하는 단계를 순서대로 수행하세요.

CI/CD 통합

CI/CD pipeline에서 __CAPGO_KEEP_0__ 업로드 문제가 발생하는 경우:

Capgo 인증 토큰이 올바르게 설정되어 있는지 확인하세요.

  • Capgo 인증 토큰이 올바르게 설정되어 있는지 다시 확인하세요.
  • 업로드 명령이 올바른 채널 이름을 사용하는지 확인하세요.
  • CI/CD 통합

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

문제 해결에서 계속

문제 해결에서 계속

문제 해결 Troubleshooting @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-data-storage-sqlite Capgo capgo capacitor-data-storage-sqlite @capgo/capacitor-data-storage-sqlite @capgo/capacitor-data-storage-sqlite Using @capgo/capacitor-data-storage-sqlite @capgo/capacitor-파일 for the @capgo/capacitor-file implementation detail @capgo/capacitor-파일 사용 native 기능을 사용하는 @capgo/capacitor-파일에 대해 @capgo/capacitor 업로더 @capgo/capacitor 업로드 구현 세부 사항에 대한 정보.