Capgo Updater 仓库

GitHub

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

Ionic live reload

When you develop, if you use the Ionic live reload feature from the CLI, it will override the plugin, so you will never see your update.

Quasar live reload

它使用相同的系统作为 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应用的安全政策。如果您仍然想这样做，请遵循以下指南：

How to allow all Network connection types HTTP and HTTPS in Android (9) Pie?

解压

解压问题：压缩包中的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 As __CAPGO_KEEP_0__ 的原因 UserDefaults API.

网络权限

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

两种操作系统

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

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

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

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

CLI

如果您的CLI出现任何问题

检查是否 appId 并且 context appName capacitor.config.ts

__CAPGO_KEEP_0__.config.ts

Capacitor Configuration

__CAPGO_KEEP_0__ 配置

如果您正在使用 已知问题 为了规划原生插件工作，连接它与使用@capgo/capacitor-updater for the native capability in Using @capgo/capacitor-updater, 使用@Capgo/__CAPGO_KEEP_1__-updater for the product workflow in Capgo Plugin Directory, 使用@Capacitor/Capgo-updater for the implementation detail in Capacitor Plugins by Capgo, 用于实现细节的用于实现细节的 Ionic企业插件替代方案为 Ionic Enterprise Plugin Alternatives 产品工作流程。