从应用中心迁移到Capgo

迁移总结

Capgo __CAPGO_KEEP_0__ 是一项服务，帮助开发团队将实时应用发送到已部署的应用中。
Capacitor 可以支持使用 jQuery Mobile、Framework 7、Sencha、KendoUI、Ionic 或自定义解决方案编写的 JavaScript 应用进行迁移。 不需要现有的Ionic应用。.
Colt 提供了App Center Build (构建Android/iOS应用)的等效服务。对于测试、诊断和分析服务。

注意

如果您的应用仍在使用Cordova，需要 Capacitor 在迁移到Capgo之前

Capacitor

Fortunately, the migration process is easy and the majority of Cordova plugins are backward compatible with Capacitor. __CAPGO_KEEP_0__.

About Capgo

Capgo, handles updating apps over time. Development teams can focus completely on the unique features of their app and outsource the complicated app delivery process to Capgo.

Capgo 填补了 Web 交付和移动之间的空白。

Capgo 的先决条件

类似于 App Center, Capgo 支持在 Azure DevOps、Bitbucket、GitHub 和 GitLab 上托管的 Git 存储库的应用。

安装 Capgo CLI

注意

您需要在继续之前在计算机上安装 Node 和 NPM。始终使用当前 LTS 版本 Capgo 不要使用旧版本。

创建 `package.json` 并 Capacitor 配置文件

注意

开始之前，我建议在一个新的 Git Branch 上进行修改。

由于 Capgo 创建了 capacitor 应用程序的自动化工具，因此它需要一个文件，而您的应用程序可能没有。首先，创建一个 capacitor.config.json 创建文件的最简单方法是在应用程序根目录中运行：

npm install @capacitor/core

然后，使用 CLI 问卷初始化 Capacitor：

npx cap init

CLI 将向您询问一些问题，包括您的应用程序名称和您希望为应用程序使用的包 ID。

最后，将新文件提交到您的项目：

git add .git commit -m "added package json and capacitor config" && git push

迁移 Code

现在您已经拥有了新的必需的 __CAPGO_KEEP_0__ Migrate the Capgo 文件已经放在正确的位置，你可以转移注意力到实际的应用本身。 Capgo 期望整个构建好的应用程序位于一个名为 dist.

如果你的构建好的code不在一个 dist 目录中，请在Capacitor配置文件中修改这个值。

以下是应用程序目录结构的示例：

应用程序结构

Capgo配置

在你的应用程序准备好 Capgo 集成之后，是时候注册并获取API密钥来上传你的第一个版本了！首先注册一个Capgo账户.

Once you’re logged into Capgo, navigate to the Account page then click on API key, then click on the ‘write’ key to copy it to your clipboard.

安装 Capgo 的 SDK

在命令行中，直接在你的 Capacitor 应用程序根目录下，运行以下命令：

npm i @capgo/capacitor-updater && npx cap sync 将插件安装到你的 Capacitor 应用程序中。

然后将 code 添加到你的应用程序中，代替 CodePush：

import { CapacitorUpdater } from '@capgo/capacitor-updater'

CapacitorUpdater.notifyAppReady()

这将告诉本机插件安装成功。

部署实时更新（CodePush替代品）

实时更新功能通过使用已安装的 Capgo SDK 在本机应用程序中监听特定的发布渠道目的地。当分配给渠道目的地的 Web 构建分配给用户设备时，更新将部署到配置为监听指定渠道目的地的二进制文件。

首先使用 all apikey 在您的帐户中，用于登录的密钥：CLI

npx @capgo/cli@latest login YOURKEY

添加您的第一个应用

让我们从创建应用程序开始，使用 Capgo Cloud 和 CLI 中的密钥

npx @capgo/cli@latest app add

此命令将使用 Capacitor 配置文件中定义的所有变量来创建应用程序

上传您的第一个捆绑包

使用以下命令构建您的 code 并将其发送到 Capgo：

npx @capgo/cli@latest bundle upload --channel production

默认情况下，版本名称将是您的 package.json 文件中的一个

