学习目标：微信小程序基础Day01

今日目标:

能够知道如何创建小程序项目
能够清楚小程序项目的基本组成结构
能够知道小程序页面由几部分组成
能够知道小程序中常见的组件如何使用
能够知道小程序如何进行协同开发和发布

学习内容：

学习目录:

小程序简介
第一个小程序
小程序代码的构成
小程序的宿主环境
协同工作和发布
总结

1.小程序简介

1.1.小程序与普通网页开发的区别

运行环境的不同
- 网页运行在浏览器
- 小程序运行在微信环境
API 不同
- 小程序无法调用 DOM 和 BOM 的 API
- 但是小程序可以调用微信环境提供的一些 API
  - 地理定位
  - 扫码
  - 支付
开发模式不同
- 网页的开发模式：浏览器+代码编辑器
- 小程序开发模式
  - 申请小程序开发账号
  - 安装小程序的开发者工具
  - 创建和配置小程序项目

1.2.体验微信小程序

2.第一个小程序

2.1.注册微信开发者账号, 获取AppID

使用浏览器打开 https://mp.weixin.qq.com/ 网址，点击右上角的“立即注册”，进入小程序开发账号注册流程

2.2.微信开发者工具的安装和使用

2.2.1.安装

下载最新版本
https://developers.weixin.qq.com/miniprogram/dev/devtools/stable.html

2.2.2.使用

扫码登录
在完成安装安装之后, 将会打开微信开发者工具, 此时会提示扫码登录, 需使用自己的微信进行扫码

3.小程序代码的构成

3.1.项目的基本组成结构

pages 用来存放所有小程序的页面，每个页面都是一个单独的文件夹
utils 用来存放工具性质的模块
app.js 整个小程序项目的入口文件
app.json 小程序项目的全局配置文件
app.wxss 小程序项目的全局样式文件
project.config.json 项目的配置文件
sitemap.json 用来配置小程序及其页面是否允许被微信索引

3.2.小程序页面的组成部分

小程序官方建议把所有小程序的页面，都存放在 pages 目录中，以单独的文件夹存在
每个页面由 4 个基本文件组成，它们分别是：
- .js 文件（页面的脚本文件，存放页面的数据、事件处
  理函数等）
- .json 文件（当前页面的配置文件，配置窗口的外观、表现等）
- .wxml 文件（页面的模板结构文件）
- .wxss 文件（当前页面的样式表文件）

总结而言,就是一个页面的结构,样式,功能和配置都被分别放到了单独的文件夹中进行维护

3.3. JSON 配置文件

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

项目根目录的 app.json 配置文件
项目根目录种的 project.config.json 配置文件
项目根目录中的 sitemap.json 配置文件
每个页面文件夹中的 .json 配置文件

3.3.1. app.json 配置文件

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

简单了解下这 4 个配置项的作用：

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

目前大家先对 pages 和 window 节点多多关注, 后续会不断的在这两个节点中进行配置

3.3.2. project.config.json 配置文件

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

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

这里需要将project.config.json 和 app.json 配置文件的作用区分开来
project.config.json 更多的是对微信开发者工具的配置, 而 app.json 是对项目代码功能层面上的配置.

3.3.3. sitemap.json 配置文件

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

注意： sitemap 的索引提示是默认开启的，如需要关闭 sitemap 的索引提示，可在小程序项目配置文件 project.config.json 的 setting 中配置字段 checkSiteMap 为 false

3.3.4.页面的 .json 配置文件

小程序中的每一个页面，可以使用 .json 文件来对本页面的窗口外观进行配置，页面中的配置项会覆盖 app.json 的 window 中相同的配置项, 当然, 这指的是当前页面被展示出来的时候.

3.4.新建小程序页面

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

3.5.修改项目首页

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

3.6. WXML

WXML 是小程序框架的标签语言,用来构建小程序页面的结构，其作用类似于网页开发中的 HTML。他们主要存在下面几点的差别

