說明 基於wexplus開發app是來新公司才接觸的,之前只是用過weex體驗過寫demo,當時就被用vue技術棧來開發app的開發體驗驚艷到了,這個開發體驗比react native要好很多,對於我這個純web前端來說簡直不要太好! weexplus是基於weex官方的二次開發版本,旨在解決wee ...
說明
基於wexplus開發app是來新公司才接觸的,之前只是用過weex體驗過寫demo,當時就被用vue技術棧來開發app的開發體驗驚艷到了,這個開發體驗比react native要好很多,對於我這個純web前端來說簡直不要太好!
weexplus是基於weex官方的二次開發版本,旨在解決weex官方配置麻煩、性能不好、開發體驗不好等問題。weexplus框架是這邊同事根據實際的項目抽離出來的開源框架,已經幫我們趟過很多坑了,具體組件用法在此不再贅述,link-放出文檔。本文僅為本人視角開發一個吉他學習app的踩坑之路記錄,記下以免後面再踩坑。
文章思路
文章可能會很長,在此分幾篇文章來寫,先占個坑:
- 用weexplus從0到1寫一個app(1)-環境搭建和首頁編寫
- 用weexplus從0到1寫一個app(2)-參數跳轉和文章列表及文章詳情、搜索頁面的編寫
- 用weexplus從0到1寫一個app(3)-視頻列表和視頻詳情的編寫
先看東西
app的ui界面與h5、小程式公用一套,所以做出來的界面也是基本一樣,這裡感謝以下楊伯伯提供的設計稿。
環境搭建
- node環境安裝(windows、mac稍有不同,具體安裝自行百度即可);
- weex環境安裝(前提是必須有node環境);
$ npm install weex-toolkit -g // -g表示全局安裝,下同
- weexplus環境的安裝,weexplus工具為我們提供了很多常用的開發功能,具體詳情查看weexplus文檔即可;
$ npm install weexplus -g
- 創建項目,按照官方文檔用weexplus create會遇到網速很慢的問題,我這裡是下載官方的boilerplate然後改名;
$ 瀏覽器訪問 https://github.com/weexplus/boilerplate,下載壓縮包得到文件boilerplate-master.zip;
$ 解壓boilerplate-master.zip得到文件夾boilerplate-master;
$ cd到跟boilerplate-master平級的目錄;
$ weexplus rename loveguitar com.loveguitar.23jt loveguitar;
$ cd loveguitar
$ npm install //安裝依賴包
$ npm run dev
$ weexplus start //運行改命令需要另外開一個終端,運行成功後谷歌瀏覽器會跳出一個新頁面,必須安裝谷歌瀏覽器
$ 下載安卓apk調試包(真機掃碼調試)地址 https://pan.baidu.com/s/16kJfMuyXX-Y_yhm5fHt79Q
至此,weexplus開發環境基本搭建完畢,如果需要打包安卓、ios的話,與原生開發一樣,自行百度即可解決。
項目目錄結構
如圖為weexplus腳手架項目目錄結構圖,我們平常開發主要在src
目錄里寫代碼,可以看到該目錄與vue項目目錄結構基本差不多。
開始寫代碼
在寫代碼前可以把腳手架里無用的代碼刪除掉,留下component
文件夾即可。先做的第一件事個人建議是依照原型或者設計稿的業務邏輯在src/busi
文件夾中按照業務模塊建好文件夾(以愛尚吉他為例):
map:琴行地圖功能模塊,裡面分為琴行地圖首頁、琴行詳情、琴行導航
news:文章模塊,裡面分為文章列表、文章詳情、標簽列表
search:文章搜索模塊
video:視頻教程模塊,裡面分為視頻模塊首頁,視頻列表、視頻詳情
寫一個首頁看看
子曰:“工欲善其事,必先利其器。”在寫首頁的代碼前在此安利一款切圖標註工具--藍湖, 大大提高設計師和開發的工作效率,具體使用參見官網介紹即可http://sos.lanhuapp.com/#/。
以上為首頁的設計圖,先來分析一下頁面結構,看看哪些可以復並且可以封裝為公共組件。如圖所示可以分為如下幾個模塊:
1(banner模塊),在componet文件夾下新建my-banner.vue文件
2(模塊標題),在componet文件夾下新建my-title.vue文件
3(菜單模塊),在componet文件夾下新建my-nav.vue文件
4(文章列表模塊兩個類型)在componet文件夾下新建news-item.vue文件
按照vue的規範分別在componet文件夾下新建my-banner.vue
、my-title.vue
·my-nav.vue
、news-item.vue
四個文件。
輪播圖組件my-banner.vue封裝
//src/component/my-banner.vue
<template>
<div class="banner-box">
<slider class="slider" :style="{'height':height,'width':width}" interval="1500" @change="onchange">
<div class="frame" :style="{'height':height,'width':width}" v-for="(item,index) in bannerList" :key="index">
<image :style="{'height':height,'width':width}" class="image" resize="cover" :src="item.pic" />
</div>
<indicator class="indicator"></indicator>
</slider>
</div>
</template>
這裡用到了weex官方的slider
和indicator
組件,具體的屬性用法參見weex文檔slider用法。考慮到輪播圖的尺寸不固定,在組件中暴露height(圖片高度)
和width(圖片寬度)
兩個屬性提供給父組件傳入。
在此註意幾個問題:
1.註意圖片標簽的寫法與web中使用vue稍有不同,web中是img,在weex中用image;
2.weex中不支持padding、margin、border屬性值的簡寫,如不支持padding:10px
和border:1px solid #dcdcdc這樣的寫法。
標題組件my-title.vue的封裝
//component/my-title.vue
<template>
<div class="about-title">
<text class="title-text">{{title}}</text>
<div v-if="url!=null&&url!=''" @click="goto(url)" class="more">
<text>更多</text>
<image src="http://hurely.u.qiniudn.com/20180601152782173548498.png" class="form-icon-r"/>
</div>
</div>
</template>
樣式方面沒什麼好說的,考慮到有些標題是沒有跳轉更多的,需要做一下判斷為空的情況。
在此註意幾個問題:
1.註意在weex中文字需要使用text標簽,考慮到後續可能會移植為web或者小程式,
text標簽最好用class來控制樣式;
2.weex預設支持flex佈局,考慮到後續可能會移植為web或者小程式,在需要
用到flex佈局的地方寫上display:flex屬性。
菜單組件my-nav.vue的封裝
//componet/my-nav.vue
<template>
<div class="nav">
<div class="nav-item" @click="goto(item.url)" v-for="(item,index) in navList" :key="index">
<image class="nav-icon" :style="{'width':width,'height':height}" :src="item.src" />
<text class="nav-text">{{item.text}}</text>
</div>
</div>
</template>
樣式方面沒什麼說的,考慮到會跳轉不同的頁面,註意在跳轉方法里做判斷即可。
列表組件news-item.vue的封裝
//componet/news-item.vue
<template>
<div v-if="type==1">
<div class="item-box" @click="click">
<div class="item-left">
<text class="left-text">{{item.title}}</text>
<div class="left-line"></div>
<text class="left-time">{{item.pubdate}}</text>
</div>
<div class="item-right">
<image :src="item.pic.src" mode="aspectFill" class="litpic" />
</div>
</div>
</div>
<div class="item-box2" v-else-if="type==2" @click="click">
<image :src="item.pic.src" mode="aspectFill" class="litpic2" />
<text class="box2-text">{{item.title}}</text>
</div>
</template>
可以看到我標記4的地方有兩處,在組件裡加一個type
作為判斷即可,列表點擊事件通過this.$emit
傳遞到父組件調用。至此首頁四個公共組件封裝完畢,下麵開始編寫首頁代碼。
首頁編寫
//busi/home.vue
<template>
<div class="app">
<scroller>
<banner-item :bannerList=bannerList></banner-item>
<div class="home-nav border">
<title-item title="熱門欄目" url=""></title-item>
<div class="nav-items">
<div class="nav-item" v-for="(item,index) in navList" :key="index" @click="goto(item.url)">
<image mode="aspectFit" :src="item.pic" class="nav-icon"/>
<text class="nav-text">{{item.title}}</text>
</div>
</div>
</div>
<div class="home-news border">
<title-item title="熱門文章" url="../news/list"></title-item>
<div v-for="(item,index) in newsItems" :key="index">
<homenews-item
type=1
@click="gotonews(item.id)"
:item="item"
></homenews-item>
</div>
</div>
<title-item title="熱門專輯" more="../video/index"></title-item>
<div class="hot-box">
<video-item
v-for="(ite,index) in videoitems" :key="index"
@click="gotovideo(ite)"
:item="ite"
type=2
></video-item>
</div>
<support-item></support-item>
</scroller>
</div>
</template>
樣式方面無需說明,這裡說一下數據請求的封裝。分別在busi/util文件夾新建文件request.js
和api.js
(非必須),其中request.js基於fly庫封裝(考慮到weex官方的數據請求庫有點坑,在此棄用),便於管理後端介面建議在api.js
文件中統一管理。
以下為fly.js
庫的封裝,具體使用參照fly.js
官方文檔,如果需要增加登錄攔截什麼的,可以在fly.interceptors.request.use
中增加即可。
//request.js
var Fly = require("flyio/dist/npm/weex");
var fly = new Fly;
//bmob雲資料庫的配置,非必須
const bmobConfig = {
applicationId:'applicationId',
restApiKey:'restApiKey',
secretKey:'secretKey',
masterKey:'masterKey'
}
var progress = weex.requireModule("progress")
var modal = weex.requireModule("modal")
//添加請求攔截器
fly.interceptors.request.use((request)=>{
progress.show();
//給所有請求添加自定義header
request.headers["X-Tag"]="flyio";
request.headers['X-Bmob-Application-Id'] = bmobConfig.applicationId;
request.headers['X-Bmob-REST-API-Key'] = bmobConfig.restApiKey;
request.headers['Content-Type'] = 'application/json';
//可以顯式返回request, 也可以不返回,沒有返回值時攔截器中預設返回request
return request;
})
//添加響應攔截器,響應攔截器會在then/catch處理之前執行
fly.interceptors.response.use(
(response) => {
//只將請求結果的data欄位返回
progress.dismiss();
return response.data
},
(err) => {
//發生網路錯誤後會走到這裡
progress.dismiss();
//return Promise.resolve("ssss")
}
)
module.exports = fly;
以下為後端介面統一管理文件api.js
/**
* @description 請求地址
*/
const baseUrl = 'http://baidu.com/';
const urls = {
videoList:'videoList',
videoContent:'videoContent',
amapGetaddress:'amapGetaddress',//高德地圖經緯度轉地址
home: baseUrl + 'home',//首頁
categoryIndex:baseUrl+'categoryIndex',//菜單分類 type=list顯示
categoryList:baseUrl+'categoryList',//參數cid通過categoryIndex獲得 page為分頁
tagList:baseUrl+'tagList',//標簽列表&id=7656&page=1
articleDetails:baseUrl+'articleDetails',//文章詳情
about:'about',//關於
search:baseUrl+'search',//&q=周傑倫&page=1
};
export default urls
數據請求實例,用過axios庫的應該很熟悉這種寫法
getData() {
const that = this;
fly.get(apis.home, {})
.then(res => {
let bannerList = [];
JSON.parse(res).article_hot.data.map((item,index)=>{
item.pic = item.pic.src;
bannerList.push(item)
})
that.bannerList = bannerList;
that.newsItems = JSON.parse(res).article_list;
})
.catch(error => {});
}
參考文檔
- weex官方文檔 https://weex.incubator.apache.org/cn/
- weexplus文檔 https://weexplus.github.io/doc/
- weexplus github倉庫 https://github.com/weexplus/boilerplate
- weexplus安卓端掃碼調試包下載 https://pan.baidu.com/s/16kJfMuyXX-Y_yhm5fHt79Q
一點私貨
基於同一套ui開發出來的愛尚吉他微信小程式版已經上線喜歡彈吉他的小伙伴可以關註一波