快应用打包rpk同时生成了rpk和rpks是为什么?怎么用?-优雅草卓伊凡

举报
卓伊凡 发表于 2025/09/25 21:45:51 2025/09/25
【摘要】 快应用打包rpk同时生成了rpk和rpks是为什么?怎么用?-优雅草卓伊凡

快应用打包rpk同时生成了rpk和rpks是为什么?怎么用?-优雅草卓伊凡

引言

今天卓伊凡很神奇打包快应用,因为版权刚办理完成提交,发现生成了rpks和rpk

这是一个非常重要且常见的问题。当你修改配置后,打包工具同时生成 .rpk.rpks 两种文件,这反映了快应用联盟近年来的一次重大技术演进。

下面我将详细阐述其原理、内容以及区别。

上一篇因为报错我们把支持版本改成了1061

核心结论

  • .rpk: 是传统单包的快应用文件。它将所有页面、组件、资源都打包在一个文件中。
  • .rpks: 是分包(或称为Split Package)的快应用文件。它是一个压缩包,里面包含了一个主包(main.rpk)和若干个可独立下载的分包(subpackageX.rpk)。

生成两种包是为了兼容性。打包工具会同时生成两种格式,以确保应用能安装在不同版本的快应用平台(引擎)上。


详细介绍与对比

1. .rpk (单包)

  • 原理:这是快应用最初的组织形式。类似于一个小的安卓APK文件,所有代码和资源都被打包在一起。当用户打开应用时,需要一次性下载整个RPK文件。
  • 内容结构(压缩包内):
    .
    ├── manifest.json      # 应用配置文件,声明页面、权限、版本等
    ├── app.js            # 应用逻辑代码
    ├── common/           # 公共资源(图片、样式等)
    ├── pages/            # 所有页面
    │   ├── index/
    │   └── detail/
    └── ... (其他公共组件和逻辑)
    
  • 优点
    • 结构简单,开发调试方便。
    • 兼容所有版本的快应用平台。
  • 缺点
    • 首屏加载慢:随着业务增长,包体积会变大,导致用户首次打开应用时需要下载的等待时间变长。
    • 体积限制:快应用平台对单个RPK文件有严格的体积上限(通常为1MB或2MB),限制了应用的复杂度。

2. .rpks (分包)

  • 原理:为了解决单包体积限制和首屏加载问题,快应用联盟引入了分包机制。它借鉴了微信小程序等技术的思路,将应用划分为一个主包和多个分包
    • 主包:包含应用启动所需的首页、关键资源以及所有分包的公用的代码和资源。
    • 分包:包含某些特定功能模块的代码和资源。用户只有在进入该模块时,才会去下载对应的分包。
  • 内容结构.rpks 文件本身是一个ZIP包,解压后):
    .
    ├── manifest.json      # 总的配置文件,其中定义了分包信息
    ├── main.rpk          # 主包文件(它本身也是一个RPK格式的压缩包)
    └── subpackages/      # 分包目录
        ├── sub1.rpk      # 分包1
        └── sub2.rpk      # 分包2
    
  • 工作流程
    1. 用户点击快应用图标。
    2. 平台先下载并加载 main.rpk(主包),立刻显示首页。
    3. 当用户操作需要跳转到某个分包内的页面时(例如“个人中心”),平台才开始异步下载对应的 sub1.rpk
    4. 下载完成后,跳转到目标页面。
  • 优点
    • 优化首屏加载:主包体积小,下载快,用户体验更好。
    • 突破体积限制:整个应用的总大小可以远远超过1MB的限制(例如10MB+)。
    • 按需加载:用户可能永远用不到某些功能,则无需下载对应的分包,节省流量。
  • 前提条件:这正是你之前遇到的错误——必须将 app.json / manifest.json 中的 minPlatformVersion(最低平台版本号)设置为 1061 或以上,因为分包功能是在平台版本1061之后才支持的。

为什么你的项目会同时生成两种包?

这是由 uniapp打包工具的默认策略 决定的,目的是最大化兼容性

  1. 兼容旧平台:如果你的应用被安装在一个平台版本号 低于1061 的设备上,该设备无法识别分包。此时,平台会尝试寻找并安装同名的 .rpk 文件(单包)。
  2. 发挥新平台优势:如果你的应用被安装在一个平台版本号 高于或等于1061 的设备上,平台会优先识别并安装 .rpks 文件,从而享受分包带来的性能优势。

简单来说,打包工具为你做了两手准备:

  • .rpk 是给 老版本 手机用的。
  • .rpks 是给 新版本 手机用的。

如何选择和使用?

  • 测试阶段:你可以将 .rpk 文件上传到快应用官方调试器进行基础功能测试。但要完整测试分包功能,必须使用 .rpks 文件,并确保调试器的基础库版本足够高。
  • 发布阶段:当你将应用上传到各大厂商的快应用平台时,平台会自动根据用户手机的平台版本,智能地分发 .rpk(给老手机)或 .rpks(给新手机)。你一般不需要手动选择。

总结

特性 .rpk (单包) .rpks (分包)
本质 单个应用包 一个包含主包和多个分包的压缩包
兼容性 所有平台版本 平台版本 >= 1061
体积限制 严格(通常1MB) 大大放宽(通常10MB+)
加载方式 一次性加载全部 先加载主包,按需加载分包
首屏速度 慢(包大时明显) 快(主包小巧)
生成原因 为了兼容老版本平台 为了在新版本平台上获得更好性能

因此,同时生成两种包是正常且有益的行为,确保了你的应用能在尽可能多的设备上正常运行。

本次我们上传项目还是上传的rpk

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。