1. 标签名不同

HTML（div）
WXML(view, text, image, navigator)

2. 属性节点不同

<a href="#" > </a>
<navigator url=""> </navigator>

3. 提供了类似于 vue 中的模板语法

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

3.7. WXSS

WXSS (WeiXin Style Sheets) 是一套样式语言，用于描述 WXML 的组件样式，类似于网页开发中的CSS 。他们主要存在下面几点的差别:

① 新增了 rpx 尺寸单位

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

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

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

③ WXSS 仅支持部分 CSS 选择器

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

3.8. js 文件的分类

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

是整个小程序项目的入口文件，通过调用 App() 函数来启动整个小程序

② 页面的 .js 文件

是页面的入口文件，通过调用 Page() 函数来创建并运行页面

③ 普通的 .js 文件

是普通的功能模块文件，用来封装公共的函数或属性供页面使用

4.小程序的宿主环境

4.1.一些概念

宿主环境（host environment）指的是程序运行所必须的依赖环境。
例如：Android 系统和 iOS 系统是两个不同的宿主环境。
安卓版的微信 App 是不能在 iOS 环境下运行的，所以，Android 是安卓软件的宿主环境，脱离了宿主环境的软件是没有任何意义的！

手机微信是小程序的宿主环境

小程序借助宿主环境提供的能力，可以完成许多普通网页无法完成的功能，例如：
微信扫码、微信支付、微信登录、地理定位、 etc …

小程序的宿主环境包含以下几部分内容
① 通信模型
② 运行机制
③ 组件
④ API

通信模型
小程序中通信的主体是渲染层和逻辑层，其中：
① WXML 模板和 WXSS 样式工作在渲染层
② JS 脚本工作在逻辑层

而所谓的通信模型指的是:
① 渲染层和逻辑层之间的通信
② 逻辑层和第三方服务器之间的通信
这两部分的通信都是通过微信客户端进行转发

运行机制
小程序的运行机制主要讲两部分

① 小程序启动的过程

把小程序的代码包下载到本地
解析 app.json 全局配置文件
执行 app.js 小程序入口文件，调用 App() 创建小程序实例
渲染小程序首页
小程序启动完成

② 某个页面渲染的过程

加载解析页面的 .json 配置文件
加载页面的 .wxml 模板和 .wxss 样式
执行页面的 .js 文件，调用 Page() 创建页面实
页面渲染完成

4.2.组件

4.2.1.常用的组件

小程序中的组件也是由宿主环境提供的，开发者可以基于组件快速搭建出漂亮的页面结构。官方把小程序的组件分为了 9 大类，分别是：
① 视图容器
② 基础内容
③ 表单组件
④ 导航组件
⑤ 媒体组件
⑥ map 地图组件
⑦ canvas 画布组件
⑧ 开放能力
⑨ 无障碍访问

其中, 对于视图容器组件而言, 常用的有以下3个

view
普通视图区域
类似于 HTML 中的 div，是一个块级元素
常用来实现页面的布局效果
scroll-view
可滚动的视图区域
常用来实现滚动列表效果
swiper 和 swiper-item
轮播图容器组件和轮播图 item 组件

4.2.2. view 组件的使用

实现如图的 flex 横向布局效果
代码如下:

<!--pages/list/list.wxml-->
<view class="container1"> <view>A</view> <view>B</view> <view>C</view>
</view>

/* pages/list/list.wxss */
.container1 { display: flex;justify-content: space-around; align-items: flex-start;
}.container1 view { width: 100px; height: 100px; line-height: 100px; text-align: center; background-color: yellowgreen; color: #fff;
}

4.2.3. scroll-view 组件的使用

scroll-view 主要来实现元素内部的滚动, 注意, 元素内部的滚动和整个页面的滚动不是同一回事.
代码如下:

<!-- scorll-y 允许纵向滚动 -->
<!-- scorll-x 允许横向滚动 -->
<scroll-view class="container1" scroll-y> <view>A</view> <view>B</view> <view>C</view>
</scroll-view>

