简单讲解关于微信小程序调整 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. 在了解配置的真正含义,并充分了解配置所带来的项目变化,掌握其开发规范,以及注意事项,在开发过程中,就会避免踩很多坑
相关推荐
文心快码BaiduComate1 小时前
用Comate Zulu开发一款微信小程序
前端·后端·微信小程序
Emma歌小白2 天前
如何首次运行小程序后端
微信小程序
赣州云智科技的技术铺子2 天前
【一步步开发AI运动APP】十二、自定义扩展新运动项目1
微信小程序·小程序·云开发·智能小程序
2501_915918412 天前
iOS 上架全流程指南 iOS 应用发布步骤、App Store 上架流程、uni-app 打包上传 ipa 与审核实战经验分享
android·ios·小程序·uni-app·cocoa·iphone·webview
00后程序员张2 天前
iOS App 混淆与加固对比 源码混淆与ipa文件混淆的区别、iOS代码保护与应用安全场景最佳实践
android·安全·ios·小程序·uni-app·iphone·webview
破无差3 天前
《赛事报名系统小程序》
小程序·html·uniapp
00后程序员张3 天前
详细解析苹果iOS应用上架到App Store的完整步骤与指南
android·ios·小程序·https·uni-app·iphone·webview
海绵宝宝不喜欢侬3 天前
uniapp-微信小程序分享功能-onShareAppMessage
微信小程序·小程序·uni-app
2501_915106323 天前
Xcode 上传 ipa 全流程详解 App Store 上架流程、uni-app 生成 ipa 文件上传与审核指南
android·macos·ios·小程序·uni-app·iphone·xcode
亮子AI3 天前
【小程序】微信小程序隐私协议
微信小程序·小程序