小程序宿主环境

我们称 MiniApp 给小程序所提供的环境为宿主环境。小程序借助宿主环境提供的能力，可以完成许多普通网页无法完成的功能。

上一章中我们把小程序涉及到的文件类型阐述了一遍，我们结合 MiniApp Official Demo 这个项目来讲一下这些文件是怎么配合工作的。

渲染层和逻辑层

首先，我们来简单了解下小程序的运行环境。小程序的运行环境分成渲染层和逻辑层，其中 DLT 模板和 CSS 样式工作在渲染层，JS 脚本工作在逻辑层。

小程序的渲染层和逻辑层分别由 2 个线程管理：渲染层的界面使用了 WebView 进行渲染；逻辑层采用 JsCore 线程运行 JS 脚本。一个小程序存在多个界面，所以渲染层存在多个 WebView 线程，这两个线程的通信会经由客户端（下文中也会采用 Native 来代指客户端）做中转，逻辑层发送网络请求也经由 Native 转发，小程序的通信模型下图所示。

小程序运行架构图

有关渲染层和逻辑层的详细文档参考小程序框架。

程序与页面

客户端在打开小程序之前，会把整个小程序的代码包下载到本地。

紧接着通过 app.json 的 pages 字段就可以知道你当前小程序的所有页面路径:

{
  "pages": ["pages/index/index", "pages/logs/logs"]
}

这个配置说明在 MiniApp Official Demo 项目定义了两个页面，分别位于 pages/index/index 和 pages/logs/logs。而写在 pages 字段的第一个页面就是这个小程序的首页（打开小程序看到的第一个页面）。

于是客户端就把首页的代码装载进来，通过小程序底层的一些机制，就可以渲染出这个首页。

小程序启动之后，在 app.js 定义的 App 实例的 onLaunch 回调会被执行:

App({
  onLaunch: function () {
    // 小程序启动之后 触发
  },
});

整个小程序只有一个 App 实例，是全部页面共享的，更多的事件回调参考文档注册程序 App 。

接下来我们简单看看小程序的一个页面是怎么写的。

你可以观察到 pages/logs/logs 下其实是包括了 4 种文件的，客户端会先根据 logs.json 配置生成一个界面，顶部的颜色和文字你都可以在这个 json 文件里边定义好。紧接着客户端就会装载这个页面的 DLT 结构和 CSS 样式。最后客户端会装载 logs.js，你可以看到 logs.js 的大体内容就是:

Page({
  data: {
    // 参与页面渲染的数据
    logs: [],
  },
  onLoad: function () {
    // 页面渲染后 执行
  },
});

Page 是一个页面构造器，这个构造器就生成了一个页面。在生成页面的时候，小程序框架会把 data 数据和 index.dlt 一起渲染出最终的结构，于是就得到了你看到的小程序的样子。

在渲染完界面之后，页面实例就会收到一个 onLoad 的回调，你可以在这个回调处理你的逻辑。

有关于 Page 构造器更多详细的文档参考注册页面 Page 。

组件

小程序提供了丰富的基础组件给开发者，开发者可以像搭积木一样，组合各种组件拼合成自己的小程序。

就像 HTML 的 div, p 等标签一样，在小程序里边，你只需要在 DLT 写上对应的组件标签名字就可以把该组件显示在界面上，例如，你需要在界面上显示图片，你只需要这样写即可：

<image src="/images/api_normal.png" />

使用组件的时候，还可以通过属性传递值给组件，让组件可以以不同的状态去展现，例如，我们希望图片懒加载，那么你需要声明图片的 data-src（真实图片地址）、lazy-load（是否开启懒加载模式）、src（占位图地址）三个属性:

<image
  data-src="/images/api_normal.png"
  :lazy-load="false"
  src="/images/img_5222.png"
/>

组件的内部行为也会通过事件的形式让开发者可以感知，例如图片加载成功或者失败，你可以在 js 编写 bindload/binderror 函数来处理：

<image
  src="/images/img_5222.png"
  bind:binderror="imageError"
  bind:bindload="imageLoad"
/>

当然你也可以通过 style 或者 class 来控制组件的外层样式，以便适应你的界面宽度高度等等。

API

为了让开发者可以很方便的调起小程序 SDK 提供的能力，例如手机系统信息、本地存储等等，小程序提供了很多 API 给开发者去使用。

要获取用户的地理位置时，只需要：

dlt.getLocation((res) => {
  var latitude = res.latitude; // 纬度
  var longitude = res.longitude; // 经度
});

调用扫一扫能力，只需要：

dlt.scanCode({
  onlyFromCamera: false,
  scanType: "",
  callback: (res) => {
    this.setData({
      scanInfo: res.data,
    });
  },
});

需要注意的是：多数 API 的回调都是异步，你需要处理好代码逻辑的异步问题。

更多的 API 能力见小程序的 API。

通过这个章节你已经大概了解了小程序运行的一些基本概念，当你开发完一个小程序之后，你就需要发布你的小程序。在下个章节，你会知道发布前需要做什么准备。

小程序宿主环境

渲染层和逻辑层​

程序与页面​

组件​

API​

渲染层和逻辑层

程序与页面

组件

API