MUI框架开发HTML5手机APP(一)--搭建第一个手机APP
前 言
JRedu
随着HTML5的不断发展,移动开发成为主流趋势!越来越多的公司开始选择使用HTML5开发手机APP,而随着手机硬件设备配置的不断提升,各种开发框架的不断优化,也使着H5开发的混合APP的体验越来越趋于原生!那么在本系列博客中,我们就来一探H5开发APP的神秘面纱吧~~
一、 移动APP项目搭建 |
由于我们的H5编写的都是一个个网页,需要使用浏览器打开才能使用,这显然不是APP的使用方式。 那么我们才能将一个手机网站,封装成一个APP呢? 时下热门的Cordova、PhoneGap、appMobi、WeX5等…都是主流的构建APP工具!但是这些工具有一个共同的特点——使用麻烦!!
所以,我们介绍一种最简便的构建的方式,使用HBuilder一键打包!HBuilder是数字天堂旗下的一款前端开发IDE,其功能强大远超你想象,我们使用的MUI框架,HTML5+框架,都是数字天堂旗下产品,Hbuilder+MUI这对好基友,简直就是绝配!
HBuilder下载地址:http://www.dcloud.io/ ,下载完成后傻瓜式安装即可。
1使用HBuilder新建移动APP项目
HBuilder安装成功以后,就可以新建一个移动APP项目啦!点击“文件—>新建—>移动APP”,输入你的项目名称,就可以搭建完成一个移动APP项目啦!
项目的目录结构如下:
2manifest.json文件介绍
项目目录中的css/img/js/html等文件就不一一赘述了,建好项目后我们需要新增页面只需要新建HTML文件即可,与开发手机网站的操作一模一样。
而这里面最重要的应该就是manifest.json这个文件了,这个文件几乎包含了我们APP的所有设置,双击打开,可以看到这个界面:
底部的选项卡可以看到,这里面包含了我们APP的名称、版本号、首页文件、应用的图标、应用的启动图片以及我们需要的各种SDK。大家可以根据自己的需求自行设置,此处不再一一赘述。
二、APP程序的打包与调试 |
在上面的操作中,我们搭建了一款属于自己的移动APP项目,那么这个项目怎么运行调试,又是怎么打包成Android以及IOS能够安装的APP呢?
1将项目打包成APP
首先,我们来看一下如何和将项目打包成一个能够安装的应用程序,这是Hbuilder最便捷的一步,也是杰小瑞老师选择Hbuilder这款IDE的主要原因之一。
选中项目,点击Hbuilder顶部导航栏的“发行—>发行为原生安装包”,可以看到如下页面:
点击打包,就可以在不需要Xcode和 Android SDK的情况下,直接在云端打包。
打包完成后,就可以得到安卓的apk文件和苹果的ipa文件。
2直接运行调试
上面介绍的是将项目打包成应用程序,但是开发过程中,我们每个页面都要进行大量的调试测试,HBuilder也是支持的。常用的方式有多种,直接通过浏览器调试,通过手机运行调试,通过模拟器调试,都是可以。
点击运行,就可以选择调试模式啦~~此处不再赘述,如果需要可以评论留言哦!
三、MUI框架与HTML5+框架介绍 |
上面提到,HBuilder编辑器、MUI框架、HTML5+框架都是数字天堂公司的知名产品。那么MUI框架和HTML5+框架都是干什么的呢?
1MUI框架
MUI框架号称是“最接近原生APP体验的高性能前端框架”,当然这是官方的口号,杰小瑞老师不负责吹牛~ 官方文档地址:http://dev.dcloud.net.cn/mui/
经过我们的亲身体验,MUI框架确实对得起他的口号,当然也有很大的进步空间需要提升。 但是配合HBuilder的使用,如此般顺滑的操作体验会让你不敢相信自己在敲代码。 MUI给我们提供了大量的组件,只需要在HBuilder中输入一个”m”开头,就可以同列表中选择形形色色各种组件!
选中你需要的任意一个组件,回车,一大段代码直接生成!比如我们选择第一个maccordion回车,就会直接生成一大段代码,如下:
运行之后,就可以看到一个折叠面板:
这相比于其他框架需要自己手写Class的方式,这种操作是不是顺滑到不能想象呀!麻麻再也不用担心你记不住这么多class名字了~~ 所以,MUI提供了这么多的组件,使用如此简单,我们也就不再一一讲解了。感兴趣的同学,可以进入帮助文档http://dev.dcloud.net.cn/mui/ui/ 查看所有组件。
我们后面的内容,将主要针对MUI中的页面跳转、选项卡切换、Ajax、下拉刷新&上拉加载、调取底层摄像头的功能展开讲解。
2HTML5+框架介绍
上面我们介绍了MUI框架的基本使用。也了解到了MUI的主要功能是搭建APP的页面布局所使用的框架。那么HTML5+则是增强版的手机浏览器引擎,让HTML5达到原生水平!二维码、语音输入、摇一摇、摄像头、文件系统、微信分享……等几乎你能想到的原生底层功能,HTML5+都能帮你实现。
官方给出了一句话: 40万原生API能力随意调用。功能可谓强大,可以点击进入详细了解:http://www.dcloud.io/runtime.html
后续的文章中,我们也会使用到HTML5+调用原生摄像头、写入原生文件等能力进行演示。
四、搭建第一个APP应用 |
介绍完了APP搭建的基本内容,我们就开始制作我们第一个移动APP吧。首先,我们为我们的APP制作一个首页。
1创建第一个首页
首先,我们应该新建一个index.html文件,注意新建的时候选择“含MUI的html文件”,这样可以帮助我们自动导入所需要的各种默认配置。
创建完成后的第一个文件,代码以及详细解释如下:
<!doctype html> <html> <head> <meta charset="UTF-8"> <title></title> <!--设置页面的视口宽度--> <meta name="viewport" content="width=device-width,initial-scale=1,minimum-scale=1,maximum-scale=1,user-scalable=no" /> <!--导入页面所需要的MUI的CSS文件--> <link href="css/mui.min.css" rel="stylesheet" /> </head> <body> <!--导入页面所需要的MUI的JS文件--> <script src="js/mui.min.js"></script> <script type="text/javascript"> // MUI页面初始化函数 mui.init() </script> </body> </html>
2搭建首页HTML布局
首先,我们先在body中输入“m”选择mHead,生成头部导航栏。
<!--头部APP顶部导航栏区域--> <header class="mui-bar mui-bar-nav"> <!--导航栏左上角返回按钮,首页不需要返回按钮,删除即可--> <!--<a class="mui-action-back mui-icon mui-icon-left-nav mui-pull-left"></a>--> <!--导航栏标题--> <h1 class="mui-title">杰瑞教育APPDemo</h1> </header>
在导航栏下面,输入mbody,生成页面的主体部分,其实就是一个div。 页面中除了Header和Footer以外的全部内容,必须包裹在body中。
<div class="mui-content"> </div>
紧接着,我们在body中,输入一个mList,生成一个列表。
<ul class="mui-table-view"> <li class="mui-table-view-cell"> <a class="mui-navigate-right"> 1、页面加载子页&列表跳转详情页并传参 </a> </li> <li class="mui-table-view-cell"> <a class="mui-navigate-right"> 2、 底部选项卡切换(Div模式) </a> </li> <li class="mui-table-view-cell"> <a class="mui-navigate-right"> 3、底部选项卡切换(WebView模式) </a> </li> <li class="mui-table-view-cell"> <a class="mui-navigate-right"> 4、底部选项卡切换(自定义) </a> </li> <li class="mui-table-view-cell"> <a class="mui-navigate-right"> 5、图片轮播组件 </a> </li> <li class="mui-table-view-cell"> <a class="mui-navigate-right"> 6、HTML5+摄像头使用 </a> </li> <li class="mui-table-view-cell"> <a class="mui-navigate-right"> 7、下拉刷新&上拉加载更多&Ajax </a> </li> </ul>
这里面的7个功能,也就是我们将逐一讲解的7个重要功能~!是不是剧透了呢~~生成的页面效果如下:
3为每个列表添加点击事件跳转页面
添加点击事件肯定就要用到JS啦~~先介绍几个非常常用的MUI方法。
3.1 mui.init({})
mui.init方法时MUI的初始化函数,接受一个对象参数,用于进行页面的各种配置,比如子页面的加载、页面预加载等。。。
下面的代码是利用mui.init在页面初始化时进行页面手势操作的开关:
// 初始化页面中的MUI控件 mui.init({ /*设置各种手势操作的开关*/ gestureConfig:{ tap: true, //默认为true doubletap: true, //默认为false longtap: true, //默认为false swipe: true, //默认为true drag: true, //默认为true hold:false,//默认为false,不监听 release:false//默认为false,不监听 } });
3.2 mui.ready()
Mui.ready()是MUI框架中的文档就绪函数,表示mui框架已经加载完毕,接受一个回调函数,功能上有些类似于JQuery的文档就绪函数。
// 当MUI的页面DOM加载完成后,执行的函数。 但是,基本都使用mui.plusReady mui.ready(function(){ //console.log("我在plusReady之前调用!"); })
3.3 mui.plusReady ()
mui.plusReady()方法使用与mui.ready()类似,但是这个方法在执行时间上,略晚于mui.ready()。因为这个方法除了要求MUI框架加载完毕的基础上,还要求HTML5+运行时必须准备完毕!
所以我们一般用这个函数,来代替JS中的window.onload函数。
//页面中HTML5+相关的内容加载完毕后,执行的函数。 类似于window.onload = function(){} mui.plusReady(function(){ //console.log("我在mui.ready之后调用!"); })
3.4 页面跳转功能的实现
页面跳转功能的实现思路是,我们新建了一个数组,数组中存放着与列表一一对应的链接地址。 然后使用循环给每一个列表list添加点击事件,并打开数组中对应的页面地址,代码如下:
var page = ["01-jiazaiziyemian.html","02-tabbarDiv.html","03-tabbarWebView.html","04-tabbarMy.html","05-imglunbo.html","06-Camera.html","07-fullPush.html"]; var arr = document.getElementsByTagName("a"); for(var i=0; i<arr.length; i++){ !function(i){ // 在手机APP中,事件绑定推荐使用DOM2模型。 用tap事件取代click事件。 arr[i].addEventListener("tap",function(){ mui.openWindow({ url:page[i], id:page[i], }) }) }(i); }
3.5 跳转代码解释
上述代码中,对于很多初学者来说可能会存在一些问题,下面我们来一一解释一下这部分代码:
① 移动端开发中使用tap替代click
在移动端开发中,由于使用click事件会存在一定的延迟,严重影响用户体验,所以我们一律用tap事件取代所有的点击事件。
② 为什么for循环中嵌套一个自执行函数?
这个问题我们在JS面向对象环节探讨过,由于for循环会在页面加载时直接循环结束,所以当我们点击list时,其中的i已经变成了数组的长度。 至于为什么这么解决,大家可以参考之前的博客:http://www.cnblogs.com/jerehedu/p/7592124.html
③mui.openWindow ()是个什么东西?
mui.openWindow是MUI官方给我们提供的专门用于打开一个新窗口的函数,详细的使用教程可以参考:http://dev.dcloud.net.cn/mui/window/#openwindow
而这个函数的完整配置项如下,当然我们上述的操作只需要一个URL和一个页面ID即可,而且我们以后的页面ID基本都使用URL同名的方式哦~
mui.openWindow({ url:new-page-url, id:new-page-id, styles:{ top:newpage-top-position,//新页面顶部位置 bottom:newage-bottom-position,//新页面底部位置 newpage-width,//新页面宽度,默认为100% height:newpage-height,//新页面高度,默认为100% ...... }, extras:{ .....//自定义扩展参数,可以用来处理页面间传值 }, createNew:false,//是否重复创建同样id的webview,默认为false:不重复创建,直接显示 show:{ autoShow:true,//页面loaded事件发生后自动显示,默认为true aniShow:animationType,//页面显示动画,默认为”slide-in-right“; duration:animationTime//页面动画持续时间,Android平台默认100毫秒,iOS平台默认200毫秒; }, waiting:{ autoShow:true,//自动显示等待框,默认为true title:'正在加载...',//等待对话框上显示的提示内容 options:{ waiting-dialog-widht,//等待框背景区域宽度,默认根据内容自动计算合适宽度 height:waiting-dialog-height,//等待框背景区域高度,默认根据内容自动计算合适高度 ...... } } })
好了,截止到这,我们的首页就全部搭建完成啦!最终效果如下!
3.6 首页最终效果预览
当然这里面还有很多功能我们暂时没有实现,后面的博客我们继续再见吧!
如若想要源码可戳http://www.jredu100.com/index.php?m=content&c=index&a=show&catid=65&id=38自行下载