一個(gè)小時(shí)快速搭建微信小程序的方法步驟

「小程序」這個(gè)劃時(shí)代的產(chǎn)品發(fā)布快一周了，互聯(lián)網(wǎng)技術(shù)人都在摩拳擦掌，躍躍欲試?？墒切〕绦蚰壳斑€在內(nèi)測(cè)，首批只發(fā)放了 200 個(gè)內(nèi)測(cè)資格（淚流滿面）。本以為沒(méi)有 AppID 這個(gè)月就與小程序無(wú)緣了，慶幸的是微信這兩天發(fā)布了正式版開(kāi)發(fā)者工具，無(wú)需內(nèi)測(cè)邀請(qǐng)也可以嘗鮮了。

因此也就有了我與「小程序」的初體驗(yàn)，而我的感受只有一個(gè)字——爽！

選擇哪個(gè)「小程序」Demo？

在知名同性交友網(wǎng)站 Github 上，「小程序」的 Demo 不少，但是大多只是簡(jiǎn)單的 API 演示，有的甚至直接把頁(yè)面數(shù)據(jù)寫在了 json 文件里（分明有網(wǎng)絡(luò)請(qǐng)求 API）。我想體驗(yàn)的是能夠?qū)⒎?wù)端和小程序端無(wú)縫連接起來(lái)（體驗(yàn)夠爽）的項(xiàng)目。最終，我選擇了騰訊云官方推出的「小相冊(cè)」項(xiàng)目。

「小相冊(cè)」主要實(shí)現(xiàn)了以下功能：

• 列出對(duì)象存儲(chǔ) COS 中的圖片列表。
• 點(diǎn)擊左上角上傳圖片圖標(biāo)，可以調(diào)用相機(jī)拍照或從手機(jī)相冊(cè)選擇圖片，并將選中的圖片上傳到 對(duì)象存儲(chǔ) COS 中。
• 輕按任意圖片，可進(jìn)入全屏圖片預(yù)覽模式，并可左右滑動(dòng)切換預(yù)覽圖片。
• 長(zhǎng)按任意圖片，可將其保存到本地，或從 對(duì)象存儲(chǔ) COS 中刪除。

效果演示圖（受開(kāi)發(fā)工具的限制，部分功能尚未實(shí)現(xiàn)）

對(duì)象存儲(chǔ)服務(wù)（Cloud Object Service）是騰訊云推出的面向企業(yè)和個(gè)人開(kāi)發(fā)者提供的高可用，高穩(wěn)定，強(qiáng)安全的云端存儲(chǔ)服務(wù)?？梢詫⑷我鈹?shù)量和形式的非結(jié)構(gòu)化數(shù)據(jù)放入COS，并在其中實(shí)現(xiàn)數(shù)據(jù)的管理和處理。

之所以選擇騰訊云的 Demo，一是因?yàn)樗球v訊自家推出的，項(xiàng)目的質(zhì)量有保障；二是因?yàn)樗巧儆械募戎v小程序開(kāi)發(fā)，又介紹云端部署的項(xiàng)目。

稍微有點(diǎn)經(jīng)驗(yàn)的程序員都知道，架構(gòu)要?jiǎng)屿o分離，靜態(tài)文件最好不要放在自己的服務(wù)器上，要放在專門用來(lái)存儲(chǔ)的對(duì)象存儲(chǔ)服務(wù)器COS上，并且用CDN 加速?！感∠鄡?cè)」后端采用的是 Node.js，Nginx作為反向代理。

第一步：搭開(kāi)發(fā)環(huán)境

首先，我們需要在本地搭建好微信「小程序」的開(kāi)發(fā)環(huán)境。即下載開(kāi)發(fā)者工具。微信官方已經(jīng)推出了正式版 IDE，大家沒(méi)有必要再去下載破解版了。打開(kāi)官網(wǎng)下載頁(yè)面，根據(jù)自己的操作系統(tǒng)選擇。我使用的是 Mac 版。

安裝好之后打開(kāi)運(yùn)行，會(huì)要求微信掃碼登陸。之后，就可以看到創(chuàng)建項(xiàng)目的頁(yè)面了。