检查 Capgo 是否存在构建

您甚至可以使用我的移动沙盒应用.

设置默认频道

您将应用程序发送到Capgo后，需要设置您的频道 default 让应用程序接收来自Capgo的更新。

npx @capgo/cli@latest channel set production -s default

配置应用程序验证更新

将此配置添加到您的主JavaScript文件中。

import { CapacitorUpdater } from '@capgo/capacitor-updater'

CapacitorUpdater.notifyAppReady()

然后执行 npm run build && npx cap copy 更新您的应用程序。

在设备上接收实时更新

为了让您的应用程序从Deploy接收实时更新，您需要在设备或模拟器上运行应用程序。最简单的方法是使用以下命令直接在模拟器或连接到计算机的设备上启动本地应用程序。

npx cap run [ios | android]

打开应用程序，放到后台，然后再次打开它，您应该在日志中看到应用程序已经更新了。

恭喜! 🎉 您已经成功部署了第一个实时更新。这只是您可以使用实时更新的开始。要了解更多信息，请查看完整的实时更新文档.

移除 App Center 依赖项

现在我们已经集成 Capgo 的服务后，您应该移除任何 App Center 的引用。除了移除未使用的 code/services 是最佳实践外，移除 SDK 还可以减少应用程序的大小。

首先，打开终端，然后卸载 App Center 插件：

    cordova plugin remove cordova-plugin-appcenter-analytics cordova-plugin-appcenter-crashes cordova-plugin-code-push

接下来，打开 config.xml 并移除以下 preference 值。它们将类似于：

    <preference name="APP_SECRET" value="0000-0000-0000-0000-000000000000" /><preference name="CodePushDeploymentKey" value="YOUR-ANDROID-DEPLOYMENT-KEY" /><preference name="CodePushPublicKey" value="YOUR-PUBLIC-KEY" />

如果您在应用程序中使用 App Center 分析，则移除以下 preferences 元素： APPCENTER_ANALYTICS_ENABLE_IN_JS 和 APPCENTER_CRASHES_ALWAYS_SEND.

移除以下 <access /> 元素：

    <access origin="https://codepush.appcenter.ms" /><access origin="https://codepush.blob.core.windows.net" /><access origin="https://codepushupdates.azureedge.net" />

在 CSP 中移除 CodePush 的引用 meta 标签在文件（ index.html 最后，在您的应用中，移除任何 __CAPGO_KEEP_0__ App Center 服务的引用，例如https://codepush.appcenter.ms):

    <meta http-equiv="Content-Security-Policy" content="default-src https://codepush.appcenter.ms 'self' data: gap: https://ssl.gstatic.com 'unsafe-eval'; style-src 'self' 'unsafe-inline'; media-src *" />

Finally, within your app, remove any code references to App Center services, such as codePush.sync();.

您已经从 App Center 迁移到 __CAPGO_KEEP_0，利用了实时更新。这只是您可以使用 CAPGO_KEEP_1 的开始。探索服务的其他功能，包括 Channel（多个环境）和覆盖。Cloud CAPGO_KEEP_2 集成，使用 CAPGO_KEEP_3 在您的 CI/CD 平台（例如 CAPGO_KEEP_4__ 动作，GitLab，Jenkins 等）中。

You’ve migrated from App Center to Capgo, utilizing the Live Updates. This is just the beginning of what you can use Capgo for. Explore the rest of the service includes Channel (multiple environments) and override. Cloud CLI integration, use Capgo inside your CI/CD platform of choice (such as GitHub Action, GitLab, Jenkins, and more).

如果您的 __CAPGO_KEEP_0 hosted 在 CAPGO_KEEP_1 上，您可以在几步之内设置自动构建和发布，感谢 CAPGO_KEEP_2__ 动作。

If your code is hosted on GitHub, you can set up automatic build and release in a few more steps, thanks to GitHub actions.

致谢

感谢 __CAPGO_KEEP_0__

非常感谢 Ionic, 本文基于本文重写使用 Chat-GPT-3 并适配。

从 App Center 迁移到 Capgo