開發規范

uniapp官方開發文檔

文檔地址：https://uniapp.dcloud.io/

uni-app規范

為了實現多端兼容，綜合考慮編譯速度、運行性能等因素，uni-app 約定了如下開發規范：

  • 頁面文件遵循 Vue 單文件組件 (SFC) 規范
  • 組件標簽靠近小程序規范，詳見uni-app 組件規范
  • 接口能力（JS API）靠近微信小程序規范，但需將前綴 wx 替換為 uni，詳見uni-app接口規范
  • 數據綁定及事件處理同 Vue.js 規范，同時補充了App及頁面的生命周期
  • 為兼容多端運行，建議使用flex布局進行開發

業務規范

一、所有請求后端api的操作都需在api目錄里新建對應的js文件

例如：/api/address.js

  1. import request from '@/utils/request'
  3. // api地址
  4. const api = {
  5.   list: 'address/list',
  6.   add: 'address/add'
  7. }
  9. // 收貨地址列表
  10. export const list = (param) => {
  11.   return request.get(api.list, param)
  12. }
  14. // 新增收貨地址
  15. export const add = (data) => {
  16.   return request.post(api.add, { form: data })
  17. }

二、request請求必須使用https

同時在小程序管理員后臺配置可進行request請求的域名白名單

  1. // 錯誤的
  2. apiUrl: "http://www.yoshop.cn/index.php/api/"
  4. // 正確的
  5. apiUrl: "https://www.yoshop.cn/index.php/api/"

三、所有的業務頁面都應在pages目錄下

例如：pages/index/index.vue 商城首頁
例如：pages/goods/list.vue 商品列表頁

四、每個端，有每個端的管理規則，這不是uni-app在技術層面上可以抹平的：

  • 比如H5端的瀏覽器有跨域限制；
  • 比如微信小程序會強制要求https鏈接，并且所有要聯網的服務器域名都要配到微信的白名單中；
  • 比如App端，iOS對隱私控制和虛擬支付控制非常嚴格；
  • 比如App端，Android、國產rom各種兼容性差異，尤其是因為谷歌服務被墻，導致的push、定位等開發混亂的坑；
  • 如果你的App要使用三方sdk，比如定位、地圖、支付、推送…還要遵循他們的規則和限制；