選擇添加項(xiàng)目，沒(méi)有 AppID 就選無(wú)（如果亂寫會(huì)報(bào)錯(cuò)，到時(shí)可能無(wú)法進(jìn)入項(xiàng)目）。如果你選擇的項(xiàng)目目錄為空，請(qǐng)如圖所示勾選在“當(dāng)前目錄中創(chuàng)建quick start項(xiàng)目”。

點(diǎn)擊“添加項(xiàng)目”之后，我們會(huì)進(jìn)入開(kāi)發(fā)工具的調(diào)試頁(yè)面。

第二步：下載「小相冊(cè)」源碼

接下來(lái)，我們下載「小相冊(cè)」的源碼。可以選擇直接從騰訊云官網(wǎng)提供的鏈接下載，也可以從騰訊云團(tuán)隊(duì)的 Github 倉(cāng)庫(kù)拉取。我推薦從 Github 倉(cāng)庫(kù)拉取，這樣可以及時(shí)獲取最新的代碼。

git clone https://github.com/CFETeam/weapp-demo-album.git

最終，我們會(huì)得到類似這樣的文件目錄。

簡(jiǎn)單解釋下目錄結(jié)構(gòu)：

• applet（或app）: 「小相冊(cè)」應(yīng)用包代碼，可直接在微信開(kāi)發(fā)者工具中作為項(xiàng)目打開(kāi)。
• server: 搭建的Node服務(wù)端代碼，作為服務(wù)器和app通信，提供 CGI 接口示例，用于拉取圖片資源、上傳圖片、刪除圖片。
• assets：「小相冊(cè)」的演示截圖。

源碼下載完成之后，我們打開(kāi)微信 web 開(kāi)發(fā)者工具，新建項(xiàng)目「小相冊(cè)」，選擇目錄applet（或app）。

「小相冊(cè)」源碼分析

在進(jìn)行部署之前，我們來(lái)簡(jiǎn)單分析一下「小相冊(cè)」的具體代碼。畢竟只看效果不是我們的目的，我們的目的是以「小相冊(cè)」為例，了解如何開(kāi)發(fā)小程序并與服務(wù)端進(jìn)行交互。

「小相冊(cè)」包含一個(gè)描述整體程序的 app 和多個(gè)描述各自頁(yè)面的 page。主程序 app 主要由三個(gè)文件組成，分別是 app.js（小程序邏輯）、app.json（小程序公共設(shè)置）和 app.wxss（小程序公共樣式表），其中前兩個(gè)為必備文件。config.js 文件中包含了一些部署域名的設(shè)置，現(xiàn)在不用管。

在 pages 目錄下，有兩個(gè) page 頁(yè)面，分別是 index 和 album。頁(yè)面結(jié)構(gòu)算是比較簡(jiǎn)單的，其中 index 是小程序啟動(dòng)時(shí)默認(rèn)進(jìn)入的頁(yè)面。每個(gè)頁(yè)面下，至少要有 .js（頁(yè)面邏輯）和 .wxml（頁(yè)面結(jié)構(gòu)）兩個(gè)文件，.wxss（頁(yè)面樣式表）和 .json（頁(yè)面配置）文件為選填。你可能注意到了，這些文件的文件名與父目錄的名稱相同。這是微信官方的規(guī)定，目的是減少配置項(xiàng)，方便開(kāi)發(fā)者。

接下來(lái)我們以 index 頁(yè)面為例做簡(jiǎn)單的解釋。index.wxml 是這個(gè)頁(yè)面的表現(xiàn)層文件，其中的代碼非常簡(jiǎn)單，可以分為上下兩大部分。

<view>
  <view class="page-top">
    <text class="username">恭喜你</text>
    <text class="text-info">成功地搭建了一個(gè)微信小程序</text>
    <view class="page-btn-wrap">
      <button class="page-btn" bindtap="gotoAlbum">進(jìn)入相冊(cè)</button>
    </view>
  </view>
  <view class="page-bottom">
    <text class="qr-txt">分享二維碼邀請(qǐng)好友結(jié)伴一起寫小程序！</text>
    <image src="../../images/qr.png" class="qr-img"></image>
    <image src="../../images/logo.png" class="page-logo"></image>
  </view>
</view>

頁(yè)面的演示效果如下：

我們看到，頁(yè)面上有一個(gè)“進(jìn)入相冊(cè)”的按鈕。正常理解，點(diǎn)擊后該按鈕后我們就可以進(jìn)入相冊(cè)了（這不廢話嘛）。那小程序背后是怎樣實(shí)現(xiàn)該操作的呢？

