詳解微信小程序開發(項目從零開始)


一、序

  微信小程序,估計大家都不陌生,現在應用場景特別多。今天就系統的介紹一下小程序開發。注意,這里只從項目代碼上做解析,不涉及小程序如何申請、打包、發布的東西。(這些跟着微信官方文檔的流程走就好)。好了廢話不多說,看目錄。

  注: 小程序是一套特殊的東西,融合了原生和web端。他是一個不完整的瀏覽器對象,所以很多DOM 、 BOM 的東西無法使用,但是他又通過微信APP實現了多線程。

 

二、 目錄

  1、如何創建一個微信小程序

  2、准備工作(讓編譯器支持小程序開發,我用的webstrom,hbuilderX也不錯)

  3、基礎文件目錄詳解

  4、創建常見的項目級別目錄

  5、基礎語法詳解

  6、實現頁面跳轉

  7、wx.request 的封裝

  8、使用 npm (引入 weui、moment等插件)

  9、封裝微信小程序可復用組件

  10、總結

 

 

三、如何創建小程序

  很簡單,首先下載微信開發者工具,下載穩定版本的就好。 下載  然后,創建小程序,可以參考下述圖片:

            

  注意正式的小程序需要審批,拿到正式的APPID,我們測試的或者暫時沒有的可點那個測試的appid,小程序模板選擇默認就好。按照這樣的流程走完,我們就創建完一個小程序了。

 

 

四、webstrom支持小程序開發

  創建完小程序之后,我們先不着急開發。工欲善其事必先利其器,微信開發者工具有點卡,而且功能少,開發效率很低。所以我們還是改造自己的編譯器,這里只介紹2種方法。一是 hbuilderX,他有支持小程序的模塊,很小巧的一款編譯器; 二是 webstorm,我用的他,在這介紹一下配置的方法,其他的大家自行google吧。

  1、支持wxml和wxss的文件類型,有語法高亮。 打開webstorm編譯器,依次點擊    文件 -- 設置 -- 編輯器 -- 文件類型 , 找到 html文件,添加  *.wxml;  找到Cascading style Sheet ,添加 *.wxss。就OK了

  2、支持小程序代碼提醒。 下載   這個文件,然后,把他放到一個顯眼的地方; 然后, webstorm  點擊  文件 -- 導入設置 ,找到這個下載的文件,點擊確定即可。

  以上就是webstorm支持小程序語法的操作。

    

 

五、基礎文件目錄詳解

  

  然后解釋一下小程序的目錄結構。

    project.config.json: 小程序的配置文件,包含項目打包配置、上傳代碼自動壓縮等等,是一些開發、打包之類的配置。

    app.json: 當前項目的配置文件。包括項目的頁面引入、導航條顏色、導航條標題 等等,是項目具體到代碼開發上的配置。介紹幾個配置:

        pages: 包含的頁面。每次新增頁面都得在這里引入,否則新頁面的json配置等無法生效。 注意pages中頁面先寫的先渲染,所以數組第一條也就是我們的首頁。

        window: 配置所有頁面導航條字體、顏色、背景色等

    app.js:   小程序入口文件。生成小程序實例,App({}), 通常在這獲取用戶信息、授權信息、定義全局變量等。

    app.wxss: 小程序全局 style 文件。對整個項目頁面生效。通常規定項目的 字體、基礎顏色,定義一些公共樣式。

    utils:  工具函數目錄。通常用來放一些公共的js方法。比如封裝的request請求,一些別的處理數據什么的方法。

    pages: 小程序的頁面目錄。所有的小程序頁面,都寫在這里面。

 

 

六、完善項目目錄

  上邊大致解釋了一下小程序的基礎文件,現在按照常見的規范完善一下項目目錄,這里面包含一些個人見解,有需要的參考即可。先看一下結果:

    

 

  現在解釋一下這些目錄:

    components: 我們封裝的小程序可復用組件。

    constants: 一些項目中的常亮。

    image: 用到的圖片。

    services: 用到的所有接口目錄

  大致就新建了這幾個,如果有別的需求,根據自己的情況增加。

 

  

七、基礎語法詳解

  現在大致解釋一下小程序的語法。首先, 創建新頁面,默認都創建 *.wxml   *.wxss  *.js   *.json  和我們平時寫的代碼差不多,都是html js css,多了個json配置文件

    *.json:常用的屬性有2大塊,navigationBarTitleText  相關的設置頂部標題的, usingComponents 引用的組件

    *.js: getApp() 獲取小程序實例,拿全局變量等; Page({}) 創建頁面; data 當前頁面的變量;onLoad 生命周期,頁面加載完畢。

    *.wxml:注意,小程序支持的標簽很少,像 span 是支持的,div不支持,一般用view代替塊級,span、text 代替行級。

    *.wxss:大部分css選擇器不支持,支持的好像才5個,想支持less等得自己配置

    

