微信小程序（上）

注册开发者账号： https://mp.weixin.qq.com/

安装小程序开发工具：https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html

创建项目

pages目录：用于存放所有的页面。

utils目录：用于存放工具类文件。

app.js：是入口文件，程序在运行时，首先要执行该文件。

app.json：是全局配置文件，用于配置小程序的信息（它里面配置的是全局信息）。

app.wxss：是全局样式文件。全局样式文件里面定义的选择器，在所有的页面中生效。

project.config.json：是项目配置文件。

sitemap.json：是SEO配置文件，方便用户搜索到该小程序。

（1）pages配置项

pages里面注册的是视图。用于指定小程序由哪些页面组成，每一项都对应一个页面的路径（含文件名）信息

（2）window配置项

window 是全局窗口配置。

backgroundTextStyle 设置文本样式（下拉loading的样式），仅支持 dark / light。

navigationBarBackgroundColor 设置导航栏背景。

navigationBarTitleText 设置导航栏文本。

navigationBarTextStyle 设置导航栏标题颜色，仅支持 black / white。

（3）style

style 设置样式级别，默认是v2。

（4）sitemapLocation

sitemapLocation 指明sitemap.json 的位置；默认为 'sitemap.json' 即在 app.json 同级目录下名字的 sitemap.json 文件。

每一个页面由四个文件组成：xxx.wxml文件、xxx.wxss文件、 xxx.js文件和xxx.json文件。

（1）xxx.wxml文件

xxx.wxml文件，就相当于一个html文件。在wxml文件中，不能写传统的html标签，只能写微信提供的组件。

① view组件

相当于div标签。

② text组件

相当于span标签。

③ swiper

swiper是滑块视图容器，它里面只能放swiper-item组件。

swiper组件的常用属性：

circular是衔接滑动

autoplay是自动切换

interval是自动切换时间间隔

indicator-dots是否显示面板指示点

indicator-color指示点颜色

indicator-active-color当前选中的指示点颜色

④ image

image是图片组件，最好全部采用网络图片，因为小程序的总体积不允许超过2MB。

（2）xxx.wxss文件

xxx.wxss文件，就相当于一个css文件。在wxss文件中，最好不要写标签选择器和id选择器，统一写类选择器。

为了让小程序里面的内容在各种设备上能够自适应显示，微信推出了响应式单位：rpx。在iphone6中，2rpx=1px。

（3）xxx.js文件

xxx.js文件，是交互文件（核心文件）。

Page()函数，返回页面对象，该函数需要传一个配置参数，这个配置参数是一个对象。在这个配置对象中，定义当前页面的所有内容。

① data

定义页面的数据。

② 自定义函数

开发者可以添加任意的函数或数据到Object 参数中，在页面的函数中用this可以访问。

（4）xxx.json文件

xxx.json文件，是页面的配置文件（它里面配置的是当前页面信息）。

WXML 中的动态数据均来自对应 Page 的 data。

（1）获取data中数据

通过插值表达式{{}}，可以显示js里面定义的data里面的数据。

（2）组件属性(需要在双引号之内)

（3）运算

可以在{{}} 内进行简单的运算。

① 三元运算

② 逻辑判断

bindtap是触屏事件，其实就是相当于网页中的点击事件。

小程序中bindtap绑定方法时不能传参数。所以组件通过data-xxx传递数据。

注意： 自定义属性的命名用驼峰或者大写命名，小程序内部会自动转成小写。

8、setData()方法

setData()方法，更新页面中数据。页面数据更新后，调用setData()方法重新渲染到页面。

wx:for指令用于循环数组数据，生成组件。

循环出来的每一项通过item返回，每一项对应的索引，通过index返回。

wx:key=""，设置每一项唯一的标识。循环列表时，添加wx:key的好处是，将来列表发生变化时重新渲染列表的损耗为更低。

条件渲染可以使用wx:if或hidden。

一般来说，wx:if 有更高的切换消耗而 hidden 有更高的初始渲染消耗。因此，如果需要频繁切换的情景下，用 hidden 更好，如果在运行时条件不大可能改变则 wx:if 较好。

