快应用报错Module Error 分包要求 app.json#minPlatformVersion 不小于 1061, 当前值为 21解决方案-优雅草卓伊凡

简介: 快应用报错Module Error 分包要求 app.json#minPlatformVersion 不小于 1061, 当前值为 21解决方案-优雅草卓伊凡

快应用报错Module Error 分包要求 app.json#minPlatformVersion 不小于 1061, 当前值为 21解决方案-优雅草卓伊凡

快应用打包 提示:root: g:\clone\jingyu-uniapp\unpackage\dist\build\quickapp-webview-union
joyful: 2.0.1
webpack compiled with 1 error in 337 ms
ERROR in ./app.json?main
Module Error (from ~joyful\lib\loaders\entry-loader\index.js):
分包要求 app.json#minPlatformVersion 不小于 1061, 当前值为 21
参考: https://qapp-chimera.vivo.com.cn/reference/configuration/app.html

这个错误是因为快应用分包功能需要最低平台版本不低于1061,但当前配置的版本号是21。以下是解决方案:

方法1:修改app.json配置(推荐)

在项目的 app.json 文件中添加或修改 minPlatformVersion 配置:

{
  "minPlatformVersion": 1061,
  "pages": [
    // ...你的页面配置
  ],
  "subPackages": [
    // ...你的分包配置
  ]
}

方法2:检查uniapp配置

如果你使用的是uniapp,需要在 manifest.json 中配置快应用相关设置:

{
  "quickapp-webview": {
    "minPlatformVersion": 1061,
    "package": "你的包名",
    "name": "应用名称",
    "versionName": "1.0.0",
    "versionCode": 100
  }
}

方法3:检查分包配置

如果确实需要使用分包,请确保:

  1. 主包不能太大,建议主包不超过1MB
  2. 分包配置正确:
{
  "subPackages": [
    {
      "root": "subpackageA",
      "pages": [
        "page1",
        "page2"
      ]
    }
  ]
}

方法4:临时解决方案

如果暂时不需要分包功能,可以移除分包配置:

{
  "minPlatformVersion": 1061,
  "pages": [
    // 将所有页面放在主包中
  ]
  // 移除 subPackages 配置
}

验证配置

修改后重新打包:

npm run build:quickapp
# 或
yarn build:quickapp

注意事项

  1. 版本兼容性:1061是支持分包的最低版本,确保目标设备支持
  2. 包大小限制:快应用有严格的包大小限制,合理使用分包
  3. 资源引用:分包中的资源不能跨包引用

完成以上配置后,重新打包应该就能解决这个错误了。

这个报错还是由于文件太大导致打包需要分包,但是为什么版本要改成1061呢

1061是支持分包的最低版本,确保目标设备支持 为什么改版本是1061 而不是其他数字呢,另外 原本版本填写是21 这是不是跨度太大

这确实是一个很大的跨度。详细解释为什么是1061这个特定数字,以及为什么原本是21。

为什么是1061而不是其他数字?

1. 快应用版本号编码规则

快应用的平台版本号不是简单的序号,而是有特定编码规则的:

  • 前两位:代表主版本号(如10代表重大版本更新)
  • 后两位:代表次版本号(如61代表第61次更新)

所以1061表示的是第10个大版本的第61次更新。

2. 技术里程碑节点

1061是快应用联盟技术发展中的一个重要里程碑:

  • 分包功能在这个版本中首次完整实现并稳定
  • Web组件增强、性能优化等重大特性都在这个版本引入
  • 成为后续功能开发的基准版本

3. 联盟统一标准

快应用联盟(包括华为、小米、OPPO、vivo等厂商)在这个版本上达成了技术规范的一致性,确保分包功能在各厂商平台上的兼容性。

为什么原本是21?跨度为什么这么大?

1. 历史遗留问题

{
  "minPlatformVersion": 21  // 这是非常早期的版本号
}
  • 21对应的是快应用非常初期的版本(大约2018年左右)
  • 当时快应用刚推出,功能相对简单
  • 还没有分包等高级功能的概念

2. uniapp的默认值

当您在uniapp中创建快应用项目时,如果没有显式配置:

  • uniapp可能会设置一个很低的默认值(如21)
  • 这是为了最大程度的兼容性,确保应用能在尽可能老的设备上运行

3. 技术发展的体现

从21到1061的跨度反映了快应用技术的快速发展:

版本阶段

时间

主要特性

21-500

2018-2019

基础功能、API初步完善

500-800

2019-2020

性能优化、组件丰富

800-1000

2020-2021

生态建设、工具链完善

1000+

2021至今

分包功能、高级特性

4. 实际影响分析

设置1061意味着:

{
  "minPlatformVersion": 1061,
  "影响": {
    "优点": ["可以使用分包", "性能更好", "功能更丰富"],
    "缺点": ["无法在很老的设备上运行"]
  }
}

但实际情况是:

  • 目前市面上绝大多数快应用运行环境都已升级到1061+
  • 老版本设备的市场份额已经很小
  • 收益远大于代价

验证当前设备版本

您可以在快应用中使用以下代码检测当前平台版本:

// 在快应用页面中
export default {
  onInit() {
    console.log('当前平台版本:', this.$def.config.minPlatformVersion)
    // 或者使用系统API
    console.log('系统平台版本:', device.info.platformVersionCode)
  }
}

建议

  1. 保持1061:这是目前的主流选择,能享受最新特性
  2. 如果需要兼容更老设备:可以尝试逐步降低版本号测试
  3. 监控用户分布:通过数据分析了解用户使用的平台版本分布

总结:从21改为1061确实跨度很大,但这反映了快应用技术的快速演进。选择1061是拥抱新技术、优化用户体验的正确选择。

目录
相关文章
|
监控 JavaScript 前端开发
深入理解 Nuxt.js 中的 app:error 钩子
【9月更文挑战第25天】在 Nuxt.js 中,`app:error` 钩子是一个强大的工具,用于处理应用程序中的各种错误。它可以在服务器端渲染或客户端运行时触发,帮助提升应用稳定性和用户体验。通过在 `nuxt.config.js` 中定义该钩子,开发者可以实现错误页面显示、错误日志记录及错误恢复等功能,确保应用在遇到问题时能妥善处理并恢复正常运行。
374 10
|
小程序 JavaScript 前端开发
uni-app开发微信小程序:四大解决方案,轻松应对主包与vendor.js过大打包难题
uni-app开发微信小程序:四大解决方案,轻松应对主包与vendor.js过大打包难题
5443 1
|
缓存 编解码 数据可视化
uniapp发行快应用 [HBuilder] 23:33:45.537 manifest.json->quickapp-webview 缺少 icon 配置如何解决优雅草卓伊凡
uniapp发行快应用 [HBuilder] 23:33:45.537 manifest.json->quickapp-webview 缺少 icon 配置如何解决优雅草卓伊凡
549 5
uniapp发行快应用 [HBuilder] 23:33:45.537 manifest.json->quickapp-webview 缺少 icon 配置如何解决优雅草卓伊凡
|
Java Shell Maven
【Azure Container App】构建Java应用镜像时候遇无法编译错误:ERROR [build 10/10] RUN ./mvnw.cmd dependency:go-offline -B -Dproduction package
在部署Java应用到Azure Container App时,构建镜像过程中出现错误:“./mvnw.cmd: No such file or directory”。尽管项目根目录包含mvnw和mvnw.cmd文件,但依然报错。问题出现在Dockerfile构建阶段执行`./mvnw dependency:go-offline`命令时,系统提示找不到可执行文件。经过排查,确认是mvnw文件内容异常所致。最终通过重新生成mvnw文件解决该问题,镜像成功构建。
841 1
|
JSON Java 关系型数据库
Java更新数据库报错:Data truncation: Cannot create a JSON value from a string with CHARACTER SET 'binary'.
在Java中,使用mybatis-plus更新实体类对象到mysql,其中一个字段对应数据库中json数据类型,更新时报错:Data truncation: Cannot create a JSON value from a string with CHARACTER SET 'binary'.
1954 4
Java更新数据库报错:Data truncation: Cannot create a JSON value from a string with CHARACTER SET 'binary'.
|
人工智能 小程序 搜索推荐
uni app下开发AI运动小程序解决方案
本文介绍了在小程序中实现AI运动识别的解决方案。该方案依托于UNI平台,通过高效便捷的插件形式,实现包括相机抽帧控制、人体识别、姿态识别等在内的多项功能,无需依赖后台服务器,大幅提高识别效率和用户体验。方案内置多种运动模式,支持自定义扩展,适用于AI健身、云上赛事、AI体测等多场景,适合新开发和存量改造项目。
|
缓存 小程序 索引
uni-app开发微信小程序时vant组件van-tabs的使用陷阱及解决方案
uni-app开发微信小程序时vant组件van-tabs的使用陷阱及解决方案
1390 1
|
开发者 UED
深入理解 Nuxt.js 中的 app:error 钩子
【9月更文挑战第26天】在 Nuxt.js 中,钩子函数是在特定生命周期阶段执行代码的机制,`app:error` 钩子用于处理应用中的错误,包括服务器端和客户端渲染时出现的问题。它提供了一个集中处理错误的机制,提升了用户体验。当组件渲染过程中出现错误时,`app:error` 钩子会被触发,可以在 `nuxt.config.js` 文件中定义该钩子。通过分析错误对象 `err` 和上下文信息 `context`,开发者可以更好地处理各种错误情况。相比组件内的 `try/catch` 或浏览器原生错误处理,`app:error` 提供了更全局和有针对性的错误处理方式。
416 6
|
JSON API 数据格式
淘宝拍立淘按图搜索API系列,json数据返回
淘宝拍立淘按图搜索API系列通过图像识别技术实现商品搜索功能,调用后返回的JSON数据包含商品标题、图片链接、价格、销量、相似度评分等核心字段,支持分页和详细商品信息展示。以下是该API接口返回的JSON数据示例及详细解析:
|
JSON 算法 API
Python采集淘宝商品评论API接口及JSON数据返回全程指南
Python采集淘宝商品评论API接口及JSON数据返回全程指南

热门文章

最新文章