社区/学习指南/微信云开发学习指南

优化与部署上线

通过前面的实战学习,相信大家在写代码的过程中,遇到了很多问题,在不断解决问题的过程中也总结了一些经验。在这一部分会总结一些开发中的经验以及小程序的优化、部署、上线。

开发者工具的使用

缩进与缩进设置

尽管缩进并不会对小程序的代码产生什么影响(Python 才会严格强调缩进,不同的缩进也有不同的意义),但是为了代码的可读性,缩进是必不可少的。缩进除了美观,还可以体现逻辑上的层次关系,鼠标移到编辑器显示代码行数的地方,可以看到有–减号,点击即对代码进行折叠与展开,这一功能在开发上可以让我们更容易理清代码的层次、嵌套关系,避免出现少了闭合的情况。

小程序的 wxml、js、json、wxss 等不同的文件类型,开发时,在缩进的安排上也会有所不同,这个就需要大家自己去阅读其他优秀项目的源代码来领会了,这里也无法一一详述。

缩进有两种方式,一种是使用 Tab 键,还有一种是使用空格,建议大家使用 Tab。小程序默认一个缩进=一个 Tab=2 个空格,通常前端开发是一个 Tab=4 个空格,你如果不习惯,可以在设置里进行设置。

代码的可读、美观甚至优雅,是一个优秀的程序员应该去追求的,缩进也只是其中很小的一环。代码可读性高,既提升自己的开发效率,也利于团队的分享与协作,后期的维护等等。

快捷键

微信开发者工具也有着和其他 IDE 和代码编辑器比较一致的快捷键,通过使用这些快捷键,可以大大提升我们编写代码的效率。Mac 和 Windows 的快捷键组合略微会有所不同,大家可以自行阅读技术文档来了解。

技术文档:微信开发者工具快捷键

快捷键的目的是为了自己编写代码的方便,每个人的快捷键的使用习惯都会有所不同。当然最简单通用的 Ctrl+C 复制、Ctrl+V 粘贴、Ctrl+X 剪切、Ctrl+Z 重做、Ctrl+S 保存,Ctrl+F 搜索等这些快捷键组合是非常通用的,建议大家都掌握。

微信开发者工具的快捷键组合里有几个值得大家多使用,

  • 批量注释快捷键:windows 是 Ctrl+/,Mac 是 Command+/
  • 代码块的缩进:windows 是代码左缩进 ctrl + [、代码右缩进 ctrl + ],相应的 Mac 是 ⌘ + [ 和 ⌘ + ]
  • 格式化代码:Windows 为 shift + alt + F、Mac 为 ⇧ + ⌥ + F

官方快捷键文档写得很不全,建议大家参考下面 Visual Studio Code 的快捷键 PDF 来对快捷键有一个更全面的了解。Mac 快捷键、Windows 快捷键,使用快捷键的目的是为了提升开发的效率,一切还是以你的习惯为主,不要为了快捷键而快捷键。

报错提醒

相信大家在前面实际的开发中经常会看到开发者工具调试器里的 Console,它会比较有效的指出代码的错误的信息、位置等,是日常开发非常非常重要的工具,堪称编程的指路明灯。大家务必要养成查看错误 Console 的习惯,也要善于根据报错信息去搜索相关的解决方法。以后我们还会介绍它更多的用处,堪称神器,不可不了解。

小程序的代码编辑器也会为我们提供一些错误信息,比如出现红色的~,这个时候就要注意啦,你是不是出现字符是中文,漏了标点符号等比较低级而小儿科的错误。

wxml 代码查看

开发者工具调试器里除了有 Console,还有一个 wxml 标签页(可能被折叠,需要你展开),它可以让我们了解当前小程序页面的 wxml 和 wxss 结构构成,可以用来调试组件的 css 样式等。不过这个工具目前体验还特别糟糕。

自动补全与代码提示

小程序开发者工具是提供一些代码自动补全与代码提示的,具体情况大家可以看一下官方文档关于自动补全的内容。在平时开发的过程中也可以多留意与摸索。

小程序的转发功能

我们只需要在小程序每个页面的 js 文件下的 Page({ }) 里面,添加以下代码,我们的小程序就有转发功能了,这个可以通过点击开发者工具的预览用手机来体验哦

技术文档:小程序的转发

    onShareAppMessage: function (res) {
            if (res.from === 'button') {
                // 来自页面内转发按钮
                console.log(res.target)
            }
            return {
                title: '云开发技术训练营',
                path: "pages/home/home,
                imageUrl:"https://hackwork.oss-cn-shanghai.aliyuncs.com/lesson/weapp/4/weapp.jpg",
                success: function (res) {
                    // 转发成功
                },
                fail: function (res) {
                    // 转发失败
                }
            }
        },
  • title 为转发的标题,如果不填,默认为当前小程序的名称;
  • path 为当前页面路径,也可以为其他页面的路径,如果路径写错的话会显示“当前页面不存在”哦。
  • imageUrl 为自定义图片路径,可以是本地文件路径或网络图片路径。支持 PNG 及 JPG。显示图片长宽比是 5:4。如果不填写会取当前页面,从顶部开始,高度为 80% 屏幕宽度的图像作为转发图片

小程序配置的细节

要做出专业的小程序,就需要在很多细微的地方做足功夫,在互联网的世界里有专门的 UX 用户体验设计师,所做的工作就是尽可能的以用户为中心,增强用户使用产品的体验,这背后有一整套的知识体系,大家可以拓展了解一下。

没有 tabBar 的小程序

