目录
开始
开发小程序的第一步,你需要拥有一个小程序帐号,通过这个帐号你就可以管理你的小程序。
如果是第一次做微信小程序,你需要注册一个小程序开发账号。如果已经有小程序开发账号,直接使用浏览器打开https://mp.weixin.qq.com/网址扫码登录。
一、注册一个小程序开发账号
1.申请帐号
使用浏览器打开https://mp.weixin.qq.com/网址,点击右上角的“立即注册”即可进入到小程序开发账号的注册流程。
2.选择注册账号的类型
3.按照流程填写账号信息
信息登记,就可以拥有自己的小程序帐号。
4.获取小程序的APPID
扫码登录进入到 小程序后台 ,我们可以在菜单 “开发”-“开发设置” 看到小程序的 AppID 了 。
5.添加项目成员和体检成员
(1)打开https://mp.weixin.qq.com/网址,扫码进入微信官方文档
(2)点击管理模块中的成员管理,点击下拉箭头,添加成员
二、微信开发者工具
1.了解微信开发者工具
微信开发者工具是官方推荐使用的小程序开发工具,它提供的主要功能如下:
1.快速创建小程序项目
2.代码的查看和编辑
3.对小程序功能进行调试
4.小程序的预览和发布
2.下载并安装
推荐下载和安装最新的稳定版(Stable Build)的微信开发者工具,下载页面的链接如下:
https://developers.weixin.qq.com/miniprogram/dev/devtools/stable.html
3.有关微信开发者工具的几个功能
(1)查看项目效果:点击编译进行查看
(2)在手机上查看项目效果:点击预览会生成二维码,扫描二维码进行查看
(3)查看微信官方文档:点击帮助中的开发者文档,可直接跳转到微信官方文档
(4)查看不同型号:点击机型,可以调整不同的手机型号。也可以调整显示比例和字体大小
(5)自定义编译
在开发页面的过程中,重新编译完成后,页面都会显示到主页,如果要调试其它页面会很不方便,配置自定义编译,重新编译后,页面会显示到配置的页面,步骤:点击编译左边的下拉框→选择添加编译模式→更改启动页面的路径→确定
4.上传代码
(1)击开发者工具顶部工具栏中的“上传”按钮
(2)填写版本号以及项目备注
注:上传成功后,需要联系管理员在小程序管理后台将本次上传设置为体验版本。
5.在后台查看上传之后的版本
在微信开发者工具中上传项目后,登录小程序管理后台(https://mp.weixin.qq.com/),点击管理→版本管理→开发版本,即可查看提交上传的版本了。
6.提交审核
为了保证小程序的质量,以及符合相关的规范,小程序的发布是需要经过腾讯官方审核的,点击版本管理→开发版本中的提交审核。
7.发布
审核通过后,管理员的微信中会收到小程序通过审核的通知,此时在审核版本的列表中,点击“发布”按钮之后,即可把“审核通过”的版本发布为“线上版本”,供所有小程序用户访问和使用。
8.基于小程序码进行推广
获取小程序码的步骤:
登录小程序管理后台→设置→基本设置→小程序码及线下物料下载
9.查看小程序运营数据的两种方式
(1)在“小程序后台查看”
登录小程序理后台→点击侧边的“统计”→点击相应的tab可以看到相关的数据
(2)使用“小程序数据助手”查看
打开微信→搜索“小程序数据助手”→查看已发布的相关小程序相关的数据
三、小程序运行机制
1.小程序的启动过程:
(1)把小程序的代码包下载到本地
(2)解析app.json全局配置文件
(3)执行app.js小程序入口文件,调用APP()创建小程序实例
(4)渲染小程序首页
(5)小程序启动完成
2.页面渲染过程:
(1)加载解析页面的.json配置文件
(2)加载页面的.wxml模板和 .wxss样式
(3)执行页面的.js文件,调用Page()创建页面实例
(4)页面渲染完成
3.生命周期函数
- 应用的生命周期函数
小程序的应用生命周期函数需要在app.js中进行声明,示例代码如下:
// app.js 文件
App({
//小程序初始化完成时,执行此函数,全局只触发一次。可以做一些初始化的工作
onLaunch:function(options){},
//小程序启动,或从后台进入前台显示时触发
onShow:function(options){},
// 小程序从前台进入后台时触发
onHide:function(options){}
})
- 页面的生命周期函数
小程序的页面生命周期函数需要在页面的.js文件中进行声明,示例代码如下:
页面的.js文件:
Page({
onLoad:function(options){}, //监听页面加载,一个页面只调用一次
onShow:function(){}, //监听页面显示
onReady:function(){}, //监听页面出次渲染完成,一个页面只调用1次
onHide:function(){}, //监听页面隐藏
onUnload:function(){} //监听页面卸载,一个页面只调用一次
})
四、小程序组件使用
1.小程序组件
微信官方文档有小程序的组件,地址:
https://developers.weixin.qq.com/miniprogram/dev/component/cover-image.html
2.小程序的宿主环境-API
小程序官方把API分为了如下3大类:
(1)事件监听API
特点:以on开头,用来监听某些事件的触发
举例:wx.onWindowResize(function callback)监听窗口尺寸变化的时间
(2)同步API
特点1:以Sync结尾的API都是同步API
特点2:同步API的执行结果,可以通过函数返回值直接获取,如果执行出错会抛出异常
举例:wx.setStorageSync('key','value')向本地存储中写入内容
(3)异步API
特点:类似于JQuery中的$.ajax(options)函数,需要通过success、fail、complete接受调用的结果
举例:wx.request()发起网络数据请求,通过success回调函数接受数据
五、模板与配置
1.数据绑定
参考官网:https://developers.weixin.qq.com/miniprogram/dev/reference/wxml/data.html
1.数据绑定的基本原则:
(1)在data中定义数据
在页面对应的.js文件中,把数据定义到data对象中即可
Page({
data:{
//字符串类型的数据
info:'init data',
//数组类型的数据
msgList:[{msg:'hello'},{msg:'world'}]
}
})
(2)在WXML中使用数据
把data中的数据绑定到页面中渲染,使用Mustache语法(双大括号)将变量包起来即可,语法格式为:
<view>{
{要绑定的数据名称}}</view>
2.事件绑定
事件是渲染层到逻辑层的通讯方式。通过事件可以将用户在渲染层产生的行为,反馈到逻辑层进行业务的处理。
小程序中常用的事件
类型 | 绑定方式 | 事件描述 |
---|---|---|
tap | bindtap或bind:tap | 手指触摸后马上离开,类似于HTML中的click事件 |
input | bindinput或bind:input | 文本框的输入事件 |
change | bindchange或bind:change | 状态改变时触发 |
3.全局配置
1.全局配置文件及常用的配置项
小程序根目录下的app.json文件是小程序的全局配置文件。常用的配置项如下:
(1)pages:记录当前小程序所有页面的存放路径
(2)window:全局设置小程序窗口的外观
(3)tabBar:设置小程序底部的tabBar效果
(4)style:是否启用新版的组件样式
2.全局开启下拉刷新功能
(1)概念:
下拉刷新是移动端的专有名词,指的是通过手指在屏幕上的下拉滑动操作,从而重新加载页面数据的行为。
设置步骤:app.json→window→把enablePullDownRefresh的值设置为true
注意:在app.json中启用下拉刷新功能,会作用于每个小程序页面
(2)设置下拉刷新时窗口的背景色
当全局开启下拉刷新功能之后,默认的窗口背景为白色。如果自定义下拉刷新窗口背景色,
设置步骤为:app.json →window→为backgroundColor指定16进制的颜色值。
(3)设置下拉刷新时loading的样式
当全局开启下拉刷新功能之后,默认窗口的loading 样式为白色,如果要更改loading样式的效果,
设置步骤为app.json -> window ->为backgroundTextStyle设定值,仅支持dark/light。
(4)设置上拉触底的距离
上拉触底是移动端的专有名词,通过手指在屏幕上的上拉滑动操作,从而加载更多数据的行为。
设置步骤: app.json -> window ->为onReachBottomDistance设置新的数值
注意:默认距离为50px,如果没有特殊需求,建议使用默认值即可。
3.配置tabBar
(1)什么是tabBar
tabBar是移动端应用常见的页面效果,用于实现多页面的快速切换。小程序中通常将其分为:
底部 tabBar、顶部 tabBar
注意:tabBar中只能配置最少2个、最多5个tab页签当渲染顶部 tabBar时,不显示icon,只显示文本
(2)tabBar的六个组成部分
backgroundColor: tabBar的背景色
borderStyle: tabBar上边框的颜色
iconPath:未选中时的图片路径
selectediconPath:选中时的图片路径
selectedColor: tab 上的文字选中时的颜色
color: tab 上文字的默认(未选中)颜色
(3)tabBar节点的配置项
属性 | 类型 | 必填 | 默认值 | 描述 |
---|---|---|---|---|
position | String | 否 | bottom | tabBar的位置,仅支持bottom/top |
borderStyle | String | 否 | black | tabBar上边框的颜色,仅支持black/white |
color | HexColor | 否 | tab上文字的默认(未选中)颜色 | |
selectedColor | HexColor | 否 | tab上的文字选中时的颜色 | |
backgroundColor | HexColor | 否 | tabBar的背景色 | |
list | Array | 是 | tab页签的列表,最少2个,最多5个tab |
(4)每个tab项的配置选项
属性 | 类型 | 必填 | 描述 |
---|---|---|---|
pagePath | String | 是 | 页面路径,页面必须在pages中预先定义 |
text | String | 是 | tab上显示的文字 |
iconPath | String | 否 | 未选中时的图标路径;当position为top时,不显示icon |
selectedIconPath | String | 否 | 选中时的图标路径,当position为top时,不显示icon |
(5)示例
步骤:
<1> 新建images文件夹,把需要的图标放到文件夹中
<2> 通过app.json文件的page节点,新建3个对应的tab页面,配置好路径,pages文件夹中会自动新建3个对应的文件夹
<3> 配置tabBar选项:和pages、window平级,新增tabBar节点,在tabBar节点中,新增list数组,在list数组中,新增每个tab项的配置对象
4.页面配置
(1)页面配置和全局配置的关系
小程序中,app.json中的window节点,可以全局配置小程序中每个页面的窗口表现。
如果某些小程序页面想要拥有特殊的窗口表现,此时,“页面级别的.json配置文件”就可以实现这种需求。
注意:当页面配置与全局配置冲突时,根据就近原则,最终的效果以页面配置为准。
(2)页面配置中常用配置项
参考官网:https://developers.weixin.qq.com/miniprogram/dev/reference/configuration/page.html
六、网络数据请求
1.小程序中网络数据请求的限制
出于安全性方面的考虑,小程序官方对数据接口的请求做出了如下两个限制:
只能请求HTTPS类型的接口
必须将接口的域名添加到信任列表中
2.配置request合法域名
需求描述:
假设在自己的微信小程序中,希望请求https://www.escook.cn/域名下的接口
配置步骤:
登录微信小程序管理后台→>开发→>开发设置→>服务器域名->开始配置 / 修改request合法域名
注意事项:
域名只支持https 协议
域名不能使用IP地址或 localhost 域名必须经过ICP备案
服务器域名一个月内最多可申请5次修改