알려진 문제
이 플러그인의 설치 단계와 전체 마크다운 가이드가 포함된 설정 프롬프트를 복사하세요.
Ionic 라이브 리로드
“Ionic live reload” 섹션- 개발 중 CLI에서 Ionic live reload 기능을 사용하면 이 기능이 플러그인을 덮어쓰므로 업데이트가 절대 표시되지 않습니다.
Quasar 라이브 리로드
“Quasar live reload” 섹션- 내부적으로 Ionic과 동일한 시스템을 사용하므로 업데이트가 표시되지 않습니다.
업데이트 실패
“Updates fail” 섹션- 대용량 업데이트(20MB 초과)를 배포할 때 발생하며, 상당수의 사용자가 최신 버전을 받지 못할 수 있습니다.
과거에는 다운로드가 완료될 때까지 앱을 열려 있어야 했지만, 지금은 백그라운드 다운로드를 사용합니다. 다만 여전히 몇 초로 제한됩니다.
Android
“Android” 섹션다운로드 불가
“Cannot download” 섹션인도에서 일부 기기에서 문제가 발생한 사례가 있습니다. 통화 중 사용자에게 다른 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 앱 보안 정책상 “HTTP” 엔드포인트를 사용할 수 없다는 점에 유의하세요. 그래도 사용해야 한다면 다음 가이드를 따르세요:
압축 해제
“압축 해제” 섹션Unzip 문제: DEFLATED 항목에 EXT descriptor가 있을 수 있음
CLI 이외의 도구로 번들을 압축했다면 zip 형식이 올바르지 않을 수 있으니, CLI 명령을 사용하세요. npx @capgo/cli zip BUNDLE_FOLDER.
Java의 알려진 문제입니다:
Clearfix 문제
“Clearfix 문제” 섹션- usesCleartextTraffic 관련 문제가 있다면 플러그인이 sonar cloud에서 권장하는 모범 사례를 따르기 때문입니다. 90%의 경우에는 정상적으로 작동하지만 일부 플러그인에서는 문제가 생깁니다.
해결하려면 다음에 추가하세요 android/app/src/main/AndroidManifest.xml 플러그인의 <application> key:
tools:replace="android:usesCleartextTraffic"xmlns:tools="http://schemas.android.com/tools"iOS
“IOS” 섹션개인정보 매니페스트
“Privacy manifest” 섹션다음을 추가하세요 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.
네트워크 권한
“네트워크 권한” 섹션업데이트 테스트를 위해 로컬 서버를 사용하면 앱이 네트워크 권한을 요청하는데, 이는 정상 동작이며 원격 서버를 사용할 때는 그렇지 않습니다.
양쪽 OS
“양쪽 OS” 섹션manual mode로 업데이트할 때 일부 이벤트는 잡기 어렵습니다. 예를 들어 update fail은 JS code 리로드 직전에 트리거되어 감지할 수 없습니다.
대안은 번들을 나열하고 에러 통계를 확인해 업데이트 실패 여부를 파악하는 것입니다.
향후 더 나은 처리 방법을 찾아야 하지만, auto mode가 권장 업데이트 방식이라 우선순위는 아닙니다.
이를 개선하는 데 도움이 될 PR을 환영합니다.
CLI
“CLI” 섹션CLI에서 무엇을 하든 문제가 있다면,
다음을 확인하세요: appId 및 appName 에 존재합니다 capacitor.config.ts
공식 문서 가이드를 따르세요:
Known issues에서 계속하기
“Known issues에서 계속하기” 섹션사용 중이라면 알려진 문제 네이티브 플러그인 작업을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/capacitor-updater 사용하기 네이티브 기능의 경우 @capgo/capacitor-updater 사용하기에서, Capgo 플러그인 디렉토리 Capgo Plugin Directory의 제품 워크플로우에 맞춰, Capgo의 Capacitor 플러그인 Capgo의 Capacitor 플러그인 구현 상세 내용에 대해서는, 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트 구현 상세 내용에 대해서는, Ionic Enterprise 플러그인 대안 Ionic Enterprise 플러그인 대안의 제품 워크플로우에 대해서는.