已知问题

GitHub

复制一个设置提示，包括安装步骤和此插件的全Markdown指南。

Ionic 实时预览

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

Quasar 实时预览

它使用相同的系统在背后，因此您将无法看到您的更新。

更新失败

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

安卓

无法下载

因此，如果您遇到问题，请尝试使用不同的DNS服务器，如__CAPGO_KEEP_0__或Google DNS。

Cloudflare: 1.1.1.1和1.0.0.1

Cloudflare: 1.1.1.1 and 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，您的压缩包格式或压缩包可能是错误的，请使用 CLI 命令 npx @capgo/cli zip BUNDLE_FOLDER.

这是 Java 的一个已知问题：

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

清除浮动问题

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

要解决这个问题，请在 android/app/src/main/AndroidManifest.xml 中添加 <application> key :

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

网络权限

当使用本地服务器进行测试更新时，应用会要求网络权限，这是正常行为，使用远程服务器时不会出现此问题。

两种操作系统

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

另一个选择是列出捆绑包并检查错误统计以了解更新是否失败。

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

欢迎PR来帮助我们改进这个。

CLI

如果您的CLI出现任何问题

检查 appId 和 appName 是否在您的__CAPGO_KEEP_0__.config.ts中存在 capacitor.config.ts

按照官方文档的指引：

Capacitor 配置

从已知问题中继续前进：

如果您正在使用 已知问题 来规划原生插件工作，连接它到使用 @capgo/capacitor-updater 为原生能力在使用 @capgo/capacitor-updater, Capgo 插件目录为产品工作流程在 Capgo 插件目录, Capacitor 由 Capgo 的插件 for the implementation detail in Capacitor Plugins by Capgo, 添加或更新插件关于在添加或更新插件中实现详细信息的说明 Ionic企业插件替代品关于Ionic企业插件替代品的产品工作流程