微信小程序app.json文件常用配置说明-j9九游

发布时间：2021-07-09 10:03 所属栏目：小程序开发教程

小程序根目录下的 app.json 文件用来对微信小程序进行全局配置，决定页面文件的路径、窗口表现、设置网络超时时间、设置多 tab 等。

josn文件不允许注释，下面为了学习加上注释，粘贴需要的片段去掉注释即可。小程序定义color建议使用16进制颜色

1. pages定义页面路径列表

"pages": [
    "pages/news/news",
     "pages/index/index",
    "pages/movie/movie",
    "pages/logs/logs"
  ],

2. window 用于设置小程序的状态栏、导航条、标题、窗口背景色

"window": {
    "backgroundtextstyle": "light",  // 下拉 loading 的样式，仅支持 dark / light
    "navigationbarbackgroundcolor": "white",  // 导航栏背景颜色
    "navigationbartitletext": "哈哈", // 导航栏标题内容
    "navigationbartextstyle": "black",  // 导航栏标题颜色 black / white
    "navigationstyle": "custom",  // 导航栏样式 默认为default  custom 表示自定义导航栏，只保留右上角
    "backgroundcolor":"#ffffff"  // 窗口的背景颜色
  },

3. tabbar

如果小程序是一个多 tab 应用（客户端窗口的底部或顶部有 tab 栏可以切换页面），可以通过 tabbar 配置项指定 tab 栏的表现，以及 tab 切换时显示的对应页面。

"tabbar": {
    "color": "#000",     // 文字默认颜色 
    "borderstyle": "black",      //  tabbar上边框的颜色  仅支持 black / white
    "selectedcolor": "#ff6600",   // tab 上的文字选中时的颜色
     "position":"bottom",  // 位置 top | bottom,
     "custom": "false",    // 自定义tabbar  默认false
    
    "list": [  // tab列表
      {
        "pagepath": "pages/news/news",  // 页面路径
        "text": "新闻",  // tab 上按钮文字
        "iconpath": "pages/images/yuedu.png",  //  图片路径，icon 大小限制为 40kb，建议尺寸为 81px * 81px，不支持网络图片。
当 position 为 top 时，不显示 icon。
        "selectediconpath": "pages/images/193.jpg"  //  选中时的图片路径，icon 大小限制为 40kb，建议尺寸为 81px * 81px，不支持网络图片。
当 position 为 top 时，不显示 icon。
      },
      {
        "pagepath": "pages/movie/movie",
        "text": "电影",
        "iconpath": "pages/images/diany.png",
        "selectediconpath": "pages/images/506.jpg"
      }
    
    ]
  },

4. networktimeout

各类网络请求的超时时间，单位均为毫秒默认值60000

"networktimeout": {
    "request": 10000,  //  wx.request 的超时时间
    "downloadfile": 10000,  // wx.downloadfile 的超时时间
    "connectsocket": 10000,  // wx.connectsocket 的超时时间
    "uploadfile": 10000  // wx.uploadfile 的超时时间
  },

5. debug

可以在开发者工具中开启 debug 模式

"debug": true,

6. requiredbackgroundmodes

申明需要后台运行的能力，类型为数组目前支持audio后台音乐播放 / location 后台定位

"requiredbackgroundmodes": ["audio", "location"],

7. permission

小程序接口权限相关设置。字段类型为 object

"permission": {
    "scope.userlocation": {  // 位置相关权限声明
      "desc": "你的位置信息将用于小程序位置接口的效果展示" // 高速公路行驶持续后台定位
    }
  },

8. style

微信小程序基础组件样式升级

"style": "v2",

完整app.json文件

{
    "pages": [
        "pages/news/news",
        "pages/index/index",
        "pages/movie/movie",
        "pages/logs/logs"
    ],
    "window": {
        "backgroundtextstyle": "light",
        "navigationbarbackgroundcolor": "white",
        "navigationbartitletext": "哈哈",
        "navigationbartextstyle": "black",
        "navigationstyle": "custom",
        "backgroundcolor": "#ffffff"
    },
    "tabbar": {
        "color": "#000",
        "borderstyle": "black",
        "selectedcolor": "#ff6600",
        "position": "bottom",
        "custom": "false",
        "list": [
            {
                "pagepath": "pages/news/news",
                "text": "新闻",
                "iconpath": "pages/images/yuedu.png",
                "selectediconpath": "pages/images/193.jpg"
            },
            {
                "pagepath": "pages/movie/movie",
                "text": "电影",
                "iconpath": "pages/images/diany.png",
                "selectediconpath": "pages/images/506.jpg"
            }
        ]
    },
 
    "networktimeout": {
        "request": 6000, 
        "downloadfile": 60000, 
        "connectsocket": 60000 ,
        "uploadfile": 60000 
    },
    "debug": true,
    "requiredbackgroundmodes": [
        "audio",
        "location"
    ],
    "permission": {
        "scope.userlocation": { 
            "desc": "你的位置信息将用于小程序位置接口的效果展示" 
        }
    },
    "style": "v2"
}

易优小程序（企业版）灵活api 前后代码开源码云仓库:

本文地址：https://www.eyoucms.com/wxmini/doc/course/27089.html 如需定制请联系易优客服咨询：800182392