/* pages/list/list.wxss */
.container1 { border: 2px dashed lightgreen;/* 给父盒子添加固定高度，内部的元素就可以滚动 */width: 100px; height: 130px;
}.container1 view {width: 100px; height: 100px;line-height: 100px; text-align: center; color: #fff;
}.container1 view:nth-child(1) { background-color: yellowgreen; }
.container1 view:nth-child(2) { background-color: lightskyblue; }
.container1 view:nth-child(3) { background-color: lightcoral; }

4.2.4. swiper 组件的使用

swiper 组件主要是用来实现轮播图效果, swiper 组件相当于一个大盒子, swiper-item 指的是轮播图的每一项
代码如下:

<!-- 轮播图的结构 -->
<swiper class="swiper-container"> <swiper-item> <view class="item">A</view> </swiper-item><swiper-item> <view class="item">B</view> </swiper-item> <swiper-item> <view class="item">C</view> </swiper-item>
</swiper>

.swiper-container {height: 150px;
}
.item {height: 100%; line-height: 150px;text-align: center;
}swiper-item:nth-child(1) .item { background-color: lightcoral; }
swiper-item:nth-child(2) .item { background-color: lightseagreen;}
swiper-item:nth-child(3) .item { background-color: lightpink; }

swiper 还有其他相应的属性, 如下:

indicator-dots 是否显示面板指示点
indicator-color 指示点颜色
indicator-active-color 激活指示点颜色
autoplay 是否自动切换
interval 自动切换时间间隔
circular 是否采用衔接滑动

4.2.5. text 组件和 rich-text 组件

text 组件
文本组件
类似于 HTML 中的 span 标签，是一个行内元素
rich-text 组件
富文本组件支持把 HTML 字符串渲染为 WXML 结构

通过 text 组件的 selectable 属性，实现长按选中文本内容的效果

<!-- 只有在text组件中添加selectable 属性支持长按选中效果 -->
<view> <text selectable>手机号码支持长按选中效果：13333333333</text>
</view>

通过 rich-text 组件的 nodes 属性节点，把 HTML 字符串渲染为对应的 UI 结构

<!-- rich-text组件中添加 nodes节点可以把 HTML 字符串渲染为对应的 UI 结构 -->
<rich-text nodes="<h1 style='color: red;'>标题</h1>">
</rich-text>

注意: 小程序默认是识别不了 HTML 的, 小程序默认只识别 WXML , 所以如果我们从服务器上获取到了包含HTML 字符串的数据, 并且想展示出来, 应该使用到 rich-text 组件的 nodes 属性

4.2.6. button 组件

button 是按钮组件,它的功能比 HTML 中的 button 按钮丰富,我们可以通过 open-type 属性可以调用微信提供的各种功能（客服、转发、获取用户授权、获取用户信息等

基本使用的代码如下:

<!-- 通过type属性指定按钮颜色类型 -->
<button>普通按钮</button>
<button type="primary">主色调按钮</button>
<button type="warn">警告按钮</button> <!-- 通过size属性指定按钮尺寸 -->
<button size="mini">普通按钮</button>
<button size="mini" type="primary">主色调按钮</button>
<button size="mini" type="warn">警告按钮</button> <!-- 通过plain属性指定按钮的镂空效果 -->
<button plain>普通按钮</button>
<button plain type="primary">主色调按钮</button>
<button plain type="warn">警告按钮</button>

4.2.7. image 组件

image 是图片组件(注意,不是 img , 是 image ), 用来展示图片的, 它也是通过 src 属性来指明图片的路径.

image 组件默认宽度约 300px 、高度约 240px
关于 image 组件, 还有一个属性叫做 mode , 它是用来控制图片的裁剪和缩放形式, 具体的可选值如下:

4.3. 小程序API 的3大分类