// json文件
{
  "navigationBarBackgroundColor": "#fff",
  "navigationBarTextStyle": "black",
  "navigationBarTitleText":"我的",
  "usingComponents": {
    "menu": "/components/menu/index"
  }
}

// js文件
const app = getApp()
Page({
  data: {},
  
  onLoad: function () {},

})

 

 

八、實現頁面跳轉

  和通常的web開發一樣,小程序頁面跳轉頁分2中,wxml中的vavigator標簽,以及js的navigator相關的api。路由跳轉的方法有好幾個,這里不一一贅述了,常用的直接跳轉

wx.navigateTo,重定向 wx.redirectTo等等,具體的請看官方文檔。這里強調一下路由傳參,很簡單:
1、少量數據。直接問號傳參。然后在目標頁面的onLoad方法中通過options參數接收。
2、大量數據。直接塞到全局變量里面。

    

// wxml跳轉頁面
<navigator url="/pages/my{{item.path}}" class="navigator">
      <image class="imgIcon" src="{{item.icon}}"></image>
      <view class="navigator-text" data-id="{{item.key}}" bindtap="handleMenuTap">{{item.name}}</view>
 </navigator>

//js跳轉頁面
wx.navigateTo({
      url: `/pages/my/appointDetail/index?_id=${this.data.marker.id}`
    })

//路由傳參如何接收
  onLoad: function (options) {
    console.log(options)
  },
 

 

九、wx.request 的封裝

  在utils中新建request.js,簡單封裝了一下,一些數據要全局配置的都引進來,然后做了些錯誤的統一處理,沒什么難度,不過要特別注意一下cookie的攜帶。具體代碼如下: 

  

const app = getApp()
export default function request(url, options = {}) {
  return new Promise(function (resolve, reject) {
    wx.request({
      url: `${app.origin}${url}`,
      method: 'GET',
      ...options,
      data: options.data,
      header: {
        'content-type': 'application/json',
        'cookie': wx.getStorageSync("cookie")
      },
      success: function (res) {
        //重新授權登錄
        if (res.statusCode === 401){
          wx.redirectTo({url: '/pages/login/index'})
          return
        }else if (res.statusCode !== 200) {
          reject({ error: '服務器忙,請稍后重試', code: 500 });
          return
        } else {
          if (url === '/api/cdz/user/weixin/login') {
            const cookie = res.header["set-cookie"] || res.header["Set-Cookie"];
        
if (cookie) wx.setStorageSync("cookie", cookie); } resolve(res.data); } }, fail: function (res) { // fail調用接口失敗 if (url === '/api/cdz/user/weixin/login') { const cookie = res.header["set-cookie"] || res.header["Set-Cookie"]; if (cookie) wx.setStorageSync("cookie", cookie); } reject({ error: '網絡錯誤', code: 0 }); } }) }) }

  然后我們使用的時候直接使用封裝好的request方法,這樣所有的api就封裝成一個個函數。我們在頁面中直接import引入調用即可。

  

import request from "../utils/request";
import { stringify } from "../utils/util"

export function testPost(data) {
  return request(`/api/test/post`, {
    method: 'PUT',
    data,
  })
}

export function testGet(data) {
  return request(`/api/test/get`)
}

 

 

十、使用 npm (引入 weui、moment等插件)

  因為小程序使用的是不完整的瀏覽器對象,所以很多js包都是不好使的,比如jquery之類的。所以npm基本是廢了,能用的依賴包很少,具體哪些能用得自己發掘了。這里還是要介紹一下小程序如何使用npm,畢竟有些包還是要用的。

  1、打開 微信開發者工具 -- 點擊 詳情 -- 勾選 使用npm模塊

  2、打開命令行,進入項目的根目錄下, npm init 初始化npm

  3、npm i 。。。安裝你需要的依賴

  4、打開 微信開發者工具 -- 點擊 工具 -- 點擊 構建npm。 此時小程序會將 node_modules 文件編譯打包,生成新目錄 miniprogram_npm ,

  5、在需要用到的頁面的js文件中,const moment= require('moment') 引入,直接使用即可

  6、最后記得忽略文件。新建 .gitignore 文件,node_modules 、 package_lock.json 等文件不需要上傳,最好只保留小程序的npm構建包,用什么依賴也是的那個下載。這個到不是必須的

  ps: 特殊注意一下weui的引入,這個ui庫是純css的,沒有js文件,所以他沒法用npm引入,而是直接下載文件,我直接丟到根目錄下,然后在 app.wxss 文件的開頭引入  

@import 'weui.wxss';,這樣使用的

 

 

十一、封裝微信小程序可復用組件

  現在篇幅有點太長了,這個另寫一篇,有需要的可以去看。

十二、總結

  以上就是我開發小程序的一些經驗和總結,希望能幫到你。另外,整套程序的骨架(業務代碼刪掉了)我會上傳到github,下載 有需要的可以去下載,記得點個贊,哈哈。

  最后,我會另寫一篇博客,寫一下 如何封裝小程序 組件,並附上 我開發小程序遇到的坑,以及對應的解決方法。

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM