IT数码 购物 网址 头条 软件 日历 阅读 图书馆
TxT小说阅读器
↓语音阅读,小说下载,古典文学↓
图片批量下载器
↓批量下载图片,美女图库↓
图片自动播放器
↓图片自动播放器↓
一键清除垃圾
↓轻轻一点,清除系统垃圾↓
开发: C++知识库 Java知识库 JavaScript Python PHP知识库 人工智能 区块链 大数据 移动开发 嵌入式 开发工具 数据结构与算法 开发测试 游戏开发 网络协议 系统运维
教程: HTML教程 CSS教程 JavaScript教程 Go语言教程 JQuery教程 VUE教程 VUE3教程 Bootstrap教程 SQL数据库教程 C语言教程 C++教程 Java教程 Python教程 Python3教程 C#教程
数码: 电脑 笔记本 显卡 显示器 固态硬盘 硬盘 耳机 手机 iphone vivo oppo 小米 华为 单反 装机 图拉丁
 
   -> 移动开发 -> 小程序的全局配置 app.json -> 正文阅读

[移动开发]小程序的全局配置 app.json

  • entryPagePath,指定小程序的默认启动路径(首页),常见情景是从微信聊天列表页下拉启动、小程序列表启动等,如果不填,将默认为pages列表的第一项,不支持带页面路径参数
app.json
{
	"entryPagePath":"pages/index/index"
}
  • pages 用于指定小程序由哪些页面组成,每一项都对应一个页面的路径(含文件名)信息。文件名不需要写文件后缀,框架会自动去寻找对应位置的.json,.js,.wxml,.wxss四个文件进行处理,未指定entryPagePath时,数组的第一项代表小程序的初始页面(首页)
    小程序中新增/减少页面,都需要对pages数组进行修改
    如开发目录为:
    在这里插入图片描述
    则需要在app.json中写:
app.json
{
	"pages":[
		"pages/index/index",
		"pages/logs/logs"
	]
}
  • window,用于设置小程序的状态栏、导航条、标题、窗口背景色
app.json
{
	"navigationBarBackgroundColor":"#000",     //导航栏背景颜色
	"navigationBarTextStyle":"white",          //导航栏标题颜色,仅支持black/white
	"navigationBarTitleText":"title",          //导航栏标题文字内容
	"navigationStyle":"default",               //导航栏样式,仅支持default(默认样式)/custom(自定义导航栏,只保留右上角胶囊按钮)
	"backgroundColor":"#000",                  //窗口的背景色,即窗体下拉刷新或上拉加载时露出的背景颜色
	"backgroundTextStyle":"dark",              //下拉loading的样式,仅支持dark/light
	"backgroundColorTop":"#ffffff",            //顶部窗口的背景色,仅iOS支持
 	"backgroundColorBottom":"#ffffff",         //底部窗口的背景色,仅iOS支持
	"enablePullDownRefresh":"false",           //是否开启全局的下拉刷新
	"onReachBottomDistance":"50",              //页面上拉触底事件触发时距页面底部距离,单位为px
	"pageOrientation":"portrait"               //屏幕旋转设置,支持auto/portrait/landscape
}
  • tabBar,如果小程序是一个多 tab 应用(客户端窗口的底部或顶部有 tab 栏可以切换页面),可以通过 tabBar 配置项指定 tab 栏的表现,以及 tab 切换时显示的对应页面。
app.json
{
	"tabBar":
		{
			"color":'#000',           //tab文字默认颜色
			"selectedColor":'#fff',   //tab文字被选中时的颜色
			"backgroundColor":'#fff',      //tab的背景颜色
			"borderStyle":"black",         //tabbar上边框的颜色,仅支持black/white
			"position":"bottom",           //tabBar的位置,仅支持bottom/top
			"custom":false,                //是否自定义tabBar
			//list接受一个数组,只能配置最少2个,最多5个tab,tab按数组的顺序排序,每个项都是一个对象
			"list":[
				{
					"pagePath":"",    //页面路径,必须在pages中先定义
					"text":"",        //tab上按钮文字
					"iconPath":"",    //图片路径,icon大小限制为40kb,建议尺寸为81*81
					"selectedIconPath":"",   //选中时的图片路径
				}
			]
		}
}
  • networkTimeout,各类网络请求的超时时间,单位均为毫秒
app.json
{
	"newworkTimeout":{
		"request":6000,     //wx.request的超时时间
		"connectSocker":6000,   //wx.connectSocket的超时时间
		"uploadFile":6000,      //wx.uploadFile的超时时间
		"downloadFile":6000     //wx.downloadFile的超时时间
	}
}
  • debug,可以在开发者工具中开启debug模式,在开发者工具的控制台面板,调试信息以info的形式给出,其信息有Page的注册,页面路由,数据更新,事件触发等。可以帮助开发者快速定位一些常见的问题
{
	"debug":true
}
  • functionlPages,插件所有者小程序需要设置这一项来启用插件功能页

  • subpackages,启用分包加载时,声明项目分包结构

  • workers,使用worker处理多线程任务时,设置worker代码放置目录

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

