既知の問題

GitHub

インストール手順と、このプラグインの完全なMarkdownガイドを含むセットアッププロンプトをコピーします。

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 サーバーを設定する方法は？

セルフホスト

セルフホストのアップデートをプッシュする場合、Android アプリのセキュリティポリシーにより「HTTP」エンドポイントは使用できないため注意してください。どうしても使用する必要がある場合は、以下のガイドに従ってください：

Android (9) Pie で HTTP と HTTPS のすべてのネットワーク接続を許可する方法は？

解凍

解凍時の問題: DEFLATED エントリに EXT デスクリプタが含まれている場合があります

CLI 以外のツールで bundle を zip した場合、フォーマットや 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

プライバシーマニフェスト

次を追加します： 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

手動モードでアップデートを行う際、一部のイベントの検知が困難な場合があります。例えば、アップデートの失敗はJSの code がリロードされる直前に発生するため、キャッチできないことがあります。

代替案として、bundleの一覧を表示し、エラー統計を確認することでアップデートの失敗を把握する方法があります。

将来的に、より良い解決策を見つける必要がありますが、アップデートにはautoモードの使用が推奨されているため、現時点では優先事項ではありません。

この改善に協力いただけるPRをお待ちしています。

CLI

CLI が正常に動作しない場合は、

以下を確認してください： appId と appName の capacitor.config.ts に含まれています

公式ドキュメントのガイドに従ってください：

Capacitor の設定

既知の問題から続行

使用している場合 既知の問題 ネイティブプラグインの作業を計画するには、次と連携してください： @capgo/capacitor-updater を使用する「@capgo/capacitor-updater を使用する」のネイティブ機能については、 Capgo プラグインディレクトリ Capgo プラグインディレクトリのプロダクトワークフローについては、 Capgo による Capacitor プラグイン Capgo による Capacitor プラグインの実装詳細については、プラグインの追加または更新プラグインの追加または更新における実装詳細については、および Ionic Enterprise プラグインの代替案 Ionic Enterprise プラグインの代替案におけるプロダクトワークフローについては。