CodePush

重要

Visual Studio App Center 计划于 2025 年 3 月 31 日停用。 虽然可以继续使用 Visual Studio App Center,直到它完全停用,但你可以考虑迁移到几个建议的替代方法。

详细了解支持时间线和替代方法。

CodePush 是一项 App Center 云服务,使React Native开发人员能够将移动应用更新直接部署到其用户的设备。 它充当中心存储库,开发人员可以将某些更新发布到 (,例如 JS、HTML、CSS 和图像更改) ,应用可以使用提供的客户端 SDK) 从 (查询更新。 这使你可以在解决 bug、添加不需要重新生成二进制文件的小功能或通过任何公共应用商店重新分发二进制文件时,与最终用户建立一个更具确定性、更直接的参与模型。 默认情况下,在 App Center 上创建的所有React Native应用都启用了 CodePush;若要开始使用 CodePush,需要执行以下步骤:

注意

对于 Android 设备,CodePush 仅适用于 TLS 1.2 兼容设备

注意

CodePush API 使用情况的速率限制为每 5 分钟应用 8 个请求。 这些按以下各项的组合进行计数:请求的终结点、IP 请求来自、部署密钥和客户端唯一 ID。如果达到限制,将返回状态代码为 429 的响应:

{
   "statusCode": 429,
   "message": "Rate limit is exceeded. Try again in X seconds."
}

1.安装 App Center CLI

使用 App Center CLI 管理 CodePush 的大部分功能。 若要安装 CLI,请打开终端窗口或命令提示符并执行以下命令:

npm install -g appcenter-cli

注意

如果执行此命令时发现错误 EACCES ,可能需要 修复系统上的 npm 权限。 许多站点建议使用 sudo 命令来避开此错误,但绝不应使用 sudo安装 npm 模块。

成功安装 App Center CLI 后,执行 appcenter login 命令为 App Center 帐户详细信息配置 CLI。

2. CodePush-ify 应用

将 CodePush 客户端 SDK 添加到应用,并将其配置为从 App Center 中的某个部署拉取应用更新。 以下部分详细介绍了如何针对支持的应用平台执行此操作:

3. 发布应用更新

更改应用的代码或资产后,使用 App Center CLI 将更新发布到 App Center,如以下部分所述。

React Native

执行 App Center CLI release-react 命令以捆绑应用的代码和资产文件,然后将其作为新版本发布到 App Center 服务器。 例如:

appcenter codepush release-react -a <ownerName>/MyApp

Cordova

执行 App Center CLI release-cordova 命令以捆绑应用的代码和资产文件,然后将其作为新版本发布到 App Center 服务器。 例如:

appcenter codepush release-cordova -a <ownerName>/MyApp

提示

App Center CLI 中的一项重要功能是能够使用 appcenter apps set-current <ownerName>/<appName>将应用设置为当前应用。 通过将应用设置为当前应用,无需使用 -a 标志。 例如,可以键入命令 appcenter codepush deployment list -a <ownerName>/<appName> ,就像设置当前应用一样 appcenter codepush deployment list 。 可以使用 检查哪个应用设置为帐户的当前应用appcenter apps get-current。 利用此命令可使大部分 CLI 命令更短。

4.运行应用

完成这些步骤后,运行应用的所有用户都将使用你在步骤 2 中配置的体验接收更新。 有关详细信息,请参阅 cli 和客户端 SDK 文档 (Apache CordovaReact Native) 。