메뉴로 바로가기

알려진 문제점

GitHub

아이온 라이브 리로드

아이온 라이브 리로드
  • 개발할 때, CLI에서 아이온 라이브 리로드 기능을 사용하면 플러그인을 오버라이드 할 수 있으므로 업데이트를 보지 못합니다.

퀘스트 라이브 리로드

퀘스트 라이브 리로드
  • 아이온과 동일한 시스템을 사용하므로 업데이트를 보지 못합니다.

업데이트가 실패합니다

업데이트 실패
  • 대형 업데이트가 (> 20MB) 푸시될 때 일반적으로 발생합니다. 사용자 중 많은 수가 마지막 버전을 받지 못합니다.
    앱을 열어두고 다운로드가 완료될 때까지 기다리던 과거와는 달리, 우리는 배경 다운로드를 사용하고 있습니다. 그러나 여전히 몇 초만 지속됩니다.

Android

Android

다운로드가 실패합니다

다운로드 실패

인도에서 장비에 문제가 발생한 경우, 사용자와 통화를 하여 다른 DNS 서버를 사용하도록 시도했습니다. 문제가 해결되었습니다.

이 문제가 발생하는 경우, 다른 DNS 서버를 사용하십시오. 예를 들어 Cloudflare 또는 Google DNS를 사용하십시오.

Cloudflare: 1.1.1.1 및 1.0.0.1

Google DNS: 8.8.8.8 및 8.8.4.4 또는 dns.google

자체 호스팅

자체 호스팅

자체 호스팅 업데이트를 푸시할 때는 Android 앱의 보안 정책에 맞지 않는 HTTP 엔드포인트를 사용할 수 없습니다. HTTP 엔드포인트를 사용하고 싶다면 이 안내서를 따르세요:

압축 해제

압축 해제

압축 해제 문제: DEFLATED 항목은 EXT 디스크립터를 가질 수 있습니다

압축 파일을 CLI 이외의 명령어로 압축한 경우, 압축 형식이 잘못되었거나 zip 형식이 잘못되었을 수 있습니다. CLI 명령어를 사용하세요 npx @capgo/cli zip BUNDLE_FOLDER.

이것은 자바의 알려진 문제입니다:

Clearfix 문제

Clearfix 문제
  • usesCleartextTraffic과 관련된 문제가 있으시다면, 그것은 sonar cloud에서 권장하는 좋은 관행을 따르는 플러그인 때문입니다. 대부분의 경우 문제가 발생하지 않지만, 일부 플러그인과 충돌할 수 있습니다.

해결 방법은 android/app/src/main/AndroidManifest.xml in <application> key :

tools:replace="android:usesCleartextTraffic"
xmlns:tools="http://schemas.android.com/tools"

IOS

IOS

개인 정보 보호 매니페스트

개인 정보 보호 매니페스트

Add the NSPrivacyAccessedAPICategoryUserDefaults 사전 항목을 개인 정보 선언서 (일반적으로 ios/App/PrivacyInfo.xcprivacy):

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>NSPrivacyAccessedAPITypes</key>
<array>
<!-- Add this dict entry to the array if the file already exists. -->
<dict>
<key>NSPrivacyAccessedAPIType</key>
<string>NSPrivacyAccessedAPICategoryUserDefaults</string>
<key>NSPrivacyAccessedAPITypeReasons</key>
<array>
<string>CA92.1</string>
</array>
</dict>
</array>
</dict>
</plist>

개발자에게 권장하는 방법은 __CAPGO_KEEP_0__을 선언하는 것입니다. CA92.1 네트워크 접근 권한 UserDefaults API

네트워크 권한

네트워크 권한 섹션

로컬 서버를 사용하여 테스트 업데이트를 할 때 앱은 네트워크 권한을 요청할 것입니다. 이는 원격 서버를 사용할 때의 경우가 아닙니다.

수동 모드 업데이트를 할 때, 일부 이벤트는 쉽게 잡을 수 없습니다. 예를 들어, 업데이트가 실패할 때 JS code이 다시 로드되기 직전에 트리거가 발생하기 때문에 이를 잡을 수 없습니다.

One alternative is to list the bundles and check error stats to know if the update fails.

We need to find a better way to handle this in the future, but it’s not a priority, since auto mode is the recommended way to do update.

PRs are welcome to help us improve this.

CLI

CLI

if your CLI has troubles doing anything,

Check if appId and appName are present in your __CAPGO_KEEP_0__.config.ts. capacitor

official 문서의 안내를 따라하세요:

알려진 문제점에서 계속 진행하세요.

알려진 문제점에서 계속 진행하세요

native 플러그인 작업을 계획하고 있으시다면 native 플러그인 작업을 계획하고 있으시다면 native 기능을 위해 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-업데이터를 사용하세요. native 기능을 위해 @capgo/capacitor-업데이터를 사용하세요. for the native capability in Using @capgo/capacitor-updater, Capgo 플러그인 디렉토리 __CAPGO_KEEP_1__에서 Capgo 플러그인 Capgo에서 Capacitor 플러그인 Capacitor 플러그인에 대한 구현 세부 정보는 Capgo에서 확인할 수 있습니다. 플러그인 추가 또는 업데이트 __CAPGO_KEEP_0__ 플러그인에 대한 구현 세부 정보는 플러그인 추가 또는 업데이트, 및 Ionic Enterprise 플러그인 대체 __CAPGO_KEEP_0__ 제품 워크플로우는 Ionic Enterprise 플러그인 대체입니다.