Build and Distribute your App
现在你已经构建了你的第一个应用,接下来你会想要将它分发给所有人使用。构建和部署应用的流程可能相当繁琐。这正是 Appflow 发挥作用的地方。Appflow 允许你高效地生成网页和原生构建、推送实时应用更新、将应用发布到应用商店,并自动化整个过程。完整的快速入门指南可以在这里找到。
下面我们将概述这些步骤。
连接你的代码仓库
Appflow 直接与 Git 版本控制系 统协同工作,并使用你现有的代码库作为部署和打包构建的单一事实来源。你首先需要与你所选用的托管服务(如 GitHub 或 Bitbucket)进行集成,或者你也可以直接将代码推送到 Appflow。完成这一步后,Appflow 就能访问你的代码了。
关于如何将你的代码仓库连接到 Appflow 的更多信息,请查看 Appflow 文档中的连接你的代码仓库部分。
安装 Appflow SDK
Appflow SDK(也称为 Ionic Deploy 插件)将让你能够利用 Appflow 最强大的两个功能:向你的应用部署实时更新,以及绕过应用商店。Ionic Appflow 的实时更新功能随 Appflow SDK 一同提供,它能够检测并同步你推送到仪表板中指定渠道的应用更新。
要将 Appflow SDK 插件添加到你的项目中,你可以按照 Appflow 仪表板中的安装说明进行操作,只需在 Deploy > Destinations 部分点击“安装说明”即可。或者,你也可以通过在应用的根目录中执行以下命令手动安装该插件:
ionic deploy add \
--app-id="YOUR_APP_ID" \
--channel-name="YOUR_CHANNEL_NAME" \
--update-method="background|auto|none" \
有关安装 Appflow SDK 的先决条件和更多说明,请访问 Appflow 文档中的安装 Appflow SDK 部分。
推送提交
为了让 Appflow 能够访问你代码的最新更改,你需要通过你选择的版本控制集成来推送一个提交。对于使用 GitHub 或 Bitbucket 的用户,操作如下:
git add . # 暂存所有更改
git commit -m "added appflow sdk" # 提交暂存的更改
git push origin main # 将主分支的更改推送到你的 Git 托管服务
推送完成后,你将在 Appflow 仪表板的 Commits 选项卡下看到你的提交。有关此内容的更多信息,请查看 Appflow 文档中的推送提交部分。
部署实时更新
在安装了 Appflow SDK 并将提交推送到仪表板之后,你就可以准备向设备部署实时更新了。实时更新功能利用已安装的 Appflow SDK 和你的原生应用,监听特定的部署渠道目标。当实时更新被分配给一个渠道目标时,该更新将被部署到运行着配置为监听该特定渠道目标的二进制文件的用户设备上。
要部署实时更新,需要创建一个 Web 构建。这可以通过 Commits 选项卡中的 Start build 图标完成,也可以通过 Build > Builds 选项卡右上角的 New build 按钮完成。选择要部署的正确提交后,选择 Web 目标平台和 Latest 构建堆栈。根据你的 Appflow 计划,你还可以选择包含自定义环境(如果已配置)。最后,你可以启用 Live Update 并选择渠道,以便在构建成功完成后自动分配给它。
Web 构建完成后,你将获得额外的版本控制选项。完成此部分并拥 有成功的部署构建后,你可以通过点击构建详情页面中的 Deploy live updates 按钮,将其分配给安装 Appflow SDK 时配置的监听渠道。同样,你也可以在 Build > Builds 选项卡中点击构建上的 Deploy live updates 图标,并从下拉列表中选择渠道来完成此操作。
要接收此实时更新,你需要在设备或模拟器上运行该应用。最简单快捷的方式是通过以下命令:
ionic cordova run [ios | android] [options]
假设应用已正确配置以监听你部署到的渠道,并且你在设置过程中选择了自动更新方法,那么应用在启动时应立即更新。如果选择了后台更新方法,请确保在应用中停留约 30 秒以确保更新下载完成。然后,关闭应用并重新打开,你将看到更新已应用。
要深入了解部署实时更新的步骤,以及更多信息(例如为开发环境禁用部署),请查看 Appflow 文档中的部署实时更新部分。
构建原生二进制文件
接下来是为你的应用构建和部署过程生成原生二进制文件。这可以通过 Ionic Package 服务完成。首先,你需要创建一个打包构建。这可以通过点击 Commits 选项卡中的 Start build 图标完成,也可以通过 Build > Builds 选项卡右上角的 New build 按钮完成。然后,为你的构建选择正确的提交,并填写所有必填字段以及任何你想要指定的可选字段。填写完所有信息并开始构建后,你可以查看其进度,并在遇到任何错误时查看日志。
假设打包构建成功,你将获得一个 iOS 二进制文件(.ipa 或 IPA)和/或一个 Android 二进制文件(.apk 或 APK)。随后,你可以通过点击构建详情页面右侧 Artifacts 部分中的文件名,或在 Build > Builds 选项卡中点击构建上的 Download IPA/APK 图标来下载该文件,以便将其安装到设备上。
有关构建原生二进制文件的更多信息,请查看 Appflow 文档中的构建原生二进制文件部分。
创建自动化流程
自动化流程让你和你的团队能够充分利用 Appflow 的完整 CI/CD 能力。你可以创建自动化流程,在团队每次向指定分支提交新代码时触发打包构建和部署构建。自动化流程还可以配置为使用不同的环境和原生配置,为开发、预发布、QA 和生产环境构建不同版本的应用。
更多信息,请访问 Appflow 文档中的创建自动化流程部分。在那里你将看到创建单个自动化流程的详细信息。不过,你可以为不同的分支或工作流创建多个自动化流程,并根据需要进行定制。需要注意的是,创建自动化流程的功能适用于我们的基础计划及更高级别的用户。
创建环境
打包构建和部署构建可以通过环境进一步定制。这个强大的功能允许你根据构建时传入的环境变量创建不同的配置。当与自动化流程功能结合使用时,开发团队可以 轻松配置开发、预发布和生产环境的构建配置,从而遵循 DevOps 最佳实践,比以往更快地交付更高质量的更新。
创建环境的功能适用于我们的基础计划及更高级别的用户。更多相关信息请参阅 Appflow 文档中的创建环境部分。
创建原生配置
原生配置允许你轻松修改不同环境(开发、生产、预发布等)之间可能变化的常见配置值,这样你就不需要使用额外的逻辑或手动将它们提交到版本控制系统。原生配置可以附加到任何打包构建或自动化流程上。
原生配置可用于:
- 覆盖
config.xml中的唯一包标识符或 id 属性 - 覆盖设备主屏幕上显示的应用名称
- 覆盖 Appflow SDK(Deploy 插件)的变量和偏好设置
要获得创建原生配置的能力,你需要订阅我们的基础计划或更高级别。有关此功能的更多详细信息,请查看 Appflow 文档中的创建原生配置部分。
下一步是什么?
恭喜!你已经开发了一个完整的跨平台照片库应用,它可以在 Web、iOS 和 Android 上运行。不仅如此,你还构建了该应用并将其部署到了用户的设备上!
从这里开始,有许多路径可以探索。尝试在应用中添加另一个 Ionic UI 组件,或更多原生功能。一切皆有可能。一旦你添加了另一个功能,通过 Appflow 再次运行构建和部署流程,将其交付给你的用户。
祝你应用开发顺利!💙