wx:if用于条件渲染：条件为真生成里面的内容，条件为假不会生成里面的内容。（每次重新生成内容）

也可以用wx:elif 和 wx:else 来添加一个 else 块。

hidden用于条件渲染：条件为真隐藏里面的内容，条件为假显示里面的内容。（每次切换样式）

在app.json文件中添加tabBar节点。tabBar是小程序客户端底部或顶部tab栏的实现。

color：tab上的文字默认颜色，仅支持十六进制颜色。

selectedColor：tab上的文字选中时的颜色，仅支持十六进制颜色。

backgroundColor：tab的背景色，仅支持十六进制颜色。

borderStyle：tabbar上边框的颜色， 仅支持 black / white。

position：tabBar的位置，默认值是: bottom，仅支持 bottom / top。当 position 为 top 时，不显示 icon。

custom：自定义tabBar。

（2）list

list：tab的列表。

list 接受一个数组，只能配置最少 2 个、最多 5 个 tab。

pagePath：页面路径，必须在pages 中先定义。

text：tab 上按钮文字。

iconPath：图片路径，icon 大小限制为 40kb，建议尺寸为 81px * 81px，不支持网络图片。selectedIconPath：选中时的图片路径，icon 大小限制为 40kb，建议尺寸为 81px * 81px，不支持网络图片。

（1）跳转普通页面

方法① navigator组件

方法② navigateTo()方法

navigateTo()方法，用于跳转普通页面。

（2）跳转tabBar页面

方法① navigator组件

如果要使用navigator组件跳转tabBar页面，需要设置open-type="switchTab"。

方法② switchTab()方法

switchTab()方法，用于跳转tabBar页面。

title：提示的标题

content：提示的内容

success：接口调用成功的回调函数。回调函数中的confirm属性返回true，表示点击的是确定按钮，否则是取消按钮。

title：提示的内容

icon：图标

duration：消息提示框的显示时间

mask：是否显示透明蒙层，防止触摸穿透

模块化语法有两种：① commonjs规范，② es6规范。

nodejs环境采用的就是commonjs规范。采用exports 或 module.exports 导出成员，采用require() 导入成员。

微信小程序支持commonjs规范，同时还支持官方的ES6规范。ES6规范采用export 导出成员，采用import 导入成员。

将封装的方法放到util目录下的js文件中。可以新建js文件，也可以写在直接util.js文件中。

（1）确认框方法

定义确认框方法，并导出

（2）消息框方法

定义消息框方法，并导出

（3）获取事件参数的方法

import是ES6的导入语句。

wx对象是微信小程序的全局对象，在任何地方都可以使用。

（1） 注册语句

（2） 在app.js入口文件中导入

注意： 注册给wx对象的方法，需要在app.js文件中导入，才可使用。

（3） 调用方法

wx.方法名(参数)

分包目的在于提高小程序的体积，多一个包就多2M，最多20M

常规的分包：

小程序一打开首先加载主包，然后再加载分包

分包可以用主包内的资源，主包不可以使用分包的资源

分包A不可以使用分包B里面的内容

分包可以使用app.wxss里面的全局样式

分包步骤如下：

1.在微信小程序开发者工具里面打开在app.json中添加如下字段

root：是包的名称，pages：是添加的路径，independent：是设置独立分包

2.独立分包：

会在主包加载之前调用

独立分包属于分包的一种。普通分包的所有限制都对独立分包有效

主包中的app.wxss对独立分包无效，应避免在独立分包页面中使用 app.wxss 中的样式

给packageB设置成独立分包

微信小程序近期可谓是动作频出，仅最近新增的能力就有：

种种迹象表明，微信对小程序的期望值是很大，所以在它推出的几个月效果没到达预期的情况下，之前的很多『克制』也就逐渐变成『放肆』了 —— 不过不管小程序以后的发展到底怎样，对我们开发者来发，多了解一些总是没有坏处的。

他山之石，可以攻玉。