在 index.wxml 中，我們發(fā)現(xiàn)對(duì)應(yīng)的 button 標(biāo)簽上定義了一個(gè) bindtap 屬性，綁定了一個(gè)叫做 gotoAlbum 的方法。而這個(gè)方法可以在 index.js 文件中找到。事實(shí)上，文件中也只定義了這一個(gè)方法，執(zhí)行的具體動(dòng)作就是跳轉(zhuǎn)到 album 頁(yè)面。

Page({
  // 前往相冊(cè)頁(yè)
  gotoAlbum() {
    wx.navigateTo({ url: '../album/album' });
  },
});

album.js 頁(yè)面中編寫了程序的主要邏輯，包括選擇或拍攝圖片、圖片預(yù)覽、圖片下載和圖片刪除；album.wxml 中三種視圖容器 view、scroll-view、swiper均有使用，還提供了消息提示框 toast。具體方法和視圖的實(shí)現(xiàn)請(qǐng)查看項(xiàng)目源碼。所有的這些功能都寫在 Page 類中。

lib 目錄下提供了小程序會(huì)用的一些輔助函數(shù)，包括異步訪問(wèn)和對(duì)象存儲(chǔ) COS 的 API。

總的來(lái)說(shuō)，和微信官方宣傳的一樣，在開(kāi)發(fā)者工具下進(jìn)行小程序的開(kāi)發(fā)，效率確實(shí)提高了很多，而且有很多微信提高的組件和 API。所以，在開(kāi)發(fā)速度這點(diǎn)上的體驗(yàn)還是非常爽的。

另外，由于「小相冊(cè)」需要使用諸多云端能力，如圖片的上傳和下載，我們還需要進(jìn)行服務(wù)器端的部署和設(shè)置。具體請(qǐng)看接下來(lái)的步驟。

第三步：云端部署 server 代碼

雖然服務(wù)端的開(kāi)發(fā)不是本文的重點(diǎn)，但是為了全面地體驗(yàn)「小相冊(cè)」的整個(gè)開(kāi)發(fā)部署流程，我們還是有必要了解服務(wù)端的部署，這里我們使用的是騰訊云。

如果你想更爽一點(diǎn)，那么可以選擇騰訊云官方提供的小程序云端鏡像。「小相冊(cè)」的服務(wù)器運(yùn)行代碼和配置已經(jīng)打包成騰訊云 CVM 鏡像，可以直接使用?？芍^是一鍵部署好云端。

如果你以前沒(méi)有使用過(guò)騰訊云，可以選擇免費(fèi)試用（我已經(jīng)領(lǐng)取了 8 天的個(gè)人版服務(wù)器），或者領(lǐng)取禮包以優(yōu)惠的價(jià)格購(gòu)買所需的服務(wù)。

你也可以選擇將「小相冊(cè)」源碼中的server文件夾上傳到自己的服務(wù)器。

第四步：準(zhǔn)備域名和配置證書

如果你已經(jīng)有騰訊云的服務(wù)器和域名，并配置好了 https，那么可以跳過(guò)第 4-6 步。

在微信小程序中，所有的網(wǎng)絡(luò)請(qǐng)求受到嚴(yán)格限制，不滿足條件的域名和協(xié)議無(wú)法請(qǐng)求。簡(jiǎn)單來(lái)說(shuō)，就是你的域名必須走 https 協(xié)議。所以你還需要為你的域名申請(qǐng)一個(gè)證書。如果沒(méi)有域名，請(qǐng)先注冊(cè)一個(gè)。由于我們沒(méi)有收到內(nèi)測(cè)，也就暫時(shí)不用登錄微信公眾平臺(tái)配置通信域名了。

第五步：Nginx 配置 https

微信小程序云端示例鏡像中，已經(jīng)部署好了 Nginx，但是還需要在 /etc/nginx/conf.d 下修改配置中的域名、證書、私鑰。

請(qǐng)將紅框部分換成自己的域名和證書，并且將 proxy_pass 設(shè)置為 Node.js 監(jiān)聽(tīng)的端口，我的是 9993。

配置完成后，重新加載配置文件并且重啟 Nginx。

sudo service nginx reload
sudo service nginx restart