有时候我们不希望我们的小程序底部有 tabBar,那我们该怎么处理呢?我们可以删掉 app.json 的 tabBar 配置项即可。

下拉小程序不出现空白

当我们下拉很多小程序的时候,都会出现一个白色的空白,很影响美观,但是如果我们在 windows 的配置项里把 backgroundColor 和 navigationBarBackgroundColor 的颜色配置成一样,下拉就不会有空白啦,比如:

"window":{
        "backgroundTextStyle":"light",
        "navigationBarBackgroundColor": "#1772cb",
        "navigationBarTitleText": "HackWork技术工坊",
        "navigationBarTextStyle":"white",
        "backgroundColor": "#1772cb"
      },

让整个页面背景变色

小程序的页面背景的颜色默认为为白色,我们希望整个小程序的页面背景变成其他颜色应该怎么处理呢?

我们可以可以通过直接设置 page 的样式来设置,在该页面的 wxss 文件里添加如下样式,如

page{
  background-color: #1772cb;
}

我们发现小程序除了页面默认的背景色是白色,很多组件的默认背景色也是白色,组件里的文字的默认颜色是黑色,文字也有默认大小,很多组件虽然我们没有去定义它们的 css 样式,但是它们却自带一些 css 样式。

禁止页面下拉

有的时候我们的页面做得比较短,为了增强用户体验,不希望用户可以下拉页面,因为下拉页面会有种页面松动的感觉,可以在该页面的 json 文件里配置,比如

{
  "window": {
    "disableScroll": true
  }
}

注意,不是 app.json 文件,而是页面的 json 文件,为什么不是 app.json 文件而是页面的 json 文件呢?大家可以思考一下,小程序这么处理的逻辑。

自定义顶部导航栏

官方默认的导航栏只能对背景颜色进行更改,对于想要在导航栏添加一些比较酷炫的效果则需要通过自定义导航栏实现。通过设置 app.json 中页面配置的 navigationStyle(导航栏样式)配置项的值为 custom,即可实现自定义导航:

"window":{
    "navigationStyle":"custom"
}

比如我们给小程序的页面配一个好看的壁纸,比如在 home.wxss 里添加以下样式:

page{
    background-image: url(https://tcb-1251009918.cos.ap-guangzhou.myqcloud.com/background.jpg)
}

然后在手机上预览该页面,发现小程序固有的带有页面标题的顶部导航栏就被背景图片取代了。我们也还可以在顶部导航栏原有的位置上设计一些更加酷炫的元素,这些都是可以通过前面组件的知识来实现的。

模板

有这样一个应用场景,我们希望所有的页面都有一个相同的底部版权信息,如果是每个页面都重复写这个版权信息就会很繁琐,如果可以定义好代码片段,然后在不同的地方调用就方便了很多,这就是模板的作用。

静态的页面片段

比如使用开发者工具在小程序的 pages 页面新建一个 common 文件夹,在 common 里新建一个 foot.wxml,并输入以下代码

<template name="foot">
      <view class="page-foot">
        <view class="index-desc" style="text-align:center;font-size:12px;bottom:20rpx;position:absolute;bottom:20rpx;width:100%">云开发技术训练营</view>
      </view>
    </template>

在要引入的页面比如 home.wxml 的顶部,使用 import 引入这个模板,

<import src="/pages/common/foot.wxml" />

然后在要显示的地方调用比如 home.wmxl 页面代码的最底部来调用这个模板

<template is="foot" />

动态的页面片段

比如在页面的每一页都有一个相似的页面样式与结果,但是不同的页面有着不同的标题以及页面描述,用数据绑定就能很好的解决这个问题,不同的页面的 js data 里有不同的数据,而模板的 wxml 都是固定的框架。

比如使用开发者工具在小程序的 pages 页面新建一个 common 文件夹,在 common 里新建一个 head.wxml,并输入以下代码:

<template name="head">
      <view class="page-head">
        <view class="page-head-title">{{title}}</view>
        <view class="page-head-line"></view>
        <view wx:if="{{desc}}" class="page-head-desc">{{desc}}</view>
      </view>
    </template>

我们再给每个页面的 js 里的 data 里添加不同的 title 和 desc 信息,再来在页面先引入 head.wxml,然后在指定的位置比如 wxml 代码的前面调用该模板。

<import src="/pages/common/head.wxml" />
<template is="foot" />

我们注意创建模板时,使用的是 <template name=”模板名”></template>,而调用模板时,使用的是<template is=”模板名” />,两者之间对应。

小程序的客服

开发者在小程序内添加客服消息按钮组件,用户就可在小程序内唤起客服会话页面,给小程序发消息。而开发者(可绑定其他运营人员)也可以直接使用微信公众平台网页版客服工具或者移动端小程序客服小助手进行客服消息回复,非常的方便。

只需要在 wxml 文件里添加如下代码,即可唤起客服会话页面:

<button open-type="contact"></button>

button 的样式大家可以根据之前学习的 css 知识修改一下。

web-view

承载网页的容器。会自动铺满整个小程序页面,个人类型的小程序暂不支持使用。web-view 组件可打开关联的公众号的文章,这个对很多自媒体用户就比较友好了,公众号文章可以使用第三方的工具比如秀米、135 编辑器等制作得非常精美,这些文章可以在小程序里打开啦。

<web-view src="https://mp.weixin.qq.com/cgi-bin/wx"></web-view>

web-view 的也可以绑定备案好的域名,支持 JSSDK 的接口,因此很有小程序为了省开发成本,点击链接打开的都是网页,并没有做小程序的原生开发,这个就不再讨论范围之内了。

本文出自 李东bbsky