对于是技术人来说，多了解一些不同的技术、不同的开发模式、不同的架构思想，提高技术『广度』，对于自己的成长是十分必要的。

所以，本文就是从一个 Android 开发者的角度，从项目工程方便切入，来分析一下『微信小程序』跟『Android App』开发上的一些异同。

『微信小程序』开发是一个相对较新的技术，希望通过本文，能让你对它多一些了解。

因为内容是从Android开发的角度来谈的，所以我假设你已经对 Android 开发比较熟悉了。并且对微信小程序的开发也比较感兴趣，如果要是再能有些 javascript、css 的基础的话那就更好了！

Android 开发我们已经比较熟悉——

作为对比，进行微信小程序开发所用的语言是这些——

wxml (WeiXin Markup Language) 基本约等于是 xml。微信之所以没有直接使用 xml ，可能是为了以后扩展方便一些（野心很大）。

同理， wxss (WeiXin Style Sheets) 基本约等于是 css。也是微信扩展了一些功能，比如统一的尺寸单位 rpx 。

对于 Android 来说，对于页面的描述基本上在 xml 中定义的，比如：

这是一个简单的典型的示例，这个文件就是描述了两部分内容：

some.wxss:

很明显可以看出：wxml 是负责了 页面结构 的展示；而 wxss 则负责了对 页面样式 的定义。

这种把结构和样式分离的做法，其实是延续了网页开发中的习惯（html + css）。

这样做的好处起码有两个：

——看起来还是挺简单的结构:

这三个文件用以描述小程序 app 相关的内容，他们的命名是固定这样的，位置也固定是在根目录下。

app.js 基本相当于 Android 中的 Application 类，文件中主要是有一个 App() 函数，来进行小程序的初始化 *** 作。

app.json 的作用跟 Android 中的 AndroidMainifest.xml 文件很相似 —— 都是静态化的配置文件。

app.wxss 定义全局的样式 —— 其定义的样式会作用于每个页面。比如在 app.wxss 中加入：

就可以给所有的 text 控件添加 5px 的 padding 。

当然，页面本身的 xxPage.wxss 可以定义局部样式来覆盖全局样式。

根目录下的 utils 文件夹中有一个 util.js 文件，这个故名思意，是类似于 Java 中的一些工具类的存在。

utils 文件夹其实是一个非必须的结构，而它之所以出现在官方的 HelloWorld 工程中，是作为一个代表，表明了开发者在这里是可以自定义新的文件夹和结构的。微信小程序作为一个使用 js 来开发的平台，是可以使用许多第三方的 js 库的，对于这些第三方库，以及其他的图片资源等，都可以放到自定义的文件夹中。

pages 文件夹下包含两个子目录：index 和 logs ，两个目录的结构都是基本一样的，都是包含四个相同主名称的文件： xx.js、xx.wxml、xx.json、xx.wxss 这几个文件。

这样的一个典型结构表明它是一个小程序的页面，四个文件的作用分别是：

在视图的动态显示上，微信小程序使用了 数据绑定（data-binding） 的方式。

如果你之前使用过 AngularJS 或者 Vue.js 等这些流行的 js 框架，那么你肯定对 数据绑定 并不陌生。它是一种把一个控件的属性绑定到某个数据对象（view-model）的属性的方法，这样在改变数据对象属性的时候，所对应的控件属性也就会相应变化 —— 在开发中，这种方式会使得对 View 层的显示控制变得十分简单、自然。

基于此，软件工程的流行架构方式也在之前的 MVC 、 MVP 之外，又多了一个 —— MVVM（Model-View-ViewModel） 。

数据绑定 这种方式现在是如此的流行，以致于 Android 官方都出了一个 [Data Binding Library] ( https://developer.android.com/topic/libraries/data-binding/index.html ) 来支持数据绑定，但是由于成熟度等原因，目前还并没有成为主流，Android 中的主流视图显示方式，还是通过开发者手动给每个控件 set 数据。

—— 单从这一点上看，微信小程序的开发模式是比原生 Andorid 要『先进』一些的~