알려진 문제

GitHub

이 플러그인의 설치 단계와 전체 마크다운 가이드가 포함된 설정 프롬프트를 복사하세요.

Ionic live reload

개발 시 CLI의 Ionic live reload 기능을 사용하면 플러그인이 덮어씌워지므로 업데이트 내용을 확인할 수 없습니다.

Quasar 라이브 리로드

내부적으로 ionic과 동일한 시스템을 사용하므로 업데이트가 반영되지 않을 수 있습니다.

업데이트 실패

대용량 업데이트(> 20mb)를 푸시할 경우, 많은 사용자가 최신 버전을 받지 못하는 현상이 주로 발생합니다.
이전에는 다운로드가 완료될 때까지 앱을 열어두어야 했으나, 현재는 백그라운드 다운로드를 지원합니다. 다만 여전히 몇 초 내외로 제한됩니다.

Android

다운로드 불가

인도 지역 기기에서 일부 이슈를 확인했습니다. 사용자 지원을 통해 다른 DNS 서버를 사용하도록 안내하여 문제를 해결했습니다.

문제가 발생한다면 Cloudflare 또는 Google DNS와 같은 다른 DNS 서버를 사용해 보세요.

Cloudflare: 1.1.1.1 및 1.0.0.1

Google DNS: 8.8.8.8 및 8.8.4.4 또는 dns.google

Android에서 기본 DNS 서버를 설정하는 방법은 무엇인가요?

자체 호스팅

Self-hosted 업데이트를 푸시할 때, Android 앱의 보안 정책상 “HTTP” 엔드포인트를 사용할 수 없음에 유의하세요. 그래도 사용해야 한다면 다음 가이드를 따르세요:

Android (9) Pie에서 HTTP 및 HTTPS 모든 네트워크 연결 유형을 허용하는 방법은 무엇인가요?

Unzip

Unzip 문제: DEFLATED 항목에 EXT 디스크립터가 포함될 수 있음

CLI 이외의 도구로 번들을 압축했다면, 포맷이나 zip 파일이 올바르지 않을 수 있습니다. CLI 명령어를 사용해 주세요. npx @capgo/cli zip BUNDLE_FOLDER.

다음은 알려진 Java 이슈입니다:

압축 해제 이슈: DEFLATED 항목에 EXT 디스크립터가 포함될 수 있음

Clearfix 이슈

usesCleartextTraffic 관련 문제가 발생한다면, 이는 플러그인이 SonarCloud에서 권장하는 모범 사례를 따르기 때문입니다. 90%의 경우에는 문제없이 작동하지만, 일부 플러그인에서 이슈가 발생할 수 있습니다.

이를 해결하려면 다음을 추가하세요: android/app/src/main/AndroidManifest.xml 플러그인의 <application> 키:

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

iOS

개인정보 보호 매니페스트(Privacy manifest)

다음을 추가하세요 NSPrivacyAccessedAPICategoryUserDefaults 사용자의 Privacy Manifest (보통 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.

네트워크 권한

업데이트 테스트를 위해 로컬 서버를 사용하면 앱에서 네트워크 권한을 요청할 수 있습니다. 이는 정상적인 동작이며, 원격 서버를 사용할 때는 발생하지 않습니다.

양쪽 OS

manual mode로 업데이트할 때 일부 이벤트는 잡기 어렵습니다. 예를 들어 update fail은 JS code 리로드 직전에 트리거되어 감지할 수 없습니다.

대안은 번들을 나열하고 에러 통계를 확인해 업데이트 실패 여부를 파악하는 것입니다.

향후 더 나은 처리 방법을 찾아야 하지만, auto mode가 권장 업데이트 방식이라 우선순위는 아닙니다.

이를 개선하는 데 도움이 될 PR을 환영합니다.

CLI

CLI에서 무엇을 하든 문제가 있다면,

다음을 확인하세요: appId 및 appName 의(에) 포함되어 있습니다. capacitor.config.ts

공식 문서를 참고하세요:

Capacitor 설정

Known issues에서 계속하기

사용 중이라면 알려진 문제 네이티브 플러그인 작업을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/capacitor-updater 사용하기 네이티브 기능의 경우 @capgo/capacitor-updater 사용하기에서, Capgo 플러그인 디렉토리 Capgo Plugin Directory의 제품 워크플로우에 맞춰, Capgo의 Capacitor 플러그인 Capgo의 Capacitor 플러그인 구현 상세 내용에 대해서는, 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트 구현 상세 내용에 대해서는, Ionic Enterprise 플러그인 대안 Ionic Enterprise 플러그인 대안의 제품 워크플로우에 대해서는.