내용으로 건너뛰기

알려진 문제

GitHub

아이오닉 리로드

아이오닉 리로드
  • 개발할 때, CLI에서 아이오닉 리로드 기능을 사용하면 플러그인을 덮어써서 업데이트를 보지 못합니다.

퀘스러 리로드

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

업데이트 실패

업데이트 실패
  • 대부분의 사용자가 마지막 버전을 받지 못하는 경우가 많습니다. 일반적으로 20MB 이상의 큰 업데이트가 푸시될 때 발생합니다.
    앱을 열어 두고 다운로드가 완료될 때까지 기다리던 과거의 사용자들은 이제 배경 다운로드를 사용하지만 여전히 몇 초 동안 제한됩니다.

안드로이드

안드로이드

다운로드할 수 없음

다운로드할 수 없음

인도에서 장치에 문제가 발생한 경우, 사용자와 통화를 하여 다른 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으로 압축하지 않은 경우에만 압축한 CLI 명령어를 사용하세요. npx @capgo/cli zip BUNDLE_FOLDER.

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

Clearfix 문제

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

이 문제를 해결하려면 android/app/src/main/AndroidManifest.xml 그것 <application> 키 :

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

IOS

IOS

개인 정보 매니페스트

개인 정보 매니페스트

개인 정보 매니페스트에 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>

개인 정보 매니페스트를 선언하는 것을 추천합니다. CA92.1 업데이트를 위해 액세스하는 UserDefaults API.

네트워크 권한

네트워크 권한

로컬 서버를 사용하여 테스트 업데이트를 할 때 앱은 네트워크 권한을 요청합니다. 이는 원래의 동작이며, remote 서버를 사용할 때는 그렇지 않습니다.

두 개의 OS

두 개의 OS

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

bundle 목록을 만들고 에러 통계를 확인하여 업데이트가 실패하는지 확인하는 것이 하나의 대안입니다.

이 문제를 향후 더 나은 방식으로 처리하는 것이 필요합니다. 그러나 자동 모드는 업데이트를 수행하는 권장 방법이기 때문에 우선순위는 낮습니다.

PR은 업데이트를 개선하는 데 도움이 될 수 있습니다.

CLI

CLI

CLI

Check if appIdappName __CAPGO_KEEP_0__.config.ts capacitor 설정

공식 문서의 지침을 따르세요:

알려진 문제에서 계속

알려진 문제에서 계속

이러한 문제가 발생하는 경우 알려진 문제 자연 플러그인 작업을 계획하고 있습니다. 자연 플러그인 작업을 위해 @capgo/capacitor-업데이터 자연 플러그인 작업을 위해 @capgo/capacitor-업데이터 Capgo 플러그인 디렉토리 Capgo 플러그인 디렉토리 Capacitor Plugins by Capgo for the implementation detail in Capacitor Plugins by Capgo, __CAPGO_KEEP_0__ 플러그인 __CAPGO_KEEP_0__ 플러그인 플러그인 추가 또는 업데이트 Ionic Enterprise 플러그인 대체 제품 워크플로우에 대한 것입니다.