首頁(yè)?>?知識?資訊?>?小相冊微信小程序搭建過(guò)程?>?正文

小相冊微信小程序搭建過(guò)程

2019/5/13 0:00:00 · 稿源:傳誠信

微信小程序」這個(gè)劃時(shí)代的產(chǎn)品發(fā)布快一周了,互聯(lián)網(wǎng)技術(shù)人都在摩拳擦掌,躍躍欲試。

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

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

「小相冊」主要實(shí)現了以下功能:

  • 列出對象存儲 COS 中的圖片列表。

  • 點(diǎn)擊左上角上傳圖片圖標,可以調用相機拍照或從手機相冊選擇圖片,并將選中的圖片上傳到 對象存儲 COS 中。

  • 輕按任意圖片,可進(jìn)入全屏圖片預覽模式,并可左右滑動(dòng)切換預覽圖片。

  • 長(cháng)按任意圖片,可將其保存到本地,或從 對象存儲 COS 中刪除。

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

對象存儲服務(wù)(Cloud Object Service)是騰訊云推出的面向企業(yè)和個(gè)人開(kāi)發(fā)者提供的高可用,高穩定,強安全的云端存儲服務(wù)??梢詫⑷我鈹盗亢托问降姆墙Y構化數據放入COS,并在其中實(shí)現數據的管理和處理。

之所以選擇騰訊云的 Demo,一是因為它是騰訊自家推出的,項目的質(zhì)量有保障;二是因為它是少有的既講小程序開(kāi)發(fā),又介紹云端部署的項目。

稍微有點(diǎn)經(jīng)驗的程序員都知道,架構要動(dòng)靜分離,靜態(tài)文件最好不要放在自己的服務(wù)器上,要放在專(zhuān)門(mén)用來(lái)存儲的對象存儲服務(wù)器COS上,并且用CDN 加速?!感∠鄡浴购蠖瞬捎玫氖?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è)面,根據自己的操作系統選擇。我使用的是 Mac 版。

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

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

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


第二步:下載「小相冊」源碼

接下來(lái),我們下載「小相冊」的源碼??梢赃x擇直接從騰訊云官網(wǎng)提供的鏈接下載,也可以從騰訊云團隊的 Github 倉庫拉取。我推薦從 Github 倉庫拉取,這樣可以及時(shí)獲取最新的代碼。

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

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

簡(jiǎn)單解釋下目錄結構:

  • applet(或app): 「小相冊」應用包代碼,可直接在微信開(kāi)發(fā)者工具中作為項目打開(kāi)。

  • server: 搭建的Node服務(wù)端代碼,作為服務(wù)器和app通信,提供 CGI 接口示例,用于拉取圖片資源、上傳圖片、刪除圖片。

  • assets:「小相冊」的演示截圖。

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


「小相冊」源碼分析

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

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

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

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

恭喜你成功地搭建了一個(gè)微信小程序進(jìn)入相冊分享二維碼邀請好友結伴一起寫(xiě)小程序!

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

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

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

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

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

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

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

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


第三步:云端部署 server 代碼

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

如果你想更爽一點(diǎn),那么可以選擇騰訊云官方提供的小程序云端鏡像?!感∠鄡浴沟姆?wù)器運行代碼和配置已經(jīng)打包成騰訊云 CVM 鏡像,可以直接使用??芍^是一鍵部署好云端。

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

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


第四步:準備域名和配置證書(shū)

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

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


第五步:Nginx 配置 https

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

請將紅框部分換成自己的域名和證書(shū),并且將?proxy_pass?設置為 Node.js 監聽(tīng)的端口,我的是 9993。

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

sudo?service?nginx?reloadsudo?service?nginx?restart


第六步:域名解析

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

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


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

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

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

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

彈出的頁(yè)面中包括了我們所需要的三個(gè)信息:唯一的 APP ID,一對SecretID和SecretKey(用于調用 COS API)。保管好這些信息,我們在稍后會(huì )用到。

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


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

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

cd?/data/release/qcloud-applet-album

在該目錄下,有一個(gè)名為?config.js?的配置文件(如下所示),按注釋修改對應的 COS 配置:

module.exports?=?{//?Node?監聽(tīng)的端口號port:?'9993',ROUTE_BASE_PATH:?'/applet',cosAppId:?'填寫(xiě)開(kāi)通?COS?時(shí)分配的?APP?ID',cosSecretId:?'填寫(xiě)密鑰?SecretID',cosSecretKey:?'填寫(xiě)密鑰?SecretKey',cosFileBucket:?'填寫(xiě)創(chuàng  )建的公有讀私有寫(xiě)的bucket名稱(chēng)',};

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

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

pm2?start?process.json


第九步:配置「小相冊」通信域名

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

將藍色框內的內容修改為自己的域名

然后點(diǎn)擊調試,即可打開(kāi)小相冊Demo開(kāi)始體驗。

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

  • 相關(guān)推薦
  • 大家在看
熱文
  • 熱門(mén)
  • 最新
客戶(hù)服務(wù)
咨詢(xún)熱線(xiàn)

010-62199213

24小時(shí)咨詢(xún)熱線(xiàn)

139-1050-5354