{
	"pages":["pages/index/index"],
	"requiredBackgroundModes":["audio","location"]
	//在此处申明了后台运行的接口,开发版和体验版上可以直接生效,正式版还需通过审核
}
  • plugins,声明小程序需要使用的插件

  • preloadRule,声明分包预下载的规则

  • resizable,在 iPad 上运行的小程序可以设置支持屏幕旋转。在 PC 上运行的小程序,用户可以按照任意比例拖动窗口大小,也可以在小程序菜单中最大化窗口

  • usingComponents,在此处声明的自定义组件视为全局自定义组件,在小程序内的页面或自定义组件中可以直接使用而无需再声明

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

scope.userLocation       //位置相关权限声明
  • permissionObject 结构
desc     //小程序获取权限时展示的接口用途说明,最长30个字符

app.json
{
	"pages":["pages/index/index"],
	"permission":{
		"scope.userLocation":{
			"desc":"你的位置信息将用于小程序位置接口的效果展示"
		}
	}
}
  • sitemapLocation,指明 sitemap.json 的位置;默认为’sitemap.json’即在app.json同级目录下名字的sitemap.json文件

  • style,微信客户端 7.0 开始,UI 界面进行了大改版。小程序也进行了基础组件的样式升级。app.json 中配置 “style”: "v2"可表明启用新版的组件样式。

  • useExtendedLib,指定需要引用的扩展库,目前支持以下项目:
    kbone:多端开发框架
    weui:WeUI组件库
    指定后,相当于引入了对应扩展库相关的最新版本的npm包,同时也不占用小程序的包体积

app.json
{
	"useExtendedLib":{
		"kbone":true,
		"weui":true
	}
}
  • entranceDeclare,聊天位置消息用打车类小程序打开
{
	"entranceDeclare":{
		"locationMessage":{
			"path":"pages/index/index",
			"query":"foo=bar"
		}
	}
}
  • darkmode,微信iOS客户端 7.0.12 版本、Android客户端 7.0.13 版本正式支持 DarkMode,可通过配置"darkmode": true表示当前小程序可适配 DarkMode,所有基础组件均会根据系统主题展示不同的默认样式,navigation bar 和 tab bar 也会根据开发者的配置自动切换。配置后,请根据DarkMode 适配指南自行完成基础样式以外的适配工作。
{
	"darkmode":true
}
  • themeLocation,自定义theme.json的路径,当配置"darkmode":true时,当前配置文件为必填项
{
	"themeLocation":"/path/to/theme.json"
}
  • lazyCodeloading,目前仅支持值requiredComponents,代表开启小程序 [ 按需注入 ] 特性
{
	"lazyCodeLoading":"requiredComponents"
}
  • singlePage,单页模式相关配置
{
	"navigationBarFit":"float"
	//导航栏与页面的相交状态,值为float时表示导航栏浮在页面上,与页面相交;值为squeezed时表示页面被导航栏挤压,与页面不相交
}
  • restartStrategy,重新启动策略配置
homePage         //如果从这个页面退出小程序,下次将从首页冷启动
homePageAndLatestPage  
//如果从这个页面退出小程序,下次冷启动后立刻加载这个页面,页面的参数保持不变(不可用于tab页)
  移动开发 最新文章
Vue3装载axios和element-ui
android adb cmd
【xcode】Xcode常用快捷键与技巧
Android开发中的线程池使用
Java 和 Android 的 Base64
Android 测试文字编码格式
微信小程序支付
安卓权限记录
知乎之自动养号
【Android Jetpack】DataStore
上一篇文章      下一篇文章      查看所有文章
加:2021-09-09 11:53:22  更:2021-09-09 11:55:01 
 
开发: C++知识库 Java知识库 JavaScript Python PHP知识库 人工智能 区块链 大数据 移动开发 嵌入式 开发工具 数据结构与算法 开发测试 游戏开发 网络协议 系统运维
教程: HTML教程 CSS教程 JavaScript教程 Go语言教程 JQuery教程 VUE教程 VUE3教程 Bootstrap教程 SQL数据库教程 C语言教程 C++教程 Java教程 Python教程 Python3教程 C#教程
数码: 电脑 笔记本 显卡 显示器 固态硬盘 硬盘 耳机 手机 iphone vivo oppo 小米 华为 单反 装机 图拉丁

360图书馆 购物 三丰科技 阅读网 日历 万年历 2024年11日历 -2024/11/23 17:13:04-

图片自动播放器
↓图片自动播放器↓
TxT小说阅读器
↓语音阅读,小说下载,古典文学↓
一键清除垃圾
↓轻轻一点,清除系统垃圾↓
图片批量下载器
↓批量下载图片,美女图库↓
  网站联系: qq:121756557 email:121756557@qq.com  IT数码