已知问题

GitHub

复制一个带有安装步骤和完整 Markdown 指南的设置提示。

Ionic 实时重载

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

Quasar 实时重载

它使用与ionic相同的系统，因此您不会看到更新。

更新失败

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

安卓

我们在印度发现了一些设备问题，通过电话与用户联系，要求他们尝试不同的DNS服务器，结果成功。

__CAPGO_KEEP_0__

Cloudflare

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 entries 可以有 EXT descriptor

清除浮动问题

如果您遇到使用CleartextTraffic的问题，原因是插件遵循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 重载之前，所以您无法捕捉到它。

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

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

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

CLI

如果您的 CLI 有任何问题，

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

请遵循官方文档的指引：

Capacitor 配置

从已知问题中继续

如果您正在使用 已知问题 来规划原生插件工作，连接它与使用 @capgo/capacitor-updater 为原生能力在使用 @capgo/capacitor-updater Capgo 插件目录产品工作流程在Capgo插件目录中 Capacitor插件由Capgo提供产品工作流程在Capacitor插件由Capgo提供添加或更新插件添加或更新插件的实现细节 Ionic企业插件替代方案的实现细节产品工作流程在Ionic企业插件替代方案中