简单讲解关于微信小程序调整 miniprogram 后, tabbar 找不到图片的原因之一

微信小程序开发,[ miniprogram/app.json 文件内容错误],["tabBar"]["list"][0]["iconPath"]: "/miniprogram/assets/tabbar/icon_main_home.png" 未找到

简单讲解关于调整 miniprogram 后, tabbar 找不到图片的原因之一

问题出现的原因

  1. 当我开发微信小程序一段时间后,就准备使用npm导包依赖第三方库,导包之前就调整了一下项目结构,把所有源码放到 miniprogram 文件夹下,在project.config.json中配置了 "miniprogramRoot": "miniprogram/",项目此时是正常的。
  2. 当我把图片也归整了一下,把tabbar图片,从 /miniprogram/images/ 文件夹下,迁移到新建的 /miniprogram/assets/tabbar/ 文件夹下,在 app.json 中的 tabbar 位置修改了图片路径,再次编译,此时就报错了

错误提示

[ miniprogram/app.json 文件内容错误] miniprogram/app.json: ["tabBar"]["list"][0]["iconPath"]: "/miniprogram/assets/tabbar/icon_main_home.png" 未找到 ... ...

修改之前的代码片段:

javascript 复制代码
"list": [
      {
        "pagePath": "pages/main-home/home",
        "text": "首页",
        "iconPath": "images/icon_main_home.png",
        "selectedIconPath": "images/icon_main_home_active.png"
      },
      {
        "pagePath": "pages/main-mine/mine",
        "text": "我的",
        "iconPath": "images/icon_main_mine.png",
        "selectedIconPath": "images/icon_main_mine_active.png"
      }
    ],

调整源码到 miniprogram 文件夹,并且又调整了图片目录结构,此时报错了,代码片段:

javascript 复制代码
"list": [
      {
        "pagePath": "pages/main-home/home",
        "text": "首页",
        "iconPath": "/miniprogram/assets/tabbar/icon_main_home.png",
        "selectedIconPath": "/miniprogram/assets/tabbar/icon_main_home_active.png"
      },
      {
        "pagePath": "pages/main-mine/mine",
        "text": "我的",
        "iconPath": "/miniprogram/assets/tabbar/icon_main_mine.png",
        "selectedIconPath": "/miniprogram/assets/tabbar/icon_main_mine_active.png"
      }
    ],

出现错误疑惑点

  1. 路径完全正确
  2. 点击图片路径也能正常跳转到图片
  3. 看着与调整项目之前并没什么区别
  4. 不能使用 ../ 调用父级,我就使用 / 直接从文件根目录写

以上几点是我一开始觉得,什么都对了,什么也都试了,为什么还出错误呢?

错误原因

  1. 调整项目后,在 project.config.json 中配置了 "miniprogramRoot": "miniprogram/" ,此时的根目录就是当前 app.json 的位置,asset 文件夹与 app.json 文件同级。
  2. "/miniprogram/assets/tabbar/icon_main_home.png" 配置中的地址第一个 / 代表的就是miniprogram/ ,把当前配置项的图片地址翻译完整为 miniprogram/miniprogram/assets/tabbar/icon_main_home.png

故而微信开发者工具提示图片未找到的错误

正确写法

  1. 因为项目的根目录已经在 project.config.json 中配置了 "miniprogramRoot": "miniprogram/" ,项目根路径 / 就代表是 miniprogram/ 文件夹。
  2. 又因为 app.json 配置文件 与 assets 文件夹在同级,在 app.json 配置文件中,tabbar 图片路径地址可直接写 assets/tabbar/icon_main_home.png,或者在地址前添加 .// 就可以了。

正确的代码片段:

javascript 复制代码
"list": [
      {
        "pagePath": "pages/main-home/home",
        "text": "首页",
        "iconPath": "assets/tabbar/icon_main_home.png",
        "selectedIconPath": "assets/tabbar/icon_main_home_active.png"
      },
      {
        "pagePath": "pages/main-mine/mine",
        "text": "我的",
        "iconPath": "assets/tabbar/icon_main_mine.png",
        "selectedIconPath": "assets/tabbar/icon_main_mine_active.png"
      }
    ],

总结

  1. project.config.json 中配置了 "miniprogramRoot": "miniprogram/" ,就代表小程序的根目录为 miniprogram/
  2. 在开发项目时,使用 / 对资源文件的调用,就指的是 miniprogram/ 文件夹
  3. 在了解配置的真正含义,并充分了解配置所带来的项目变化,掌握其开发规范,以及注意事项,在开发过程中,就会避免踩很多坑
相关推荐
毕设源码-邱学长3 小时前
【开题答辩全过程】以 基于微信小程序校园综合服务平台的设计与实现为例,包含答辩的问题和答案
微信小程序·小程序
Thetimezipsby3 小时前
基于Taro4打造的一款最新版微信小程序、H5的多端开发简单模板
前端·javascript·微信小程序·typescript·html5·taro
從南走到北3 小时前
JAVA同城打车小程序APP打车顺风车滴滴车跑腿源码微信小程序打车源码
java·开发语言·微信·微信小程序·小程序
猫七先生6 小时前
微信小程序一键登录可行性方案
前端·微信小程序
canglingyue6 小时前
微信小程序截屏与录屏功能详解
微信小程序·小程序
微三云-轩7 小时前
区块链系统:解决549 亿元积分商城是否违法的问题
大数据·小程序·重构·区块链·生活
D1555408805810 小时前
电竞护航小程序成品搭建三角洲行动护航小程序开发俱乐部点单小程序成品游戏派单小程序定制
游戏·小程序
说私域20 小时前
兴趣电商内容数据洞察未来市场走向研究——基于开源AI智能名片链动2+1模式S2B2C商城小程序的实践
人工智能·小程序
吴传逞20 小时前
记一次uniapp微信小程序开发scss变量失效的问题
微信小程序·uni-app·scss
wmsj057820 小时前
小程序图片批量保存太麻烦?用这款工具一键搞定,附工具教程!
小程序