一、环境搭建

使用 HBuilderX可视化界面快速创建项目，HBuilderX内置处理了相关环境依赖。

HBuilderX：内置uni-app编辑及项目模板，下载地址
微信开发者工具：调试预览工具。下载地址

二、创建uni-app项目

创建

在HBuilderX编辑器中点击工具栏里的文件 -> 新建 -> 项目：

选择uni-app，输入项目名称，这里有很多模板，选择你所需要的。为了之后表述方便，这里先创建了ColorUI模板，为了方便以后引用ColorUI。然后有创建了一个默认模板，这个默认模板文件很少，方便以后自由开发。如下两图所示。

项目目录

文件	作用
pages.json	配置页面路由、导航条、选项卡等页面类信息
manifest.json	配置应用名称、appid、logo、版本等打包信息
App.vue	应用配置，用来配置App全局样式以及监听应用的生命周期
main.js	Vue初始化入口文件
static目录	存放应用引用静态资源（如图片、视频等）的地方，注意：静态资源只能存放于此
pages目录	业务页面文件存放目录
components目录	组件文件存放目录

注意：在开发过程中，当你写登录功能后，某个页面你需要经常进入并且多次修改，你每次修改都需要登录后的信息，所以就很麻烦了。你需要一直从登录开始操作，直到你到达这个界面。这时候你就可以用这个了condition。

现在来介绍一下condition：

condition 启动模式配置，仅开发期间生效，用于模拟直达页面的场景，如：小程序转发后，用户点击所打开的页面。

属性说明：

属性	类型	是否必填	描述
current	Number	是	当前激活的模式，list节点的索引值
list	Array	是	启动模式列表

list说明：

属性	类型	是否必填	描述
name	String	是	启动模式名称
path	String	是	启动页面路径
query	String	否	启动参数，可在页面的 onLoad 函数里获得

在 5+App 里真机运行可直接打开配置的页面，微信开发者工具里需要手动改变编译模式，过程：微信开发工具 -> 工具 -> 编译配置 -> 找到在condition里配置的name。

在pages.josn里配置condition，代码如下：

"condition": { //模式配置，仅开发期间生效
    "current": 0, //当前激活的模式（list 的索引项）
    "list": [{
             "name": "jingdian_detail", //模式名称
	     "path": "pages/jingdian_detail/jingdian_detail", //启动页面，必选
	     "query": "id=5d1483336d724301607b2c23" //启动参数，在页面的onLoad函数里面得到。
	   }
    ]
}

三、引用ColorUI

有了第二步创建好的模板，我们就可以引用了。

ColorUI的引入

首先复制一下ColorUI项目目录下的colorui目录，然后粘贴到demo项目的根目录下，与pages目录同级。

使用顶部操作条

如果喜欢ColorUI里自定义的navigationBar，即cu-custom组件，那就需要在demo项目中的main.js里导入。建议还是使用cu-custom组件。

/* demo/main.js */
import cuCustom from './colorui/components/cu-custom.vue'
Vue.component('cu-custom',cuCustom)

下图就是ColorUI的状态栏：

你可以直接复制ColorUI项目里的App.vue文件，因为这里面设置好了cu-custom组件的高度以及定义了全局的颜色。并且还需要将pages.json配置取消系统导航栏。（开启 custom 后，所有窗口均无导航栏）

"globalStyle": {
	"navigationStyle": "custom"
},

如果不想用cu-custom组件，那就直接在demo项目里的App.vue文件的<style></style>里引入这两句话就OK了。当然上面也需要加。

@import "colorui/main.css";
@import "colorui/icon.css";

关于引用ColorUI的介绍，也可以查看引用ColorUI

底部操作条。

首先我们来看一下这部分的代码。

/*  ColorUI/pages/index/index.vue  */
<template>
	<view>
	
	    //使用v-if条件判断，来显示相应的界面 
	    //如果点击了底部中的“操作条元素->basics”、“组件->component” 或者 “扩展->plugin”，界面会出现相应的主界面。如上图所示。
		<basics v-if="PageCur=='basics'"></basics>
		<components v-if="PageCur=='component'"></components>
		<plugin v-if="PageCur=='plugin'"></plugin>

            //这里的“元素”，“组件”，“扩展”三个操作都是绑定一个点击事件NavChange，通过设置PageCur的值再结合:class属性来改变图片的路径，进而改变了按钮的颜色
		<view class="cu-bar tabbar bg-white shadow foot">
			<view class="action" @click="NavChange" data-cur="basics">
				<view class='cuIcon-cu-image'>
					<image :src="'/static/tabbar/basics' + [PageCur=='basics'?'_cur':''] + '.png'"></image>
				</view>
				<view :class="PageCur=='basics'?'text-green':'text-gray'">元素</view>
			</view>
			<view class="action" @click="NavChange" data-cur="component">
				<view class='cuIcon-cu-image'>
					<image :src="'/static/tabbar/component' + [PageCur == 'component'?'_cur':''] + '.png'"></image>
				</view>
				<view :class="PageCur=='component'?'text-green':'text-gray'">组件</view>
			</view>
			<view class="action" @click="NavChange" data-cur="plugin">
				<view class='cuIcon-cu-image'>
					<image :src="'/static/tabbar/plugin' + [PageCur == 'plugin'?'_cur':''] + '.png'"></image>
				</view>
				<view :class="PageCur=='plugin'?'text-green':'text-gray'">扩展</view>
			</view>
		</view>
	</view>
