Skip to content

新建项目和项目整体配置

开发者工具界面

打开微信开发者工具先扫码登陆

2-1

由于我们开发的是小程序 这里选择小程序 点击 + 号创建一个小程序项目

2-2

接着选择项目保存路径,尽量放在自己能找到的地方 采用英文名

Appleid 这里需要上线的话选择注册,会跳转到注册连链接(需要认证费用) 如果不是打算上线的话选择测试号即可,这里我们选择测试

后端服务选择 不使用云服务

模板选择 JavaScript-基础模板

2-3

然后点击确定就创建项目完成了

微信开发者工具结构配置介绍

2-4

文件结构

一个小程序包含一个描述整体程序的 app 和多个描述各个页面的 pages。 一个小程序主体由三个文件组成,必须放在项目的根目录下:

  • app.js:小程序逻辑文件
  • app.json: 小程序公共设置(主体配置文件)
  • app.wxss:小程序公共样式表(全局样式) (可以删除)

一个小程序 page 页面由四个文件组成,分别是:

  • js:页面逻辑
  • wxml:页面结构
  • wxss:页面样式(可以删除)
  • json:页面配置(可以删除)

utils:工具目录(可以删除),实现了模块化工具类,工具函数。 sitemap.json:小程序搜索所用。 project.config.json:编辑器配置。

小程序配置 app.json

app.json 文件用来对小程序进行全局配置,决定小程序的页面数量、窗口表现、设置网络超时时间、设置底部或顶部菜单等。

app.json 中不能添加任何注释,key 和 value 字符串必须用双引号引起来,数组或对象最后一位不能有逗号。

app.json 配置项列表

2-5

pages

json
"pages": [
  "pages/index/index",  // 数组第一项,小程序的初始页面。
  "pages/logs/logs"
],

pages 指定由哪些页面组成,每一项代表对应页面【路径+目录名+文件名】。

pages 数组的第一项代表小程序的初始页面(首页/展示页)。

小程序中新增/减少页面,都需要对 pages 数组进行修改 。

window

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

json
"window": {
  "enablePullDownRefresh": true, //是否开启开启全局的下拉刷新 true 开启,false 关闭。
  "backgroundColor":" #ccc", //窗口的背景色
  "backgroundTextStyle":"light", //下拉 loading 的样式,仅支持 dark 和 light
  "navigationBarBackgroundColor": "#fff", //导航栏背景色
  "navigationBarTitleText": "Weixin", //导航栏标题文字内容
  "navigationBarTextStyle":"black", //导航栏标题颜色,仅支持白色(white)和黑色(black)
  "navigationStyle":"custom" //去除导航栏
},

tabBar

设置小程序的底部或顶部菜单栏。

注释:当设置 position 为 top 时,将不会显示 icon 图标。

当 tabBar 中的 list 是一个数组,只能配置最少 2 个、最多 5 个菜单。

json
"tabBar": {
  "color": "#999", //tab上文字默认颜色,仅支持十六进制颜色
  "selectedColor": "", //tab 上的文字选中时的颜色,仅支持十六进制颜色
  "backgroundColor": "", //tab 的背景色,仅支持十六进制颜色
  "position": "bottom", //tabBar 的位置,仅支持 bottom / top
  "borderStyle": "black", //tabbar 上边框的颜色, 仅支持 black / white
  "list": [
    {
      "pagePath": "pagePath", //页面路径
      "text": "text", //页面文字
      "iconPath": "iconPath", //默认图标路径
      "selectedIconPath": "selectedIconPath" //选中图标路径
    },
    {
      "pagePath": "pagePath", //页面路径
      "text": "text", //页面文字
      "iconPath": "iconPath", //默认图标路径
      "selectedIconPath": "selectedIconPath" //选中图标路径
    }
  ]
},

networkTimeout

可以设置各种网络请求的超时时间,单位毫秒。

json
"networkTimeout": {
  "request": 10000 //发起HTTP请求的超时时间 10s   (一般设置5s:5000毫秒)
},

powered by 天人之际工作室