---

前言

本文主要介绍使用uniapp框架和uview组件库进行H5开发，需要用到的开发工具为HBuilder X。

---

一、开发步骤

1.创建项目

打开HBuilder X，在顶部栏目选择 新建 > 项目 > uni-app > 默认模板 。输入项目名字，再选择Vue版本，点击创建即可。本次学习以Vue2为例。

2.安装组件库并导入使用

① 在顶部栏目选择 工具 > 插件安装 > 安装新插件 > 前往插件市场安装。

③ 在 前端组件 栏目里面搜索 uview 组件，选择 2.0 版本的点击下载。

④ 进入下载页后，选择 下载插件并导入HBuilderX ，再选择项目名字确定导入即可。

⑤ 在 main.js 文件全局引入组件库。在Vue2版本里，添加导入组件库并使用，必须导入Vue之后才能导入使用组件。

// #ifndef VUE3
import Vue from 'vue'
import './uni.promisify.adaptor'/** 导入组件库 */
import uView from '@/uni_modules/uview-ui';
Vue.use(uView);Vue.config.productionTip = false
App.mpType = 'app'
const app = new Vue({...App
})
app.$mount()
// #endif

⑥ 在 uni.scss 样式文件加入uview主题样式，里面有组件样式相关的变量，不导入使用组件样式会报错。

@import '@/uni_modules/uview-ui/theme.scss';

⑦ 在 App.vue 文件引入组件库样式文件，必须使用scss预处理语言。

<style lang="scss">/*每个页面公共css */@import "@/uni_modules/uview-ui/index.scss";
</style>

⑧ 如果 HBuilderX 编辑器没有安装 scss/sass编译 插件，按照安装组件库的方式，选择 HBuilderX 相关的插件，搜索 sass 下载导入即可。

3.封装请求

① 在项目根目录下新建一个目录命名为 api，在该目录下新建一个 request.js 文件封装请求，内容如下：

/** 访问后端接口的域名或IP */
const Base_url = ""/** 同时发送异步代码的次数，防止一次点击中有多次请求 */
let ajaxTimes=0;export const request = (options) => {return new Promise((resolve, reject)=>{/** 获取本地保存的token信息,可选 */// let token = uni.getStorageSync('token')uni.request({url: Base_url + options.url,method: options.method || 'GET',data: options.data || {},header:options.header || {},success: (res) => {if(res.statusCode !== 200){return uni.showToast({icon:'none',title: res.data.message})}/** 成功，将数据返回 */ resolve(res.data) },fail: (err) => {/** 异常情况 */ uni.showToast({icon:'error',title: "请求接口失败！"})reject(err)}})})
}

② 在 api 目录下再新建一个 index.js 文件用来封装接口，内容如下：

import {request
} from './request.js';export function getDemo(params) {return request({url: '接口名',method: 'GET',data: params});
}export function postDemo(params) {return request({url: '接口名',method: 'POST',data: params,header:{"Content-Type": "application/json"}});
}

③ 在页面导入使用。

<script>import {postDemo,getDemo,} from '@/api/index.js';export default {methods: {getFun(){getDemo(data).then((res)=>{console.log(res)})}}}
</script>

4.国际化

如果项目有多语言需求就加入此项配置，没有就跳过。

①在文件引入并初始化 VueI18n。

import App from './App';
/** 导入国际化文件 */
import enUs from './locale/en-us.json';
import zhCn from './locale/zh-cn.json';
const messages = {/** 英语 */ 'en-us': enUs,/** 中文 */'zh-cn': zhCn,
};let i18nConfig = {locale: uni.getLocale(), /** 获取已设置的语言 */messages
};
// #ifndef VUE3
import Vue from 'vue';
import './uni.promisify.adaptor';/** 国际化 */
import VueI18n from 'vue-i18n';
Vue.use(VueI18n);
const i18n = new VueI18n(i18nConfig);/** uview组件库 */
import uView from '@/uni_modules/uview-ui';
Vue.use(uView);Vue.config.productionTip = false;
App.mpType = 'app';
const app = new Vue({i18n,...App
});
app.$mount();
// #endif

② 国际化json文件的内容

{"index.title": "Hello i18n"
}

③ 页面中使用

/** 
* 模板中使用 $t() 获取，并传递国际化json文件中定义的key，
* js中使用 this.$t('')
* 切换语言使用 **this.$i18n.locale = 'en-us'
** */
<template><view class="container"><view class="title">{{$t('index.title')}}</view></view>
</template><script>export default {data() {return {}}}
</script>

5.打包

在顶部栏目选择 发行 > 网站-PC Web或手机H5（仅适用于uni-app），等待打包成功项目里面会出现一个叫 unpackage 的目录，里面有打包好的 dist 。

---

总结

以上就是今天要记录的内容，本文仅仅简单介绍了uniapp的H5项目开发一些基础内容，仅供学习参考。