通过 WeCOS 进行小程序瘦身

发布：2018-05-02 15:14浏览：次来源：网络作者：cola

尽管 4 月份微信官方将小程序的大小限制从 1M 放开到 2M，但是对于使用大量图片的小程序（电商等）来说，2M 的限制还是显得拮据。基于这种场景，腾讯云微信小程序解决方案团队开发了 WeCOS 小程序瘦身工具，依托腾讯云强大的云对象储存（COS），提供自动将小程序内部的图片自动上传到 COS，并将图片的相对路径改为线上 URL，这样就可以大大的缩减小程序的大小，并且无需过多繁琐的上传步骤。

现在我们就一起来看看如何使用吧！假设我们有一个开发好的小程序开发目录 App，目录大小为10M。目录下有大量图片且代码中有对图片资源的引用。为了能够上传并正常运行项目代码，下面来示范如何使用腾讯云 WeCOS 来解决项目包过大的问题。项目目录如图。

通过 WeCOS 进行小程序瘦身(图1)

接下来只需要 3 步，就可以完成小程序瘦身。

一、前期准备

1. 注册腾讯云账号，开通COS 并创建 Bucket。

2. 在本机上安装 Node.js 。

二、安装 WeCOS 并创建配置

打开命令行（开始-运行-CMD-回车），使用 NPM 安装 WeCOS。如图所示：


npm install wecos -g

在与开发目录 app 同目录下创建一个 wecos.config.json 配置文件，在配置里填写基本的配置信息。

通过 WeCOS 进行小程序瘦身(图3)

wecos.config.json 里填写了最基本的配置项。其中，

appDir 指定了小程序开发目录。
appid 为腾讯云账号的appid。
bucketname 是为存储图片创建的 bucket 的名称，这里是名为 weixintest 的 bucket。
folder 可以指定到 bucket 下的某个目录，本文指定到 /wxtest 目录下。
region 是指定上传到 COS 的指定地区，这里指定为 tj ，即天津。目前COS 支持天津、上海、广州。
secret_key 、 secret_id 是账户密钥，用户可以自行到腾讯云 COS 控制台上获取。

以上信息指定了开发目录以及图片要上传到的 COS 的地址，完成这些配置，基本上已经完工。

三、运行瘦身工具

在命令行中执行 wecos 命令。

通过 WeCOS 进行小程序瘦身(图5)

可以看到，命令行显示项目中的三个图片上传成功。翻看项目目录，发现图片已经被删除，代码中的图片引用也被换成了线上的地址，项目包一下子小了。同时，WeCOS 很贴心的在开发项目外生成了个 wecos_backup 目录，来保存原来的图片作为备份。除此之外，WeCOS 默认启用监听模式，这是为了让开发过程中无感知，当我们不再进行项目开发，停止运行 WeCOS 即可。

通过 WeCOS 进行小程序瘦身(图6)

被处理后的整个项目目录只剩下不到5KB，用微信小程序开发者工具预览小程序发现除了图片部分的更改，其他部分跟处理之前没有什么差别。此时，可以重新上传我们的小程序代码，代码很顺利的上传成功了。

通过 WeCOS 进行小程序瘦身(图7)

到这里我们的瘦身也就基本完成了，但是 WeCOS 的能力还不仅于此，还有一些 高级功能 欢迎你来探索：

设置图片后缀

有些时候，我们需要限制上传图片的格式，例如只允许 jpg 格式，可以通过WeCOS提供的图片后缀配置项来定义 WeCOS默认支持 jpg,png,gif 三种格式，假如还需要添加其他格式，例如 webp，可以在该配置项中添加


"uploadFileSuffix": [".jpg",".png",".gif",".webp"]

设置图片黑名单

开发过程中，某些特定的图片我们不希望被上传，可以通过 WeCOS 的黑名单配置来解决这个问题，配置后上传程序会自动忽略掉这些图片黑名单配置支持目录或具体到文件名的写法：


"uploadFileBlackList": ["./images/logo.png", "./logo/"]

自定义域名

如果希望 COS 文件链接使用自定义的域名，可以配置 targetHost 代替默认域名，可以省略 https:// ：


"targetHost": "https://example.com"

如果代码中的图片链接想换一个域名，可以配置 replaceHost targetHost 来实现。


"replaceHost": "https://wx-12345678.myqcloud.com",
"targetHost": "https://example.com"

开启图片压缩

图片上传到 COS 之后虽然大大减轻了程序包的大小，但如果图片自身体积过大，访问速度也会影响到用户体验 WeCOS 还额外提供了基于腾讯云万象优图的图片压缩功能。首先，需要在万象优图控制台创建 COS 的同名 bucket。然后，开启该选项，资源将被压缩后上传（注：如果图片已经小到一定程度，压缩后大小可能不会变化）