</template>
<script>
	export default {
		data() {
		return {
				PageCur: 'basics'
			}
		},
		methods: {
			NavChange: function(e) {
				this.PageCur = e.currentTarget.dataset.cur
			}
		}
	}
</script>
<style>
</style>

当点击“元素”，“组件”，“扩展”三个按钮的其中之一时，都会出现相应的页面，原因就是在ColorUI的项目里mian.js里要引入下面的代码：

import basics from './pages/basics/home.vue'
Vue.component('basics',basics)

import components from './pages/component/home.vue'
Vue.component('components',components)

import plugin from './pages/plugin/home.vue'
Vue.component('plugin',plugin)

这个底部操作条还有其它方式，可以查看这个底部操作条

四、结合后端基本操作的实现

实现用户登陆注册

简单注册

上前端代码

<view class="list">
	<view class="list-call">
		<text class="cuIcon-mobile text-style "></text>
		<input class="biaoti" v-model="phoneNum" type="number" maxlength="11" placeholder="输入手机号" />
	</view>
	<view class="list-call">
		<text class="cuIcon-lock text-style "></text>
		<input class="biaoti" v-model="password" type="text" 
		       maxlength="32" placeholder="输入密码" :password='tfpsw' />
		<image class="img" 
		       :src="showPassword?'../../static/login-reg-forget/op.png':'../../static/login-reg-forget/cl.png'"
		       @tap="display"></image>
	</view>
	<view class="list-call">
		<text class="cuIcon-people text-style "></text>
		<input class="biaoti" v-model="username" type="text" placeholder="输入用户名" />
	</view>
</view>
	
<view class="dlbutton bg-color" hover-class="dlbutton-hover" @tap="bindReg">
	<text>注册</text>
</view>
<script>

export default {
	data() {
		return {
			phoneNum:'',
			password:'',
			username:'',
			tfpsw:true,
			xieyi:true,
			showPassword:false,
		};
	},
	methods: {
		//密码显示或打马	
		display() {
		    this.showPassword = !this.showPassword
			this.tfpsw =!this.tfpsw
		},
		//协议
		xieyitong(){
			this.xieyi = !this.xieyi;
		},
		//注册
	        bindReg() {
	        //简单验证
			if (this.xieyi == false) {
			    uni.showToast({
			        icon: 'none',
			        title: '请先阅读《软件用户协议》'
			    });
			    return;
			}
			if (this.phoneNum.length !=11) {
			    uni.showToast({
			        icon: 'none',
			        title: '手机号不正确'
			    });
			    return;
			}
			if (this.password.length < 6) {
			    uni.showToast({
			        icon: 'none',
			        title: '密码位数至少6位'
			        
			    });
			    return;
			}
			//将信息传到后台
			uni.request({
			//this.websiteUrl是全局api，在mian.js里设置
			    url: this.websiteUrl+'/user/signup',
			    data: {
			        mobile:this.phoneNum,
			        password:this.password,
			        username:this.username,
			    },
			    method: 'POST',
			    dataType:'json',
			    success: (res) => {
    			    if(res.statusCode==200){
    			        uni.reLaunch({
    			            url: "../login/login" //跳转到首页
    			    });
			        uni.showToast({title:"注册成功！",icon:'none'});
			    }else{
			        uni.showToast({title:"注册失败",icon:'wrong'});
			    }
			}
		});
	 }
    }
}
</script>
//样式表就不加啦

uni.request 是发起网络请求查看更多，在这里我就提一下url: this.websiteUrl+'/user/signup',这个url里的this.websiteUrl,这个是在main.js里定义的全局api。

//设置全局的api地址
Vue.prototype.websiteUrl = 'http://10.4.14.132:7000';

其中10.4.14.132是本地的IPV4，:7000是后端的端口号。

结合运行界面，更加直观（图有点大......）

登陆

这次换了一个手机类型，现在小了很多，先看看界面吧！

撂主要的代码，如下：

