小程序开发入门学习

哆啦e梦
259 阅读12分钟

小程序代码构成

一、小程序代码的项目基础结构

1、 项目基本组成结构

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

2、小程序页面组成

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

image.png

其中每个·页面有四个基本文件组成，

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

3、json配置文件的作用

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

  1. 小程序项目中的4种json文件：
  2. 项目根目录中的app.json配置文件
  3. 项目根目录中的project.config.json配置文件
  4. 项目根目录中的sitemap.json配置文件
  5. 每个页面文件夹中的.json配置文件

4、app.json文件

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

image.png

4个配置项的作用：

  1. pages：用来记录当前小程序所有页面的路径
  2. window：全局定义小程序所有页面的背景色、文字颜色等
  3. style：全局定义小程序组件使用的样式版本。默认使用最新版本，若想用旧版本，则将style删除。
  4. sitemapLocation：用来指明sitemap.json的位置

5、project.config.json文件

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

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

6、sitemap.json文件

微信现在已经开放小程序内搜索，效果类似于PC网页的SEO。sitemap.json文件用来配置小程序页面是否允许微信索引。

当开发者允许微信索引时，微信会通过爬虫的形式，为小程序的页面内容建立索引。当用户的搜索关键字和页面的索引匹配成功的时候，小程序的页面将可能展示在搜索结果中。 若不希望被索引，则"action": "disallow"。

image.png

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

7、页面文件夹中的.json配置文件

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

image.png

8、新建小程序页面

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

image.png

9、修改项目首页

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

image.png

二、小程序代码的构成——WXML模板

1、什么是WXML

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

2、WXML和HTML的区别

（1）标签名称不同

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

（2）属性节点不同

  • <a href="#">超链接</a>
  • <navigator url="pages/home/home"></navigator>

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

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

三、小程序代码的构成——WXSS样式

1、什么是WXSS

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

2、WXSS和CSS的区别

（1）新增了rpx尺寸单位

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

（2）提供了全局的样式和局部的样式

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

（3）WXSS仅支持部分CSS选择器

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

四、小程序代码的构成——JS逻辑交互

1、小程序中的.js文件

一个项目仅仅提供页面展示是不够的，在小程序中，我们通过.js文件来处理用户的操作。如：响应用户的点击、获取用户的位置等等。 2、小程序中.js文件的分类 小程序中的JS文件分为三大类：

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

小程序的宿主环境

一、宿主环境简介

1、什么是宿主环境

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

2、小程序的宿主环境

手机微信是小程序的宿主环境，小程序借助宿主环境提供的能力，可以完成许多普通网页无法完成的功能。

二、小程序的宿主环境——通信模型

1、通信主体

小程序中的通信的主体是渲染层和逻辑层，其中：

  1. WXML模板和WXSS样式工作在渲染层
  2. JS脚本工作在逻辑层

2、小程序通信模型

分为两部分：

  1. 渲染层和逻辑层之间的通信
  2. 逻辑层和第三方服务器之间的通信

这两部分由微信客户端进行转发

image.png

三、小程序的宿主环境——运行机制

1、小程序启动的过程

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

2、小程序渲染过程

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

四、小程序的宿主环境——组件

1、小程序中的组件分类

小程序中的组件也是由宿主环境提供的，开发者可以基于组件快速搭建出漂亮的页面结构。9大类：

  1. 视图容器
  2. 基础内容
  3. 表单组件
  4. 导航组件
  5. 媒体组件
  6. map地图组件
  7. canvas画布组件
  8. 开发能力
  9. 无障碍访问

2、常见的视图容器类组件

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

3、view组件的基本使用

实现如图的flex横向布局效果：

image.png

4、 scroll-view组件的基本使用

scroll-y属性：允许纵向滚动

scroll-x属性：允许横向滚动

实现如图的纵向滚动效果

.container1 view{
  width: 100px;
  height: 100px;
  text-align: center;
  line-height: 100px;
  color: aliceblue;
}
.container1 view:nth-child(1){
  background-color: blue;
}
.container1 view:nth-child(2){
  background-color: coral;
}
.container1 view:nth-child(3){
  background-color: deeppink;
}
.container1{
  border: 1px solid red;
  /* 给scroll-view固定的高度 */
  height: 120px;
  width: 100px;
}

