Wepy開發小程序文檔

1. 環境配置

（1） 安裝nodejs,下載地址：https://nodejs.org/zh-cn/

（2） 全局安裝或更新WePY命令行工具，在命令行中執行

npm install wepy-cli –g

1. 項目初始化

(1) 建立項目：wepy init standard cust

(2) 切換至項目目錄：cd cust

(3) 安裝依賴：npm install

(4) 開啓實時編譯: wepy build –watch

(5) 打開微信開發者工具，建立項目，目錄選擇dist

1. 項目目錄結構

├── dist                   小程序運行代碼目錄（該目錄由WePY的build指令自動編譯生成，請不要直接修改該目錄下的文件）

├── node_modules           npm包

├── src                    代碼編寫的目錄（該目錄爲使用WePY後的開發目錄）

|   ├── components         WePY組件目錄（組件不屬於完整頁面，僅供完整頁面或其餘組件引用）

├── helper                 公用js 

|   |   ├── ajax.js        ajax負責和後端的交互

|   |   ├── filter.wxs     過濾器

|   |   ├── func.js        公用方法

|   |   ├── host.js        域名配置

|   |   ├──WxValidate.js   表單驗證的方法

 

|   ├── pages              WePY頁面目錄（屬於完整頁面）

|   |   ├── index.wpy      index頁面（經build後，會在dist目錄下的pages目錄生成index.js、index.json、index.wxml和index.wxss文件）

|   └── app.wpy            小程序配置項（全局數據、樣式、聲明鉤子等；經build後，會在dist目錄下生成app.js、app.json和app.wxss文件）

|   ├── mixins             混合代碼

|   |   ├──bindValue.js    綁定數據的混合代碼

|   |   ├──listMixins.js   列表頁的混合代碼

└── package.json           項目的package配置

1. 注意事項

(1) 關閉ES6轉ES5選項，關閉。 重要：未關閉會運行報錯。

(2) 關閉上傳代碼時樣式自動補全選項，關閉。 重要：某些狀況下漏掉此項也會運行報錯。

(3) 關閉代碼壓縮上傳選項，關閉。重要：開啓後，會致使真機computed, props.sync 等等屬性失效。

(4) 開啓代碼驗證後，要注意空格和分號

(5) 使用button跳轉受權頁面時沒效果

1. API

(1)ajax 調用ajax方法時須要傳的參數/**ajax

 * @param {Object} before 請求前的詢問

 * @param {Object} loading 請求過程當中的loading

 * @param {Object} fn 請求完後執行的回調

 * @param {Object} data 請求的參數

 * @param {Object} modal 請求完後的對話框

 * @param {Object} hint 請求完後的提示框

 */

(2) WxValidate表單驗，調用此方法時須要實例化這個對象，初始化這個對象時，將驗證規則和

驗證字段傳進去

/**

 * 表單驗證

 * @param {Object} rules 驗證字段的規則

 * @param {Object} messages 驗證字段的提示信息

 *

 */

 

(3) 在原生代碼裏wepy.$instance代替getApp()