小程序开发笔记1

2021/8/19 20:36:00

本文主要是介绍小程序开发笔记1,对大家解决编程问题具有一定的参考价值,需要的程序猿们随着小编来一起学习吧!

小程序的配置

全局配置

小程序根目录下 app.json 文件对小程序进行全局配置


属性 类型 必填 描述 最低版本
entryPagePath string n 设置默认启动首页页面路径
pages string[] y 页面路径列表
window Object n 全局默认窗口样式
tabBar Object n 底部tab栏样式
networkTimeout Object n 网络超时时间
debug boolean n 是否开启debug模式
functionalPages boolean n 开启插件功能页功能 2.1.0
subpackages Object[] n 分包结构配置 1.7.3
分包加载

微信客户端 6.6.0,基础库 1.7.3 及以上版本开始支持。

将小程序划分成不同的子包,在构建时打包成不同的分包,用户在使用时按需进行加载。

构建小程序分包项目时,构建会输出一个或多个分包。每个使用分包小程序必定含有一个主包。所谓的主包,即放置默认启动页面/TabBar 页面,以及一些所有分包都需用到公共资源/JS 脚本的包;而分包则是根据开发者的配置进行划分。

    在小程序启动时,默认会下载主包并启动主包内页面,当用户进入分包内某个页面时,
        客户端会把对应分包下载下来,下载完成后再进行展示。

目前小程序分包大小有以下限制:

  • 整个小程序所有分包大小不超过 20M
  • 单个分包/主包大小不能超过 2M
  • 对小程序进行分包,可以优化小程序首次启动的下载时间,以及在多团队共同开发时可以更好的解耦协作。
分包配置
文件结构:
├── app.js
├── app.json
├── app.wxss
├── packageA
│   └── pages
│       ├── cat
│       └── dog
├── packageB
│   └── pages
│       ├── apple
│       └── banana
├── pages
│   ├── index
│   └── logs
└── utils
packageA 无法 require packageB JS 文件,但可以 require app、自己 package 内的 JS 文件;
          使用 分包异步化 时不受此条限制
packageA 无法 import packageB 的 template,但可以 require app、自己 package 内的 template
packageA 无法使用 packageB 的资源,但可以使用 app、自己 package 内的资源

对应的app.json中的subpackages字段的配置:

{
  "pages":[
    "pages/index",
    "pages/logs"
  ],
  
  "subpackages": [
    {
      "root": "packageA",
      "pages": [
        "pages/cat",
        "pages/dog"
      ]
    }, {
      "root": "packageB",
      "name": "pack2",
      "pages": [
        "pages/apple",
        "pages/banana"
      ]
    }
  ]
  
}
    每个分包中的配置:
{
      "root": "packageB",//声明该分包的根目录名
      "name": "pack2",//设置分包的别名,**分包预下载**时使用
      "pages": [   // 分包的页面路径,相对于分包的根目录
        "pages/apple",
        "pages/banana"
      ]
      independent: true,//是否是**独立分包**:不依赖于主页面,可以单独运行
    }
    **分包预下载**
        预下载分包行为在进入某个页面时触发,通过在 app.json 增加 preloadRule 配置来控制。
{
  "pages": ["pages/index"],
  "subpackages": [
    {
      "root": "important",
      "pages": ["index"],
    },
    {
      "root": "sub1",
      "pages": ["index"],
    },
    {
      "name": "hello",
      "root": "path/to",
      "pages": ["index"]
    },
    {
      "root": "sub3",
      "pages": ["index"]
    },
    {
      "root": "indep",
      "pages": ["index"],
      "independent": true
    }
  ],
  "preloadRule": {
    "pages/index"//页面路径: {
      "network": "all",//all:不限制网络环境;wifi: 仅在wifi下预下载
      "packages": ["important"]//进入页面后对应预下载的分包root或name值;特殊:__APP__ 表示主包
    }//预下载配置
    限制
同一个分包中的页面享有共同的预下载大小限额 2M,限额会在工具中打包时校验。
如,页面 A 和 B 都在同一个分包中,A 中预下载总大小 0.5M 的分包,
B中最多只能预下载总大小 1.5M 的分包。
    ,
    "sub1/index": {
      "packages": ["hello", "sub3"]
    },
    "sub3/index": {
      "packages": ["path/to"]
    },
    "indep/index": {
      "packages": ["__APP__"]
    }
  }
}
preloadRule 中,key 是页面路径,value 是进入此页面的预下载配置,每个配置有以下几项

    **独立分包**
    限制:1、独立分包中不能依赖主包和其他分包中的文件和样式。2、不能定义App。3、不支持使用插件
    4、基础库 2.2.4 版本开始 getApp 支持 [allowDefault] 参数,在 App 未定义时返回一个默认实现。
    当主包加载,App 被注册时,默认实现中定义的属性会被覆盖合并到真正的 App 中。
    如:
    const app = getApp({allowDefault: true}) // {}
    于独立分包中无法定义 App,小程序生命周期的监听可以使用 wx.onAppShow,wx.onAppHide 完成。
    App 上的其他事件可以使用 wx.onError,wx.onPageNotFound 监听。
    在低于 6.7.2 版本的微信中运行时,独立分包视为普通分包处理,不具备独立运行的特性。
属性 类型 必填 描述 最低版本
workers string n Worker代码放置的目录 1.9.90
requiredBackgroundModes string[] n 需要在后台使用的能力【后台音乐、定位】
plugins Object n 使用到的插件 1.9.6
resizable boolean n 是否允许pc小程序改变窗口大小或ipad旋转屏幕 2.3.0
workers

使用Worker做多线程任务时设置Worker代码放置的目录

属性 类型 必填 描述 最低版本
usingComponents Object n 在组件的json文件中声明是否为组件 开发1.02.1810190


这篇关于小程序开发笔记1的文章就介绍到这儿,希望我们推荐的文章对大家有所帮助,也希望大家多多支持为之网!


扫一扫关注最新编程教程