已知问题

GitHub

复制一个包含安装步骤和本插件完整 Markdown 指南的设置提示。

Ionic 实时重载

当您开发时，如果您从 CLI 使用 Ionic live reload 功能，它将覆盖插件，因此您将永远无法看到您的更新。

Quasar 实时重载

它使用相同的系统作为 Ionic 在底层，因此您将无法看到您的更新。

更新失败

这通常发生在推送大型更新（> 20MB）时，大部分用户将无法获得最新版本。
在过去，用户需要一直打开应用程序直到下载完成，现在我们使用后台下载，但它仍然受限于几秒钟。

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上设置首选DNS服务器？

自主托管

当您推送自主托管更新时，请注意，您不能使用“HTTP”端点，因为这违反了Android应用的安全政策。如果您仍然想这样做，请遵循以下指南：

如何在Android（9）Pie中允许所有网络连接类型的HTTP和HTTPS？

解压缩

解压缩问题：DEFLATED条目可以有EXT描述符

如果您使用CLI以外的工具打包您的捆绑包，打包格式或您的zip文件可能不正确，请使用CLI命令 npx @capgo/cli zip BUNDLE_FOLDER.

这是Java的一个已知问题：

解压缩问题：DEFLATED条目可以有EXT描述符

清除浮动问题

如果您遇到usesCleartextTraffic问题，原因是插件遵循Sonar Cloud的最佳实践，90%的情况下会正常工作，但某些插件会导致问题。

要解决这个问题，请在 android/app/src/main/AndroidManifest.xml 在 <application> 键：

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

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.

网络权限

当使用本地服务器进行测试更新时，应用程序会要求网络权限，这是正常行为，不是使用远程服务器时的情况。

双系统

在手动模式下进行更新时，某些事件不容易捕捉，例如更新失败触发器就在您的 JavaScript code 重载之前，因此您无法捕捉它。

一个替代方案是列出捆绑包并检查错误统计数据，以便知道更新是否失败。

我们需要在未来找到更好的方式来处理这个问题，但这不是优先事项，因为自动模式是推荐的更新方式。

欢迎来投稿帮助我们改进这个问题。

CLI

如果您的CLI无法正常工作

检查是否 appId 和 appName appName capacitor.配置文件

__CAPGO_KEEP_0__.config.ts

Capacitor 配置

遵循官方文档的指引

继续阅读已知问题部分 已知问题 为了计划本机插件工作，连接它使用@capgo/capacitor-updater 为本机能力在使用@capgo/capacitor-updater Capgo插件目录为产品工作流程在Capgo插件目录 Capacitor插件由Capgo 为实现细节在Capacitor插件由Capgo 添加或更新插件为实现细节在添加或更新插件，并 Ionic企业插件替代方案为产品工作流程在Ionic企业插件替代方案