【微信小程序】深入学习小程序基本目录文件与代码结构

0️⃣写在前面

小程序框架的⽬标是通过尽可能简单、⾼效的⽅式让开发者可以在微信中开发具有原⽣APP体验的服务。

⼩程序框架提供了⾃⼰的视图层描述语⾔ WXML 和 WXSS ，以及 JavaScript ，并在视图层与逻辑层间提供了数据传输和事件系统，让开发者能够专注于数据与逻辑。

---

---

1️⃣小程序代码的构成

①项目结构

• pages 用来存放所有小程序的页面
• utils 用来存放工具性质的模块（例如：格式化时间的自定义模块）
• app.js 小程序项目的入口文件
• app.json 小程序项目的全局配置文件
• app.wxss 小程序项目的全局样式文件
• *project.config.json` 项目的配置文件
• sitemap.json 用来配置小程序及其页面是否允许被微信索引

小程序官方建议把所有小程序的页面，都存放在 pages 目录中，以单独的文件夹存在，如图所示：

其中，每个页面由 4 个基本文件组成，它们分别是：

• .js 文件（页面的脚本文件，存放页面的数据、事件处理函数等）
• .json 文件（当前页面的配置文件，配置窗口的外观、表现等）
• .wxml 文件（页面的模板结构文件）
• .wxss文件（当前页面的样式表文件）

②JSON配置文件

JSON 是一种数据格式，在实际开发中，JSON 总是以配置文件的形式出现。小程序项目中也不例外：通过不同的 .json 配置文件，可以对小程序项目进行不同级别的配置。小程序中共有四种json配置文件：

1. app.jison 文件

app.json 是当前小程序的全局配置，包括了小程序的所有页面路径、窗口外观、界面表现、底部 tab 等。

作用：

• pages：用来记录当前小程序所有页面的路径
• window：全局定义小程序所有页面的背景色、文字颜色等
• style：全局定义小程序组件所使用的样式版本
• sitemapLocation：用来指明 sitemap.json 的位置

2. project.config.json 文件

project.config.json 是项目配置文件，用来记录我们对小程序开发工具所做的个性化配置。

其中：

• setting 中保存了编译相关的配置
• projectname 中保存的是项目名称
• appid 中保存的是小程序的账号 ID

3. sitemap.json 文件

微信现已开放小程序内搜索，效果类似于 PC 网页的 SEO。sitemap.json 文件用来配置小程序页面是否允许微信索引。当开发者允许微信索引时，微信会通过爬虫的形式，为小程序的页面内容建立索引。当用户的搜索关键字和页面的索引匹配成功的时候，小程序的页面将可能展示在搜索结果中。

4. 页面的 .json 配置文件

小程序中的每一个页面，可以使用 .json 文件来对本页面的窗口外观进行配置，页面中的配置项会覆盖 app.json 的 window 中相同的配置项。

新建小程序页面 方法：在 app.json -> pages 中新增页面的存放路径，小程序开发者工具即可帮我们自动创建对应的页面文件。

调整项目首页 方法：只需要调整 app.json -> pages 数组中页面路径的前后顺序，即可修改项目的首页。小程序会把排在第一位的页面，当作项目首页进行渲染。

③WXML模板

WXML（WeiXin Markup Language）是小程序框架设计的一套标签语言，用来构建小程序页面的结构，其作用类似于网页开发中的 HTML。

那么，两者有什么不同之处呢？

标签名称不同

• HTML （div, span, img, a）
• WXML（view, text, image, navigator）

属性节点不同

提供了类似于 Vue 中的模板语法

• 数据绑定
• 列表渲染
• 条件渲染

④WXSS样式

WXSS (WeiXin Style Sheets)是一套样式语言，用于描述 WXML 的组件样式，类似于网页开发中的 CSS。

那么，两者有什么不同呢？

新增了 rpx 尺寸单位

• CSS 中需要手动进行像素单位换算，例如 rem
• WXSS 在底层支持新的尺寸单位 rpx，在不同大小的屏幕上小程序会自动进行换算

提供了全局的样式和局部样式

• 项目根目录中的 app.wxss 会作用于所有小程序页面
• 局部页面的 .wxss 样式仅对当前页面生效

WXSS 仅支持部分 CSS 选择器

• .class 和 #id
• element
• 并集选择器、后代选择器
• ::after 和 ::before 等伪类选择器

⑤JS逻辑交互

在小程序中，我们通过 .js 文件来处理用户的操作。例如：响应用户的点击、获取用户的位置等等。

小程序中的 JS 文件分为三大类，分别是：

• app.js
  是整个小程序项目的入口文件，通过调用 App() 函数来启动整个小程序
• 页面的 .js 文件
  是页面的入口文件，通过调用 Page() 函数来创建并运行页面
• 普通的 .js 文件
  是普通的功能模块文件，用来封装公共的函数或属性供页面使用

---

2️⃣小程序框架接口

①App(Object object)

1. 注册小程序。接受一个 Object 参数，其指定小程序的生命周期回调等。

2. App() 必须在 app.js 中调用，必须调用且只能调用一次。不然会出现无法预期的后果

3. 相应的app()参数在下方的小程序生命周期中有指出

②AppObject getApp(Object object)

1. 获取到小程序全局唯一的 App 实例。

2. 代码示例

// other.js
var appInstance = getApp()
console.log(appInstance.globalData) // I am global dat
//或者
const {
    
    GbaseUrl} =getApp()  //GbaseUrl是自己在app.js定义的全局变量

3. Object object

属性	类型	默认值	必填	说明	最低版本
allowDefault	boolean	false	否	在 App 未定义时返回默认实现。当App被调用时，默认实现中定义的属性会被覆盖合并到App中。一般用于独立分包	2.2.4

4. 注意

• 不要在定义于 App() 内的函数中，或调用 App 前调用 getApp() 。使用 this 就可以拿到 app 实例。
• 通过 getApp() 获取实例之后，不要私自调用生命周期函数

---

3️⃣小程序宿主环境的内容

宿主环境（host environment）指的是程序运行所必须的依赖环境。例如：Android 系统和 iOS 系统是两个不同的宿主环境。安卓版的微信 App 是不能在 iOS 环境下运行的。

手机微信是小程序的宿主环境，小程序借助宿主环境提供的能力，可以实现许多普通网页不能完成的功能。例如：小程序调用微信提供的API实现扫码，支付等功能。

小程序的宿主环境包含的内容：

• 通信模型
• 运行机制
• 组件
• API

---