已知问题

GitHub

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

Ionic 实时重载

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

Quasar live reload

Quasar使用相同的系统，底层是ionic，因此您将无法看到更新。

更新失败

在过去，用户需要一直打开应用程序直到下载完成，现在我们使用后台下载，但仍然受限于几秒钟。
安卓

无法下载

Section titled “Updates fail”

我们在印度发现了一些设备问题，通过电话与用户联系，尝试了不同的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 entries可以有EXT描述符

如果您使用CLI以外的工具打包您的应用程序，则压缩格式或zip可能不正确，请使用CLI命令 npx @capgo/cli zip BUNDLE_FOLDER.

这是Java的一个已知问题：

压缩问题：DEFLATED entries可以有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

网络权限

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

Both OS

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

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

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

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

CLI

如果您的 CLI 有任何问题，

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

请遵循官方文档的指引:

Capacitor 配置

继续从已知问题

如果您正在使用 已知问题 来规划原生插件工作，连接它使用 @capgo/capacitor-updater 使用 @capgo/capacitor-updater Capgo 插件目录 Capgo 插件目录 Capacitor 由 Capgo 提供的插件 Capacitor 由 Capgo 提供的插件添加或更新插件添加或更新插件 Ionic Enterprise 插件替代方案 Ionic Enterprise 插件替代方案