迁移指南

重要

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

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

Visual Studio App Center 是 CodePush 的新主页。 App Center 是一种开发工具,其中包含一组用于生成和管理移动应用程序的云服务。 App Center 是下一代 HockeyApp 和 Xamarin Test Cloud。 详细了解 App Center

将 CodePush 移动到 App Center 是改善 CodePush 整体用户体验和进步的一步。

本指南旨在使从 CodePush 到 App Center 的迁移变得简单明了。 除了使用新 CLI 外,我们还尝试限制必须立即进行的更改。 在明年发布新 SDK 之前,无需对代码进行任何更改。

如果你是当前 CodePush 用户,则你的帐户已为你迁移。 可以通过登录到 App Center 来访问所有 CodePush 数据。 如果没有,也没关系! 可以通过 创建帐户开始。

入门

设置帐户

根据帐户的状态,此过程略有不同:

  • 当前 CodePush 用户:我们已经迁移了你的帐户! 无需进一步操作即可设置帐户。 可以通过登录到 App Center 来访问帐户数据。
  • 新建 CodePush 用户:在 App Center 上创建帐户。

注意

如果同时拥有共享电子邮件地址的 CodePush 和 App Center 帐户,则无需进一步操作。 登录 App Center 后,这些帐户将合并。

在 App Center 门户中进行设置

登录后,首先会看到所有应用程序的列表。 如果以前有一个 CodePush 应用程序,则应发现它已列出并进行了批注。

所有应用

CodePush 的后端迁移于 2017 年 6 月 2 日完成。 如果在此日期之前制作了任何应用,则必须指定应用的 OS 和平台。

Import

我们目前不支持门户中的 Cordova 应用。 你仍然可以使用 App Center CLI,我们正在努力支持其他平台。 App Center 的使命是为尽可能多的平台提供高质量的支持。 定期检查 App Center 博客以获取新闻或更新以及我们的产品路线图

如果导入了React Native应用,或者正在启动新的 React Native 应用,应会看到一个应用概述面板,用于管理应用并显示如何添加其他 App Center SDK。 App Center 应用机密允许应用将信息发送到 App Center,它与 CodePush 部署密钥不同。 可以通过打开终端并运行以下内容来检查 CodePush 部署密钥:

appcenter codepush deployment list <ownerName>/<appName> --displayKeys

安装 App Center CLI

若要开始向最终用户发布更新,必须安装 App Center CLI。 若要安装它,请打开终端窗口或命令提示符并执行以下命令:

npm install -g appcenter-cli

安装后, appcenter 请使用 命令,请参阅下面的可用命令。

若要登录到帐户,请使用 appcenter login。 此命令将打开 App Center 网站并显示身份验证令牌。

AuthToken

令牌必须放入 CLI 中才能进行身份验证并完成登录过程。

登录

现在,可以通过 App Center CLI 在应用中自由使用 CodePush 功能。

在 App Center 门户中使用 CodePush

可以在 App Center 门户的“分发”部分中找到 CodePush。 CodePush 仅在使用 React Native 时在 App Center 中可见,并且即将使用 Cordova 应用程序。

如果应用程序具有给定部署的发布历史记录,则这些版本将可见。 在部署之间切换就像使用屏幕右上角的下拉列表一样简单。

发布详细信息

单击“编辑”按钮将提供一个用于修补版本的面板。 编辑此页上的项等效于使用 appcenter codepush patch

发布修补程序

目前,使用 CodePush 的开发人员必须使用 App Center CLI 中的发布命令分发版本。 如果使用 仪表板 创建React Native应用,则必须使用 App Center 创建默认部署。

CreateDeployments

或者,在推送发布之前,可以在 App Center CLI 中使用以下命令创建建议的部署:

appcenter codepush deployment add -a <ownerName>/<appName> Staging
appcenter codepush deployment add -a <ownerName>/<appName> Production

App Center CLI 体验

CLI

本部分的构造旨在使你能够查看一些最常见的 CodePush 命令,以及它们在 App Center CLI 中的更改情况。

提示