image.png

4、swiper和swiper-item组件的基本使用

实现轮播图效果

<!--pages/list/list.wxml-->
<swiper class="swiper-container1" indicator-dots>
  <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>

5、swiper组件的常用属性

属性类型默认值说明
indicator-dotsbooleanfalse是否显示面板指示点
indicator-colorcolorrgba(0,0,0,.3)指示点颜色
indicator-active-colorcolor#000000当前选中的指示点颜色
autoplaybooleanfalse是否自动切换
intervalnumber5000自动切换时间间隔
circularbooleanfalse是否采用衔接滑动

6、常用的基础内容组件

text：

  • 文本组件
  • 类似于HTML中的span标签，是一个行内元素

rich-text：

  • 富文本组件
  • 支持把HTML字符串渲染为WXML结构

7、text组件的基本使用

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

<view>
长按效果
  <text selectable>1234654</text>
</view>

8、rich-text组件的基本使用

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

<rich-text nodes="<h1 style='color:red;'>标题</h1>"></rich-text>

image.png

9、其他常用的组件

（1）button

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

（2）iamge

  • 图片组件
  • image组件默认宽度约300px，高度约240px

（3）navigator

  • 页面导航组件
  • 类似于HTML中的a链接

10、button按钮组件的基本使用

<!-- size="mini"小尺寸按钮 -->
<button size="mini">普通按钮</button>
<button type="primary" size="mini">主色调按钮</button>
<button type="warn" size="mini">警告按钮</button>
<!-- plain镂空按钮 -->
<button size="mini" plain>普通按钮</button>
<button type="primary" size="mini" plain>主色调按钮</button>
<button type="warn" size="mini" plain>警告按钮</button>

image.png

11、image组件的基本使用

<image></image>
<image src="../images/yan.jpg" mode=""/>

image{
  border: 1px solid red;
}

image.png

12、image组件的mode属性

image组件的mode属性用来指定图片的裁剪和缩放模式，常用的mode属性值如下： image.png

五、小程序的宿主环境——API

1、小程序API

小程序中的API由宿主环境提供，通过这些丰富的小程序API，开发者可以方便的调用微信提供的能力。如获取用户信息、本地存储、支付功能等。

2、小程序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、了解权限管理需求

同一个小程序项目，一般会有不同的岗位、不同角色的员工同时参与设计与开发 出于管理的需要，我们迫切需要对不同的岗位、不同角色的员工的权限进行边界划分，使他们能够高效的进行协同工作。

2、了解项目成员的组织结构

image.png

3、小程序的开发流程

image.png

二、协同工作和发布——小程序成员管理

1、成员管理的两个方面

image.png

image.png

2、不同项目成员对应的权限

image.png

3、开发者的权限说明

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

4、添加项目成员和管理成员

image.png

三、协同工作和发布——小程序成员的版本

1、软件开发工程中的不同版本

image.png

2、小程序的不同版本

image.png

四、协同工作和发布——发布上线

1、小程序发布上线的整体步骤

一个小程序的发布上线，一般要经过上传代码->提交审核->发布这三个步骤

2、上传代码

  1. 点击开发者工具顶部工具栏中的“上传”按钮
  2. 填写版本号以及项目备注 image.png

3、在后台查看上传之后的版本

登录小程序管理后台->管理->版本管理->开发版本，即可查看刚才提交上传的版本了： image.png

4、提交审核

  • 为什么需要提交审核：为了保证小程序的质量，以及符合相关的规范，小程序的发布是需要经过腾讯官方审核的。
  • 提交审核的方式：在开发版本的列表中，点击“提交审核”按钮之后，按照页面提示填写相关的信息，就能把小程序提交到腾讯官方进行审核。

5、发布

审核通过之后，管理员的微信中会收到小程序通过审核的通知，此时在审核版本的列表中，点击“发布”按钮之后，即可把“审核”的版本发布为“线上版本”，供所有小程序用户访问和使用。

6、基于小程序码进行推广

image.png

avatar
文章
阅读
粉丝