MUI框架开发HTML5手机APP(一)--搭建第一个手机APP
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,//新页面底部位置
width: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:{
width: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自行下载
