uniapp教程
uniapp 简介
uniapp 是一个使用 Vue.js 开发跨平台应用的框架,可以编译到 iOS、Android、H5 以及各种小程序平台。它基于 Vue 的语法和组件化开发模式,开发者可以通过一套代码实现多端发布。
开发环境搭建
安装 HBuilderX:uniapp 官方推荐的开发工具是 HBuilderX,下载地址为 https://www.dcloud.io/hbuilderx.html。根据操作系统选择对应版本安装。
创建 uniapp 项目:在 HBuilderX 中选择“文件” > “新建” > “项目”,选择“uni-app”模板,填写项目名称和路径,点击“创建”。
安装依赖:如果使用命令行开发,可以通过 npm 安装依赖:
npm install
项目结构
典型的 uniapp 项目结构如下:
pages:存放页面文件,每个页面是一个文件夹,包含.vue文件。static:存放静态资源,如图片、字体等。App.vue:应用的主组件,全局样式和生命周期可以在这里定义。main.js:应用的入口文件,初始化 Vue 实例。manifest.json:应用的配置文件,包括应用名称、图标、启动页等。pages.json:页面路由配置文件,定义页面路径和窗口样式。
基本语法
uniapp 使用 Vue 的语法,以下是一个简单的页面示例:
<template>
<view class="container">
<text>{{ message }}</text>
<button @click="changeMessage">点击修改</button>
</view>
</template>
<script>
export default {
data() {
return {
message: 'Hello uniapp!'
}
},
methods: {
changeMessage() {
this.message = '消息已修改'
}
}
}
</script>
<style>
.container {
display: flex;
flex-direction: column;
align-items: center;
justify-content: center;
height: 100vh;
}
</style>
页面路由
在 pages.json 中配置页面路由:
{
"pages": [
{
"path": "pages/index/index",
"style": {
"navigationBarTitleText": "首页"
}
},
{
"path": "pages/detail/detail",
"style": {
"navigationBarTitleText": "详情页"
}
}
]
}
跳转页面可以使用 uni.navigateTo:
uni.navigateTo({
url: '/pages/detail/detail'
})
组件使用
uniapp 提供了一系列内置组件,如 view、text、button 等。还可以使用第三方组件或自定义组件。
自定义组件示例:
- 创建组件文件
components/my-component.vue。 - 在页面中引入并使用:
<template> <view> <my-component :prop="data"></my-component> </view> </template>
多端适配
uniapp 支持条件编译,可以根据不同平台编写特定代码:
// #ifdef H5
console.log('仅在 H5 平台执行')
// #endif
// #ifdef MP-WEIXIN
console.log('仅在小程序平台执行')
// #endif
调试与发布
调试:在 HBuilderX 中点击“运行”菜单,选择目标平台(如 Chrome、微信开发者工具等)进行调试。
发布:在 HBuilderX 中点击“发行”菜单,选择目标平台(如 App、小程序等),按照向导完成发布流程。

学习资源
- 官方文档:https://uniapp.dcloud.io/
- 社区论坛:https://ask.dcloud.net.cn/
- GitHub 示例:https://github.com/dcloudio/uni-app
通过以上步骤,可以快速入门 uniapp 开发并实现跨平台应用发布。





