21春《移動軟件開發》實驗一：第一個微信小程序

本次實驗介紹如何創建第一個小程序，包括新建項目、真機預覽和調試、代碼提交等內容；然后分析小程序的目錄結構。

開發小程序的第一步，你需要擁有一個小程序帳號，通過這個帳號你就可以管理你的小程序。

1. 申請帳號

打開：https://mp.weixin.qq.com 根據指引填寫信息和提交相應的資料，就可以擁有自己的小程序帳號。

在這個小程序管理平台，你可以管理你的小程序的權限，查看數據報表，發布小程序等操作。

登錄 https://mp.weixin.qq.com ，我們可以在菜單 “開發”-“開發設置” 看到小程序的 AppID 了 。

2. 安裝開發工具

前往 開發者工具下載頁面 ，根據自己的操作系統下載對應的安裝包進行安裝，有關開發者工具更詳細的介紹可以查看 《開發者工具介紹》 。

打開小程序開發者工具，用微信掃碼登錄開發者工具，准備開發你的第一個小程序吧！

3. 第一個小程序

新建項目選擇小程序項目，選擇代碼存放的硬盤路徑，填入剛剛申請到的小程序的 AppID，給你的項目起一個好聽的名字，最后，勾選 “創建 QuickStart 項目” （注意: 你要選擇一個空的目錄才會有這個選項），點擊確定，你就得到了你的第一個小程序了，點擊頂部菜單編譯就可以在微信開發者工具中預覽你的第一個小程序。接下來預覽這個小程序 的效果。

4. 編譯預覽

點擊工具上的編譯按鈕，可以在工具的左側模擬器界面看到這個小程序的表現，也可以點擊預覽按鈕，通過微信的掃一掃在手機上體驗你的第一個小程序。

5. 代碼組成

我們通過開發者工具快速創建了一個 QuickStart 項目。你可以留意到這個項目里邊生成了不同類型的文件:

• json 后綴的 JSON 配置文件

• wxml 后綴的 WXML 模板文件

• wxss 后綴的 WXSS 樣式文件

• js 后綴的 JS 腳本邏輯文件

接下來我們分別看這4種文件的作用。

5.1 JSON 配置

我們可以看到在項目的根目錄有一個 app.json 和 project.config.json，此外在 pages/logs 目錄下還有一個 logs.json，我們依次來說明一下它們的用途。

小程序配置 app.json ： 是當前小程序的全局配置，包括了小程序的所有頁面路徑、界面表現、網絡超時時間、底部 tab 等。QuickStart 項目里邊的 app.json 配置內容如下：

{
    "pages": ["pages/index/index", "pages/logs/logs"],
    "window": {
    "backgroundTextStyle": "light",
    "navigationBarBackgroundColor": "#fff",
    "navigationBarTitleText": "WeChat",
    "navigationBarTextStyle": "black"
    }
}

簡單說一下這個配置各個項的含義:

• pages字段 —— 用於描述當前小程序所有頁面路徑，這是為了讓微信客戶端知道當前你的小程序頁面定義在哪個目錄。
• window字段 —— 定義小程序所有頁面的頂部背景顏色，文字顏色定義等。

工具配置 project.config.json： 通常大家在使用一個工具的時候，都會針對各自喜好做一些個性化配置，例如界面顏色、編譯配置等等，當你換了另外一台電腦重新安裝工具的時候，你還要重新配置。考慮到這點，小程序開發者工具在每個項目的根目錄都會生成一個 project.config.json，你在工具上做的任何配置都會寫入到這個文件，當你重新安裝工具或者換電腦工作時，你只要載入同一個項目的代碼包，開發者工具就自動會幫你恢復到當時你開發項目時的個性化配置，其中會包括編輯器的顏色、代碼上傳時自動壓縮等等一系列選項。

頁面配置 page.json： 這里的 page.json 其實用來表示 pages/logs 目錄下的 logs.json 這類和小程序頁面相關的配置。如果你整個小程序的風格是藍色調，那么你可以在 app.json 里邊聲明頂部顏色是藍色即可。實際情況可能不是這樣，可能你小程序里邊的每個頁面都有不一樣的色調來區分不同功能模塊，因此我們提供了 page.json，讓開發者可以獨立定義每個頁面的一些屬性，例如剛剛說的頂部顏色、是否允許下拉刷新等等。

5.2 WXML 模板

從事過網頁編程的人知道，網頁編程采用的是 HTML + CSS + JS 這樣的組合，其中 HTML 是用來描述當前這個頁面的結構，CSS 用來描述頁面的樣子，JS 通常是用來處理這個頁面和用戶的交互。同樣道理，在小程序中也有同樣的角色，其中 WXML 充當的就是類似 HTML 的角色。打開 pages/index/index.wxml，你會看到以下的內容:

<view class="container">
  <view class="userinfo">
    <button wx:if="{{!hasUserInfo && canIUse}}">獲取頭像昵稱</button>
    <block wx:else>
      <image src="{{userInfo.avatarUrl}}" background-size="cover"></image>
      <text class="userinfo-nickname">{{userInfo.nickName}}</text>
    </block>
  </view>
  <view class="usermotto">
    <text class="user-motto">{{motto}}</text>
  </view>
</view>

和 HTML 非常相似，WXML 由標簽、屬性等等構成。但是也有很多不一樣的地方，闡述一下：