<view class="list">
    <view class="list-call">
        <text class="cuIcon-mobile text-style "></text>
	<input class="biaoti" v-model="phoneNum" type="number" maxlength="11" placeholder="输入手机号" />
    </view>
    <view class="list-call">
	<text class="cuIcon-lock text-style "></text>
	<input class="biaoti" v-model="password" type="text" maxlength="32" placeholder="输入密码" password="true" />
    </view>
</view>
<view class="dlbutton bg-color" hover-class="dlbutton-hover" @tap="bindLogin()">
    <text>登录</text>
</view>

<script>
export default {
    data() {
        return {
		phoneNum: '',
		password: ''
	    };
	},
	
	methods: {
	    bindLogin() {
		if (this.phoneNum.length != 11) {
		    uni.showToast({
			icon: 'none',
			title: '手机号不正确'
		    });
		    return;
		}
		if (this.password.length < 6) {
			uni.showToast({
			    icon: 'none',
			    title: '密码不正确'
			});
			return;
		}
		uni.request({
			url: this.websiteUrl+'/user/login',
			data: {
				mobile: this.phoneNum,
				password: this.password
			},
			method: 'POST',
			dataType: 'json',
			success: (res) => {
			    console.log("登录返回数据",res);
			    if (res.data.data.code == 1) {
				uni.showToast({
			            title: "登录成功！",
			    	    icon: 'none'
				});
			        uni.setStorageSync('token', res.data.data.token);
			        uni.setStorageSync('loginUser',res.data.data.userinfo);
			        uni.reLaunch({
			            url: "../index/index" //跳转到首页
			        });
			    } else {
				uni.showToast({
				    title: "登录失败！",
				    icon: 'wrong'
				});
			 }
		    }
	       });
        }
    }
}
</script>

在登陆的时候用到了uni.setStorageSync，uni.setStorageSync将 data 存储在本地缓存中指定的 key 中，会覆盖掉原来该 key 对应的内容，这是一个同步接口。当使用uni.setStorageSync接口将数据存到本地缓存中时，就需要uni.getStorageSync来获取信息。查看更多

class 与 style 的绑定

在开发中会使用到class 与 style 的绑定，来介绍一下：

class 支持的语法:

<view :class="{ active: isActive }">111</view>
<view class="static" v-bind:class="{ active: isActive, 'text-danger': hasError }">222</view>
<view class="static" :class="[activeClass, errorClass]">333</view>
<view class="static" v-bind:class="[isActive ? activeClass : '', errorClass]">444</view>
<view class="static" v-bind:class="[{ active: isActive }, errorClass]">555</view>

style 支持的语法:

<view v-bind:style="{ color: activeColor, fontSize: fontSize + 'px' }">666</view>
<view v-bind:style="[{ color: activeColor, fontSize: fontSize + 'px' }]">777</view>

接下来我们来写个例子：

当我们提交“申请”之前，按钮的颜色是绿色的，符合用户的习惯。当点击按钮之后，会进行一系列的操作，比如与后端进行交互，这个例子比较简单，就是普通的改变样式。

html:

<button class="static" 
        :class="[isSubmit ? Submited: '', NoSubmit]"
        @click="submitFile">{{text}}</button>

js: 一定要在data里注册后，再在class里使用，这样才会被渲染出来。

export default {
	data() {
		return {
			Submited: 'Submited',
			NoSubmit: 'NoSubmit',
			isSubmit:false,
			text:'申请'
		}
	},
	methods: {
	    submitFile(){
			this.text ='已申请';
			this.isSubmit = true;
		}
	}
}

页面的跳转

这里就简单说一下路由跳转问题，详情可以看官网。

uni.navigateTo() : 跳转非tarBar页面

保留当前页面，跳转到应用内的某个页面，使用uni.navigateBack可以返回到原页面。

示例：

//在起始页面跳转到test.vue页面并传递参数
uni.navigateTo({
    url: 'test?id=1&name=uniapp'
});

// 在test.vue页面接受参数
export default {
    onLoad: function (option) { //option为object类型，会序列化上个页面传递的参数
        console.log(option.id); //打印出上个页面传递的参数。
        console.log(option.name); //打印出上个页面传递的参数。
    }
}

uni.redirectTo() : 跳转非tarBar页面

关闭当前页面，跳转到应用内的某个页面。示例:


uni.redirectTo({
    url: 'test?id=1'
});

uni.reLaunch()

关闭所有页面，打开到应用内的某个页面。

需要跳转的应用内页面路径 , 路径后可以带参数。参数与路径之间使用?分隔，参数键与参数值用=相连，不同参数用&分隔；如 path?key=value&key2=value2，如果跳转的页面路径是 tabBar 页面则不能带参。

