简单讲解关于微信小程序调整 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. 在了解配置的真正含义,并充分了解配置所带来的项目变化,掌握其开发规范,以及注意事项,在开发过程中,就会避免踩很多坑
相关推荐
二J1 小时前
管理100个小程序-很难吗
android·小程序
qq_357389632 小时前
陪诊陪检系统源码,陪诊小程序,陪诊APP,陪诊服务,家政上门系统,居家护理陪护源码,医护小程序
小程序
橘猫云计算机设计14 小时前
springboot-基于Web企业短信息发送系统(源码+lw+部署文档+讲解),源码可白嫖!
java·前端·数据库·spring boot·后端·小程序·毕业设计
曲江涛19 小时前
爆改 toxml 组件 支持数据双向绑定 解决数据刷新问题
notepad++
跨时代科技1 天前
洗车小程序系统前端uniapp 后台thinkphp
小程序
依辰1 天前
小程序SAAS产品定制化需求解决方案
前端·javascript·微信小程序
fakaifa1 天前
【最新版】沃德代驾源码全开源+前端uniapp
前端·小程序·uni-app·开源·php·沃德代驾·代驾小程序
18538162800余。1 天前
NFC 碰一碰实现视频源码,网页与小程序协同
小程序
换日线°2 天前
微信小程序拖拽排序有效果图
微信小程序
码起来呗2 天前
基于微信小程序的走失儿童帮助系统-项目分享
微信小程序·小程序