项目配置与导航栏设置

小程序项目的配置由项目根目录中的 Config.cfg 文件进行管理，在IDE中双击工程窗口中的“项目配置”节点，可在IDE中打开该文件并修改。

温馨提示：该文件属于类JSON格式编写的文本文件，除了在VcnStudio IDE中打开编辑外，也可以使用任意编辑器打开编辑，但我们仍然建议在IDE中编辑修改。

默认配置文件内容：

{
    默认首页: "启动页"
    全局窗口样式: {
        导航栏背景颜色: "#ffffff"
        导航栏文字样式: ""
        导航栏标题: "我的小程序"
        显示首页按钮: 假
        窗口背景颜色: ""
        背景文字样式: ""
        窗口顶部背景色: ""
        窗口底部背景色: ""
        开启下拉刷新: 假
        触发上拉事件距离阀值: 50
        页面旋转方向: ""
        重启策略: ""
        初始渲染缓存: ""
        后台视觉效果: ""
        网页预加载处理: ""
		导航栏样式: {
		    样式值: "default"
			自定义图标: "../../static/logo.png"
			自定义标题: "自定义标题文本"
		}
    }
    底部导航栏: {
        文本默认颜色: ""
        文本选中颜色: ""
        选项背景颜色: ""
        选项边框样式: ""
        导航位置: "bottom"
        导航列表: [
            {
                目标页面:"启动页"
                图标路径:""
                选中图标路径:""
            }
        ]
    }
    网络超时: {
        请求超时: 60000
        Socket连接超时: 60000
        文件上传超时: 60000
        文件下载超时: 60000
    }
	编译输出目录:""
}

以下分别对该文件中的相关节点进行说明：

默认首页
- 设置小程序每次启动时，打开的首页（页面）名称、例如：您的项目中有多个页面、需要将 产品展示 这个页面设置为首页、则设置给值为页面名称即可，例如：默认首页:"产品展示"，默认首页为工程模板预置页面：启动页 ，注意：该参数值不可为空。

全局窗口样式

该节点下方的配置主要影响应用的颜色、风格、以及主题、如果无需特别设置、建议采用默认配置即可、关于每个节点的详细说明请参考：官方文档全局配置 | 微信开放文档

中文与英文的映射关系可查看 安装目录/sdk/wechat/cfg.map.json 该文件。

{
  "默认首页": "entryPagePath",
  "全局窗口样式": "window",
  "底部导航栏": "tabBar",
  "网络超时": "networkTimeout",
  "导航栏背景颜色": "navigationBarBackgroundColor",
  "导航栏文字样式": "navigationBarTextStyle",
  "导航栏标题": "navigationBarTitleText",
  "导航栏样式": "navigationStyle",
  "显示首页按钮": "homeButton",
  "窗口背景颜色": "backgroundColor",
  "背景文字样式": "backgroundTextStyle",
  "窗口顶部背景色": "backgroundColorTop",
  "窗口底部背景色": "backgroundColorBottom",
  "开启下拉刷新": "enablePullDownRefresh",
  "触发上拉事件距离阀值": "onReachBottomDistance",
  "页面旋转方向": "pageOrientation",
  "重启策略": "restartStrategy",
  "初始渲染缓存": "initialRenderingCache",
  "后台视觉效果": "visualEffectInBackground",
  "网页预加载处理": "handleWebviewPreload",
  "文本默认颜色": "color",
  "文本选中颜色": "selectedColor",
  "导航位置": "position",
  "选项背景颜色":"backgroundColor",
  "选项边框样式":"borderStyle",
  "自定义导航栏": "custom",
  "按钮文字": "text",
  "图标路径": "iconPath",
  "选中图标路径": "selectedIconPath",
  "请求超时": "request",
  "Socket 连接超时": "connectSocket",
  "文件上传超时": "uploadFile",
  "文件下载超时": "downloadFile"
}

底部导航栏
- 设置是否显示小程序底部选项卡导航栏、如果 底部导航栏/导航列表 中配置的页面数量大于等于2或小于等于5时，小程序将自动启用并显示底部导航选项卡。
- 基础配置：可设置选项卡标题颜色、背景颜色等等。
- 导航列表：
  - 配置底部每个独立的选项卡信息，其中：
    - 目标页面：设置页面名称。
    - 图标路径：设置选项卡显示的图标文件地址，例如：static/home.png
    - 选中图标路径：点击选项后显示的图标文件地址，例如：static/home_ac.png

注：

暂不支持在配置文件中直接添加自定义配置项、如要添加自定义配置、可以编译输出为友好源代码后，在生成的微信小程序标准源码工程中的 app.json 文件中添加。

除额外特别说明外，配置中的颜色值格式均为十六进制文本颜色或小程序支持的内置颜色名，不支持整数型颜色值。

配置中的逻辑参数值，真(true)、假(false)

配置项参数值若为空字符串，编译时将被忽略，表示该项使用默认配置值。

VcnStudio开发帮助文档

项目配置与导航栏设置