uni.switchTab(OBJECT)

跳转到 tabBar 页面，并关闭其他所有非 tabBar 页面。示例：

pages.json

{
  "tabBar": {
    "list": [{
      "pagePath": "pages/index/index",
      "text": "首页"
    },{
      "pagePath": "pages/other/other",
      "text": "其他"
    }]
  }
}

other.vue

uni.switchTab({
    url: '/pages/index/index'
});

小总结：

navigateTo, redirectTo 只能打开非 tabBar 页面。
switchTab 只能打开 tabBar 页面。
reLaunch 可以打开任意页面。
页面底部的 tabBar 由页面决定，即只要是定义为 tabBar 的页面，底部都有 tabBar。
不能在 App.vue 里面进行页面跳转。

页面传参

就比如点击这个景点的卡片，会进入这个景点的详情页面，这个过程中就用到了页面的传参。

主要代码如下：

//index.vue
<template>
<view class="cu-card case "  v-for="(item, index) in jingdian" :key="index"  @click="jd_Detial(item)">
	<view class="cu-item shadow">
		<view class="image">
			<image :src="item.img" mode="widthFix"></image>
			<view class="cu-tag bg-red">Hot</view>
		</view>
		<view class="cu-list menu-avatar">
			<view class="cu-item">
				<view class="content flex-sub" style="left: 20px;">
					<view class="text-grey">{{item.name}}</view>
					<view class="text-gray text-sm flex justify-between">
						<view class="text-gray text-sm">
							<text class="icon-icon_like-copy margin-lr-xs"></text>收藏
						</view>
					</view>
				</view>
			</view>
		</view>
	</view>
</view>
</template>

<script>
	export default {
		data() {
			return {
			    jingdian:[]
			}
		},
		created:function () {
			try {
			    //获取所有景点的数据
				uni.request({
					url: this.websiteUrl+'/api/showCityTickets/'+ this.cityId,
					method: 'GET',
					dataType: 'json',
					success: (res) => {
						this.jingdian = res.data.data;
					}
				})
			} catch (e) {
				// error
				console.log('error',e)
			}
		},
		methods: {
		    jd_Detial(item){
				console.log('id',item._id);
				//页面跳转以及传到下一页面所需要的参数_id，
				uni.navigateTo({
					url:"../jingdian_detail/jingdian_detail?id=" + item._id
				})
			}
		}
	}
</script>

下面是jingdian_detail.vue的详情页面

jingdian_detail.vue页面通过onLoad()生命周期函数来获取上一页面传过来的参数_id。主要代码如下：

onLoad(options) {
	var _this = this;
	this.ticketId = options.id;
	//根据这个ID来获取相应的景点的详情数据，根据详情数据再来渲染出详情页面
	uni.request({
		url: this.websiteUrl + '/api/ticketsShowDetial/' + options.id,
		method: 'GET',
		dataType: 'json',
		success: function success(res) { 
			if (res.statusCode == 200) {
				_this.detail = res.data.data;
			}
		}
	});
	console.log('&&&&&&&&this.detail&&&&&&', this.detail);
}

获取位置

自己写了一个简单的定位，只是为了方便大家了解这一功能是如何实现的。

这个获取位置只能在手机端进行测试，H5端没有GPS。

上代码：

<template>
<view style="margin: 10px auto;">
	<button @click="getLocal()">定位</button>
	<p>经度:{{longitude}} </p>
	<p>纬度：{{latitude}}</p>
	<p>详细地址{{address.country+address.province+address.city + address.district+ address.street}}</p>
</view>
</template>
<script>
	export default {
	    data() {
		return {
		    latitude:'',//纬度
		    longitude:'',//经度
		    address:{},//地址信息			
		 }
	    },
        methods: {
        	getLocal(){
        		// 获取当前的地理位置、速度。 
        		let that = this;
        		try{
        			uni.getLocation({
        			    type: 'wgs84',
        			    geocode:true,//解析地址信息
        			    success: function (res) {
        					that.latitude =  res.latitude
        					that.longitude = res.longitude
        					that.address = res.address
        					//查看地图
        					 uni.openLocation({
        					            latitude: that.latitude,
        					            longitude: that.longitude,
        					            success: function () {
        					                console.log('打开地图success');
        					            }
        					 });
        			    },
        			    fail:function(res){
        				    console.log("fail====",res)
        			    }
        			});
        		}catch(e){
        			console.log("error",e)
        		}
            }
        }
    }

点击定位按钮，获取本地的经纬度和详细地址，然后会自动跳到地图页面。

具体想要知道获取位置和查看地图的API，可以查看官网哦!

运行和发布

对于运行和发布，官网上的“快速上手”中有介绍，请点击查看