第六步：域名解析

我們還需要添加域名記錄，將域名解析到我們的云服務(wù)器上，這樣才可以使用域名進(jìn)行 https 服務(wù)。在騰訊云注冊(cè)的域名，可以直接使用云解析控制臺(tái)來(lái)添加主機(jī)記錄，直接選擇上面購(gòu)買的 CVM。

解析生效后，我們的域名就支持 https 訪問(wèn)了。

第七步：開(kāi)通和配置 COS

由于我們希望實(shí)現(xiàn)動(dòng)靜分離的架構(gòu)，所以選擇把「小相冊(cè)」的圖片資源是存儲(chǔ)在 COS 上的。要使用 COS 服務(wù)，需要登錄 COS 管理控制臺(tái)，然后在其中完成以下操作。

點(diǎn)擊創(chuàng)建 Bucket。會(huì)要求選擇所屬項(xiàng)目，填寫相應(yīng)名稱。這里，我們只需要填上自己喜歡的 Bucket 名稱即可。

然后在 Bucket 列表中，點(diǎn)擊剛剛創(chuàng)建的 Bucket。然后在新頁(yè)面點(diǎn)擊“獲取API密鑰”。

彈出的頁(yè)面中包括了我們所需要的三個(gè)信息：唯一的 APP ID，一對(duì)SecretID和SecretKey（用于調(diào)用 COS API）。保管好這些信息，我們?cè)谏院髸?huì)用到。

最后，在新的 Bucket 容器中創(chuàng)建文件夾，命名為photos。這點(diǎn)后面我們也會(huì)提到。

第八步：?jiǎn)?dòng)「小相冊(cè)」的服務(wù)端

在官方提供的鏡像中，小相冊(cè)示例的 Node 服務(wù)代碼已部署在目錄 /data/release/qcloud-applet-album 下。進(jìn)入該目錄，如果是你自己的服務(wù)器，請(qǐng)進(jìn)入相應(yīng)的文件夾。

cd /data/release/qcloud-applet-album

在該目錄下，有一個(gè)名為 config.js 的配置文件（如下所示），按注釋修改對(duì)應(yīng)的 COS 配置：

module.exports = {
  // Node 監(jiān)聽(tīng)的端口號(hào)
  port: '9993',
  ROUTE_BASE_PATH: '/applet',

  cosAppId: '填寫開(kāi)通 COS 時(shí)分配的 APP ID',
  cosSecretId: '填寫密鑰 SecretID',
  cosSecretKey: '填寫密鑰 SecretKey',
  cosFileBucket: '填寫創(chuàng)建的公有讀私有寫的bucket名稱',
};

另外，cd ./routes/album/handlers，修改 list.js，將 const listPath 的值修改為你的Bucket 下的圖片存儲(chǔ)路徑。如果是根目錄，則修改為 '/'。當(dāng)前服務(wù)端的代碼中將該值設(shè)置為了 '/photos' ，如果你在第七步中沒(méi)有創(chuàng)建該目錄，則無(wú)法調(diào)試成功。

小相冊(cè)示例使用 pm2 管理 Node 進(jìn)程，執(zhí)行以下命令啟動(dòng) node 服務(wù)：

pm2 start process.json

第九步：配置「小相冊(cè)」通信域名

接下來(lái)，在微信 web 開(kāi)發(fā)者工具打開(kāi)「小相冊(cè)」項(xiàng)目，并把源文件config.js中的通訊域名 host 修改成你自己申請(qǐng)的域名。

將藍(lán)色框內(nèi)的內(nèi)容修改為自己的域名

然后點(diǎn)擊調(diào)試，即可打開(kāi)小相冊(cè)Demo開(kāi)始體驗(yàn)。

最后提示一點(diǎn)，截止目前為止，微信小程序提供的上傳和下載 API 無(wú)法在調(diào)試工具中正常工作，需要用手機(jī)微信掃碼預(yù)覽體驗(yàn)。但是由于沒(méi)有內(nèi)測(cè)資格，我們暫時(shí)是沒(méi)辦法體驗(yàn)了。

嗯，就這點(diǎn)不夠爽，沒(méi)有內(nèi)測(cè)邀請(qǐng)。

更新：騰訊云還寫了另外3個(gè)demo的小程序教程，大家也可以看看。

以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持億速云。