문제 해결

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

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

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

전문가 지원 받기

업로드 실패

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

• __CAPGO_KEEP_0__ 대시보드에 등록된 앱 ID가 capacitor.config.ts Capgo 프로젝트의 루트 디렉토리에서 업로드 명령어를 실행하고 있는지 확인하세요.
• Capacitor
• 웹 자산은 빌드되고 최신 상태입니다.

고급 업로드 옵션

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

• --tus: __CAPGO_KEEP_0__을 사용하여 tus 재시도 업로드 프로토콜 대형 배달 또는 네트워크 연결이 좋지 않은 경우 더 신뢰할 수 있는 업로드를 위해 --tus:

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

• --package-json 클립보드 복사 --node-modules: Tells Capgo where to find your root package.json : __CAPGO_KEEP_0__에서 루트를 찾는 위치를 알려줍니다. 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.

필요한 대로. --channel __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ 문서를 참조하여 Capgo CLI docs 업로드 문제가 여전히 발생하는 경우 __CAPGO_KEEP_0__ 지원팀에 문의하세요.

__CAPGO_KEEP_0__ Capgo support 추가 도움을 받으려면.

디버깅 업데이트

실시간 업데이트와 관련된 문제가 발생하는 경우 Capgo 디버깅 명령어는 문제 해결을 위한 유용한 도구입니다. 이를 사용하려면:

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

   npx @capgo/cli@latest app debug

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

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

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

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

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

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

네이티브 로그 디버깅

업데이트 프로세스의 네이티브 측면과 관련된 문제를 해결하는 데 도움이 될 수 있는 네이티브 로그는 Capgo 디버그 명령어와 함께 Android, iOS, Electron에서 제공됩니다.

안드로이드 로그

Android 로그에 접근하려면:

1. 장치에 연결하거나 에뮬레이터를 시작하세요.
2. Android Studio를 열고 "View > Tool Windows > Logcat"을 선택하세요.
3. Logcat 창에서 로그를 필터링하여 앱 프로세스만 표시하려면 상단의 드롭다운에서 선택하세요.
4. 다음과 같은 줄을 찾으세요. Capgo SDK 로그를 찾으려면

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

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

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

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

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

iOS 로그

iOS 로그에 접근하려면:

1. 디바이스를 연결하거나 시뮬레이터를 시작하세요
2. Xcode를 열고 “Window > Devices and Simulators”로 이동하세요.
3. 디바이스를 선택하고 “Open Console”을 클릭하세요.
4. 콘솔 출력에서 __CAPGO_KEEP_0__ 로그를 포함하는 줄을 찾으세요. Capgo SDK 로그를 찾기 위해 사용할 수 있습니다.

터미널에서 __CAPGO_KEEP_0__ 명령어를 사용하고 __CAPGO_KEEP_1__ 로그를 grep하여 필터링하세요. log stream __CAPGO_KEEP_0__ __CAPGO_KEEP_1__는 iOS 측의 중요한 이벤트를 로깅합니다: Capgo 업데이트 체크 시작 및 결과

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

• 네이티브 업데이트 프로세스 중 오류
• 네이티브 업데이트 프로세스 중 오류
• 업데이트 체크 시작 및 결과
• 다운로드 시작, 진행, 완료

iOS에서 로그에서 식별할 수 있는 특정 문제를 포함합니다:

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

Electron 로그

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

1. 터미널에서 Electron 앱을 실행하여 일반적인 런치 명령어를 사용하십시오 (예를 들어) bun run electron:dev 또는 bun run electron:serveElectron 앱을 터미널에서 실행하여 일반적인 런치 명령어를 사용하십시오 (예를 들어)
2. 터미널 출력을 감시하여 시작, 업데이트 확인, 네트워크 오류를 감시하십시오.
3. 패키지 앱의 경우 OS 로그 도구를 확인하여 충돌이나 시작 오류를 확인하세요:
   • macOS: 열어 Console.app 및 앱 이름으로 필터링하세요
   • Windows: 열어 Event Viewer → Windows 로그 → Application
   • Linux: 데스크톱 로그 뷰어를 사용하거나 journalctl 앱 프로세스에 대한 로그를 확인하세요

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

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

트러블 슈팅하는 동안 라이브 업데이트 문제가 어려울 때는 Capgo 디버그 로그와 네이티브 로그를 모두 캡처하여 문제가 발생하는 전체 그림을 얻는 것이 좋습니다. 두 로그를 함께 사용하면 문제를 식별하고 해결하는 데 가장 좋은 기회가 될 것입니다.

업데이트가 적용되지 않음

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

• 앱에서 __CAPGO_KEEP_0__을 호출하십시오. CapacitorUpdater.notifyAppReady() in your app code as shown in the 장치가 인터넷에 연결되어 있고 __CAPGO_KEEP_0__ 디버그 로그에서 업데이트가 다운로드 된 것을 확인하십시오.
• Check that your device is connected to the internet and the Capgo debug logs show the update was downloaded
• 네이티브 로그에서 업데이트를 적용하는 문제가 있는지 확인하십시오.
• 업데이트가 적용되지 않음

업데이트 과정에 대한 자세한 내용은 실시간 업데이트 배포 가이드를 참조하십시오. 업데이트 문제가 해결되지 않으면 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의 의미, 발생 이유, 그리고 해결 방법을 설명합니다.

Capgo SDK 설치 문제가 있는 경우

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

CI/CD 통합

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

• Double check your Capgo authentication token is set up correctly
• 올바른 채널 이름을 사용하는지 확인하세요
• __CAPGO_KEEP_0__

See the CI/CD 통합 문서 더 많은 문제 해결 팁을 찾으려면 npx @capgo/cli@latest app debug CI/CD 통합 문서를 참조하십시오.

명령어를 사용하여

문제 해결 Section titled “문제 해결” 지원을 사용하여 @capgo/capacitor-data-storage-sqlite for the implementation detail in @capgo/capacitor-data-storage-sqlite, storage 및 파일 처리를 계획하고, @capgo/capacitor-data-storage-sqlite와 연결합니다. @capgo/capacitor-data-storage-sqlite의 구현 세부 사항을 참조하십시오. @capgo/capacitor-data-storage-sqlite 사용하기 for the native capability in Using @capgo/capacitor-data-storage-sqlite, @capgo/capacitor-file for the implementation detail in @capgo/capacitor-file, Using @capgo/capacitor-file for the native capability in Using @capgo/capacitor-file, and @capgo/capacitor-uploader for the implementation detail in @capgo/capacitor-uploader.