小程序中的 API 是由宿主环境提供的，通过这些丰富的小程序 API ，开发者可以方便的调用微信提供的能力，

例如：获取用户信息、本地存储、支付功能等。

小程序 API 分为3大类, 分别是:
① 事件监听 API

特点：以 on 开头，用来监听某些事件的触发
举例： wx.onWindowResize(function callback) 监听窗口尺寸变化的事件

② 同步 API

特点1：以 Sync 结尾的 API 都是同步 API
特点2：同步 API 的执行结果，可以通过函数返回值直接获取，如果执行出错会抛出异常
举例： wx.setStorageSync(‘key’, ‘value’) 向本地存储中写入内容

③ 异步 API

特点：类似于 jQuery 中的 $.ajax(options) 函数，需要通过 success、fail、complete 接收调用的结果
举例： wx.request() 发起网络数据请求，通过 success 回调函数接收数据

5.协同工作和发布

5.1.为什么需要有权限管理

在中大型的公司里，人员的分工非常仔细：同一个小程序项目，一般会有不同岗位、不同角色的员工同时参与设计与开发。

此时出于管理需要，我们迫切需要对不同岗位、不同角色的员工的权限进行边界的划分，使他们能够高效的进行协同工作。

5.2.项目成员的组织结构

项目管理者
- 产品组
  - 提需求
  - 设计组
  - 出设计方案
- 开发组
  - 代码开发
- 测试组
  - 项目测试

其中, 项目管理者需要统筹整个项目的进展和风险，把控小程序对外发布的节奏

5.3.小程序的开发流程

度娘O(∩_∩)O哈哈~

5.4.小程序成员管理

小程序成员管理体现在管理员对小程序项目成员及体验成员的管理：
① 项目成员：

表示参与小程序开发、运营的成员
可登录小程序管理后台
管理员可以添加、删除项目成员，并设置项目成员的角色

② 体验成员：

表示参与小程序内测体验的成员
可使用体验版小程序，但不属于项目成员
管理员及项目成员均可添加、删除体验成员

5.4.1.不同项目成员对应的权限

我们更多关注的是开发者所具备的权限

开发者所具备的权限有: 开发权限, 体验者权限, 登录权限,开发设置,腾讯云管理

开发者权限：可使用小程序开发者工具及对小程序的功能进行代码开发
体验者权限：可使用体验版小程序
登录权限：可登录小程序管理后台，无需管理员确认
开发设置：设置小程序服务器域名、消息推送及扫描普通链接二维码打开小程序
腾讯云管理：云开发相关设置

5.5.小程序的版本

在软件开发过程中，根据时间节点的不同，会产出不同的软件版本，例如：
① 开发者编写代码的同时，对项目代码进行自测（开发版本）
② 直到程序达到一个稳定可体验的状态时，开发者把体验版本给到产品经理和测试人员进行体验测试
③ 最后修复完程序的 Bug 后，发布正式版供外部用户使用

5.6.发布上线

小程序发布上线的整体步骤
一个小程序的发布上线，一般要经过上传代码 -> 提交审核 -> 发布这三个步骤。
上传代码
① 点击开发者工具顶部工具栏中的“上传” 按钮
② 填写版本号以及项目备注
在后台查看上传之后的版本
登录小程序管理后台 -> 管理 -> 版本管理 -> 开发版本，即可查看刚才提交上传的版本了
提交审核
为什么需要提交审核：为了保证小程序的质量，以及符合相关的规范，小程序的发布是需要经过腾
讯官方审核的。
提交审核的方式：在开发版本的列表中，点击“提交审核”按钮之后，按照页面提示填写相关的信
息，就能把小程序提交到腾讯官方进行审核。
发布
审核通过之后，管理员的微信中会收到小程序通过审核的通知，此时在审核版本的列表中，点击“发布”
按钮
之后，即可把“审核通过”的版本发布为“线上版本”，供所有小程序用户访问和使用。
基于小程序码进行推广
相对于普通二维码来说，小程序码的优势如下：
① 在样式上更具辨识度和视觉冲击力
② 能够更加清晰地树立小程序的品牌形象
③ 可以帮助开发者更好地推广小程序