• 標簽名字有點不一樣： 往往寫 HTML 的時候，經常會用到的標簽是 div, p, span，開發者在寫一個頁面的時候可以根據這些基礎的標簽組合出不一樣的組件，例如日歷、彈窗等等。換個思路，既然大家都需要這些組件，為什么我們不能把這些常用的組件包裝起來，大大提高我們的開發效率。 從上邊的例子可以看到，小程序的 WXML 用的標簽是 view, button, text 等等，這些標簽就是小程序給開發者包裝好的基本能力，我們還提供了地圖、視頻、音頻等等組件能力。
• 多了一些 wx:if 這樣的屬性以及 {{ }} 這樣的表達式 ： 在網頁的一般開發流程中，我們通常會通過 JS 操作 DOM (對應 HTML 的描述產生的樹)，以引起界面的一些變化響應用戶的行為。例如，用戶點擊某個按鈕的時候，JS 會記錄一些狀態到 JS 變量里邊，同時通過 DOM API 操控 DOM 的屬性或者行為，進而引起界面一些變化。當項目越來越大的時候，你的代碼會充斥着非常多的界面交互邏輯和程序的各種狀態變量，顯然這不是一個很好的開發模式，因此就有了 MVVM 的開發模式（例如 React, Vue），提倡把渲染和邏輯分離。簡單來說就是不要再讓 JS 直接操控 DOM，JS 只需要管理狀態即可，然后再通過一種模板語法來描述狀態和界面結構的關系即可。

小程序的框架也是用到了這個思路，如果你需要把一個 Hello World 的字符串顯示在界面上。WXML 是這么寫 :

<text>{{msg}}</text>

JS 只需要管理狀態即可:

this.setData({msg: 'Hello World'})

通過 {{ }} 的語法把一個變量綁定到界面上，我們稱為數據綁定。僅僅通過數據綁定還不夠完整的描述狀態和界面的關系，還需要 if/else, for等控制能力，在小程序里邊，這些控制能力都用 wx: 開頭的屬性來表達。

5.3 WXSS樣式

WXSS 具有 CSS 大部分的特性，小程序在 WXSS 也做了一些擴充和修改。

• 新增了尺寸單位。在寫 CSS 樣式時，開發者需要考慮到手機設備的屏幕會有不同的寬度和設備像素比，采用一些技巧來換算一些像素單位。WXSS 在底層支持新的尺寸單位 rpx ，開發者可以免去換算的煩惱，只要交給小程序底層來換算即可，由於換算采用的浮點數運算，所以運算結果會和預期結果有一點點偏差。
• 提供了全局的樣式和局部樣式。和前邊 app.json, page.json 的概念相同，你可以寫一個 app.wxss 作為全局樣式，會作用於當前小程序的所有頁面，局部頁面樣式 page.wxss 僅對當前頁面生效。
• 此外 WXSS 僅支持部分 CSS 選擇器

5.4 JS交互邏輯

一個服務僅僅只有界面展示是不夠的，還需要和用戶做交互：響應用戶的點擊、獲取用戶的位置等等。在小程序里邊，我們就通過編寫 JS 腳本文件來處理用戶的操作。

<view>{{ msg }}</view>
<button bindtap="clickMe">點擊我</button>

點擊 button 按鈕的時候，我們希望把界面上 msg 顯示成 “Hello World”，於是我們在 button 上聲明一個屬性: bindtap ，在 JS 文件里邊聲明了 clickMe 方法來響應這次點擊操作：

Page({
  clickMe() {
    this.setData({msg: 'Hello World'})
  }
})

此外你還可以在 JS 中調用小程序提供的豐富的 API，利用這些 API 可以很方便的調起微信提供的能力，例如獲取用戶信息、本地存儲、微信支付等。

在前邊的 QuickStart 例子中，在 pages/index/index.js 就調用了 wx.getUserInfo 獲取微信用戶的頭像和昵稱，最后通過 setData 把獲取到的信息顯示到界面上。

6. 小程序的啟動

微信客戶端在打開小程序之前，會把整個小程序的代碼包下載到本地。緊接着通過 app.json 的 pages 字段就可以知道你當前小程序的所有頁面路徑:

{
  "pages": ["pages/index/index", "pages/logs/logs"]
}

這個配置說明在 QuickStart 項目定義了兩個頁面，分別位於 pages/index/index 和 pages/logs/logs。而寫在 pages 字段的第一個頁面就是這個小程序的首頁（打開小程序看到的第一個頁面）。

於是微信客戶端就把首頁的代碼裝載進來，通過小程序底層的一些機制，就可以渲染出這個首頁。

小程序啟動之后，在 app.js 定義的 App 實例的 onLaunch 回調會被執行:

App({
  onLaunch() {
    // 小程序啟動之后 觸發
  }
})

整個小程序只有一個 App 實例，是全部頁面共享的。接下來我們簡單看看小程序的一個頁面是怎么寫的。

7. 程序與頁面

你可以觀察到 pages/logs/logs 下其實是包括了4種文件的，微信客戶端會先根據 logs.json 配置生成一個界面，頂部的顏色和文字你都可以在這個 json 文件里邊定義好。緊接着客戶端就會裝載這個頁面的 WXML 結構和 WXSS 樣式。最后客戶端會裝載 logs.js，你可以看到 logs.js 的大體內容就是:

Page({
  data: { // 參與頁面渲染的數據
    logs: []
  },
  onLoad() {
    // 頁面渲染后 執行
  }
})

Page 是一個頁面構造器，這個構造器就生成了一個頁面。在生成頁面的時候，小程序框架會把 data 數據和 index.wxml 一起渲染出最終的結構，於是就得到了你看到的小程序的樣子。

在渲染完界面之后，頁面實例就會收到一個 onLoad 的回調，你可以在這個回調處理你的邏輯。

小結

大家在本節學習了如何創建第一個微信小程序，學習了小程序的代碼結構，同時，熟悉了微信開發工具，相信未來的課程中，大家可以較快地完成復雜的小程序開發。