可以使用 缩短 appcenter apps set-current <ownerName>/<appName>大多数 App Center CLI 命令。 通过将应用设置为当前应用,你不再需要使用 -a 标志来指定要尝试对其执行命令的应用。

在 App Center CLI 中创建应用:

appcenter apps create -d MyApp -o iOS -p React-Native

发布更新 App Center CLI:

appcenter codepush release-react MyApp 

列出应用部署 App Center CLI:

appcenter codepush deployment list MyApp

CLI 命令比较:

CodePush 应用中心
code-push app add MyApp ios react-native appcenter apps create -d MyApp -o iOS -p React-Native
不可用 appcenter apps set-current <ownerName>/MyApp
不可用 appcenter apps get-current
code-push deployment add myApp <DeploymentName> 如果设置了当前应用:: appcenter codepush deployment add <DeploymentName>
如果不是: appcenter codepush deployment add -a <ownerName>/MyApp <DeploymentName>
code-push release-react MyApp ios 如果设置了当前应用:: appcenter codepush release-react
如果不是: appcenter codepush release-react -a <ownerName>/MyApp
code-push access-key list appcenter tokens list

App Center CLI CodePush 速查表

命令 说明 示例
应用中心
appcenter help 获取命令或类别帮助 -
appcenter login 将 CLI 登录到 App Center -
appcenter logout 从 App Center 注销 CLI -
appcenter profile 查看和管理个人资料信息 -
appcenter tokens 管理 API 令牌 appcenter tokens list
appcenter orgs 管理组织 appcenter orgs list
应用
appcenter apps create 创建新应用 appcenter apps create -d MyApp -o Android -p React-Native
appcenter apps delete 删除应用 appcenter apps delete -a ownerName/MyApp
appcenter apps get-current 获取设置为所有 CLI 命令的默认值的应用程序 -
appcenter apps list 获取已配置应用程序的列表 -
appcenter apps set-current 为所有 CLI 命令设置默认应用程序 appcenter apps set-current <ownerName>/MyApp
CodePush
appcenter codepush deployment 查看和管理应用部署 appcenter codepush deployment list
appcenter codepush help 获取特定于 CodePush 的命令或类别帮助 -
appcenter codepush patch 更新现有版本的元数据 appcenter codepush patch -m
appcenter codepush promote 将最新版本从一个应用部署提升到另一个应用部署 appcenter codepush promote -s Staging -d Production
appcenter codepush release 发布对应用部署的更新 appcenter codepush release -a ownerName/MyApp
appcenter codepush release-cordova 将 Cordova 更新发布到应用部署 appcenter codepush release-cordova --description "modified assets"
appcenter codepush release-react 向应用部署发布React Native更新 appcenter codepush release-react -x
appcenter codepush rollback 回滚应用部署的最新版本 appcenter codepush rollback Staging

常见问题解答

移动会影响我的客户吗?

错误。

CodePush 有哪些更改?

目前,唯一的重大更改是使用 App Center CLI 和命令的结构。 在发布新 SDK(当前没有 ETA)之前,无需更改代码。 CodePush 团队非常出色地帮助你成功实现 CodePush。 没有这样一个惊人的社区,就不可能实现。

使用 CodePush 功能是否仍然免费?

是的。

为什么要搬家?

迁移到 App Center 意味着更多的支持、更多的资源,以及 Microsoft 移动开发的一流服务中的一个主页。

我还能登录吗?

是的。

是否可以继续使用 CLI?

是的,我们承诺将 CLI 维护到 2018 年 9 月。 可以继续使用 CLI,但除发布和查看指标之外的所有功能都将在 2018 年 3 月下旬禁用。 最后,CodePush CLI 将在 2018 Mid-October 停用。

如果我已有帐户,是否需要为 App Center 创建新帐户?

如果两个帐户都使用相同的电子邮件,则可以使用原始帐户登录到 App Center。 否则,将为 CodePush 应用创建一个。 若要从同一帐户管理应用,请在 App Center 中创建一个组织,向其添加新帐户,然后将应用转移到组织。

有用的资源