构建和分发你的应用
现在你已经构建了你的第一个应用,接下来你会希望将它分发给每个人使用。构建和部署应用的机制可能相当繁琐。这正是 Appflow 发挥作用的地方。Appflow 允许你高效地生成 Web 和原生构建,推送实时应用更新,将应用发布到应用商店,并自动化整个过程。完整的快速入门指南可以在这里找到。
下面我们将概述这些步骤。
连接你的代码仓库
Appflow 直接与 Git 版本控制集成 ,并使用你现有的代码库作为部署(Deploy)和打包(Package)构建的真实来源。你首先需要与你的托管服务(如 GitHub 或 Bitbucket)集成,或者你也可以直接将代码推送到 Appflow。一旦完成这些,Appflow 就能访问你的代码。
关于如何将你的代码仓库连接到 Appflow 的更多信息,请查看 Appflow 文档中的连接你的代码仓库部分。
安装 Appflow SDK
Appflow SDK(也称为 Ionic Deploy 插件)将让你能够利用 Appflow 两个最强大的功能:向你的应用部署实时更新并绕过应用商店。Ionic Appflow 的实时更新(Live Update)功能随 Appflow SDK 提供,能够检测和同步你已通过仪表板推送到指定渠道的应用更新。
要将 Appflow SDK 插件添加到你的项目中,你可以按照 Appflow 仪表板中的安装说明操作,点击 Deploy > Destinations 部分中的 "Install Instructions"。或者,你也可以通过在应用根目录中执行以下命令来手动安装插件:
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 "添加了 appflow sdk" # 提交暂存的更改
git push origin main # 将主分支的更改推送到你的 Git 托管服务
推送完成后,你将在 Appflow 仪表板的 Commits 选项卡下看到你的提交。更多信息,请查看 Appflow 文档中的推送提交部分。
部署实时更新
安装好 Appflow SDK 并将提交推送到仪表板后,你就可以向设备部署实时更新了。实时更新功能利用已安装的 Appflow SDK 与你的原生应用一起监听特定的部署渠道目标(Deploy Channel Destination)。当实时更新被分配到某个渠道目标时,该更新将被部署到运行着配置为监听该特定渠道目标的二进制文件的用户设备上。
要部署实时更新,需要创建一个 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 cap 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 再次运行构建和部署流程,将其推送给你的用户。
祝你应用构建愉快!💙