获取小程序码的 5 个步骤：
登录小程序管理后台 -> 设置 -> 基本设置 -> 基本信息 -> 小程序码及线下物料下载

5.7.运营数据

查看小程序运营数据的两种方式

在“小程序后台”查看
- 登录小程序管理后台
- 点击侧边栏的“统计”
- 点击相应的 tab 可以看到相关的数据
使用“小程序数据助手”查看
- 打开微信
- 搜索“小程序数据助手”
- 查看已发布的小程序相关的数据

6.总结

① 能够知道如何创建小程序项目
微信开发者工具的使用、 appID 的获取

② 能够清楚小程序项目的基本组成结构
app.js 、 app.json 、 app.wxss 、 pages 文件夹

③ 能够知道小程序页面由几部分组成
wxml 、 wxss 、 json 、 js

④ 能够知道小程序中常见的组件如何使用
view 、 text 、 image

⑤ 能够知道小程序如何进行协同开发和发布
成员管理、发布小程序、查看运营数据

学习产出：

基础技术笔记 5 篇
项目技术笔记 5 篇
CSDN 技术博客 10 篇

微信小程序基础学习笔记Day01相关推荐

微信小程序基础学习笔记Day02
学习目标:微信小程序基础Day02 今日目标: 能够使用 WXML 模板语法渲染页面结构能够使用 WXSS 样式美化页面结构能够使用 app.json 对小程序进行全局性配置能够使用 page. ...
微信小程序基础学习笔记
一.环境准备开发微信⼩程序之前,必须要准备好相应的环境 1. 注册账号建议使用全新的邮箱,没有注册过其他小程序或者公众号的. 访问注册⻚⾯,耐⼼完成注册即可. 2. 获取APPID 由于后期调⽤ ...
微信小程序进阶学习笔记Day05
学习目标:微信小程序基础Day05 今日目标: 能够知道如何安装和配置 vant-weapp 组件库能够知道如何使用 MobX 实现全局数据共享能够知道如何对小程序的 API 进行Promise ...
wechat_微信小程序的学习笔记
微信小程序的学习目标一.初识小程序 1.小程序简介二.安装并创建小程序项目 1.注册小程序开发账号(目的:获取AppID) 2.安装小程序开发者工具 3.创建和配置小程序项目三.学习小程序项目 ...
基于有Vue基础的微信小程序开发学习笔记
微信小程序开发文章目录微信小程序开发一.微信小程序介绍二.小程序结构目录 1.小程序的文件结构 2.基本项目目录三.配置文件详解 1.全局配置文件 2.页面配置文件 3.sitemap配置 ...
微信小程序Day4学习笔记
学习目标基础强化目录 1. 自定义组件 - 创建新建组件 1. 引用组件 2. 局部引用组件在 json 中引用, 在页面 wxml 中可以用标签 - 添加使用 3. 全局引用组件全局配 ...
微信小程序开发学习笔记一
微信小程序学习笔记(一) 环境使用及创建项目文件目录设置 JS文件环境使用及创建项目环境使用:微信开发者工具一个微信号只能开发一个微信小程序. 在微信小程序开发手册下载最新版本,学习不要bet ...
微信小程序Day2学习笔记
学习目标此笔记参考b站黑马程序员微信小程序开发视频 D盘有文件写入权限问题,,今天换成了C盘,希望要撑住.. 1.WXML 模板语法 1.数据绑定的基本原则在 data 中定义数据在 WXM ...
微信小程序开发学习笔记007--微信小程序项目01
技术交流QQ群:170933152 今天做项目小程序开发必备基础如何独立开发一个项目豆瓣电影需要的基础: HTML+CSS JavaScript 网络先理解需求-->了解项目流程,项目 ...

微信小程序基础学习笔记Day01