Apicloud + Vue2 + Vant(有赞前端)+ Webpack4打包,是一个采用Vue数据绑定特性和Apicloud手机操控能力相结合的APP开发框架,此框架并非采用Vue的SPA单页面应用方式,而是遵从Apicloud的多页面原生渲染效率方式,Vue+Webpack只是为了提供更佳的ES2015+语法、模块分割和数据绑定代码体验,弥补Apicloud本身无法应用在庞大工程协作的缺点。
使用AVVW可以极速开发出流畅的商用级别APP,让你轻松应付各种开发需求
- dist 编译代码,连同config.xml上传到Apicloud发布App
- src 源代码,所有开发在此开始,除pages、templates目录外,其他目录可随意增删
- components vue公用模块
- libs 公共库
- pages Apicloud使用openWin和openFrame打开的页面,vue组件化
- templates Webpack编译时的模板文件
- api.js Apicloud前端库源文件,保留
- fastclick.min.js 移动端减少触点反馈时间
- index.html Apicloud入口文件
- page.ejs 将pages下vue编译为Apicloud可用的模板
- vue.js 未压缩vue库,用于开发环境
- vue.min.js 压缩vue库,用于生产环境
- .syncignore 不同步到Apploader的文件列表
- config.xml Apicloud配置文件
- 其他省略
git clone 或者 直接下载master包,cd进入包目录
#> npm i
#> npm run wifi-start 开wifi服务,wifi-stop 停止服务
#> npm run wifi-sync 真机wifi同步
#> npm run dev 开启本地测试
#> npm run build 编译
如无需高级配置,那么只需关注src下pages目录文件,而无需更改templates目录文件,这里说明一下pages文件:
任何vue语法都可以使用,但有一处要留意!
// 首先在全局window中带入 文件名 + Vue 的vue export object
window.homeVue = {
....
}
// 然后才export
export default window.homeVue
这是与本来vue直接export不同之处,因为在templates中的page.ejs模板文件中,需要从window中拿回vue export object来在页面上构建vue初始化!而components目录文件则无需如此!
由于框架并非采用Vue的SPA,所以无法在多页面间使用vue-router、vuex之类的单页面应用的数据共享技术,而只能采用Apicloud API提供的相关页面跳转传递、数据共享技术
框架默认home.html为App首页入口,你也可以修改其他页面为入口,只需修改templates下的index.html即可
api.openFrame({
name: 'home',
url: './home.html', // 修改此处对应pages的文件名即可 eg. ./main.html
})
npm run dev 开启测试服,但和一般的vue测试不同的是,你需要手动切换需要测试的页面,eg. http://localhost:8080/home.html,不用测试index.html,因为此文件是Apicloud所用,页面测试时遇到api is not defined不用理会,因为api是Apicloud App环境下才初始化的对象
浏览器预览是用来调节界面排版布局,体验性测试请使用真机App loader
你可以在vue中直接使用 api.xxx,也可以使用 this.$ac.xxx 来调用api sdk
vue支持大部分ES6语法,但要注意的是如果你修改templates下的page.ejs和index.html,请不要使用ES6语法,因为webpack默认没有转义模板文件
手机CPU和内存有限,而且Apicloud采用Hybird技术,在性能上尤其低端安卓上肯定大打折扣,所以使用按需加载、异步加载和懒加载会更好地让App保持流畅原生感
框架集成了有赞vant前端框架,适用大部分需求,当然你也可以更换其他Vue前端框架。
欢迎扩展和完善此框架,接下去我会放出更多其他更好用的开发框架
Copyright by Grape Studio