跳过内容
Capgo - Capacitor 应用程序的实时更新 Capgo

已知问题

Ionic live reload

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

Quasar live reload

标题：Quasar live reload
  • 它使用相同的系统在背后，因此您将无法看到您的更新。

更新失败

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

Android

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，则压缩包的格式或压缩包本身可能不正确，请使用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

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

网络权限

Section titled “网络权限”

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

Both OS

Section titled “Both OS”

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

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

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

PRs欢迎帮助我们改进这个问题。

CLI

CLI

如果您的CLI出现任何问题

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

__CAPGO_KEEP_0__配置

Capacitor Configuration