当前位置:首页 > uni-app

uniapp教程

2026-03-04 17:36:20uni-app

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 提供了一系列内置组件,如 viewtextbutton 等。还可以使用第三方组件或自定义组件。

自定义组件示例:

  1. 创建组件文件 components/my-component.vue
  2. 在页面中引入并使用:
    
    <template>
    <view>
     <my-component :prop="data"></my-component>
    </view>
    </template>
import MyComponent from '@/components/my-component.vue' export default { components: { MyComponent }, data() { return { data: '示例数据' } } } ```

多端适配

uniapp 支持条件编译,可以根据不同平台编写特定代码:

// #ifdef H5
console.log('仅在 H5 平台执行')
// #endif

// #ifdef MP-WEIXIN
console.log('仅在小程序平台执行')
// #endif

调试与发布

调试:在 HBuilderX 中点击“运行”菜单,选择目标平台(如 Chrome、微信开发者工具等)进行调试。

发布:在 HBuilderX 中点击“发行”菜单,选择目标平台(如 App、小程序等),按照向导完成发布流程。

uniapp教程

学习资源

通过以上步骤,可以快速入门 uniapp 开发并实现跨平台应用发布。

标签: 教程uniapp
分享给朋友:

相关文章

uniapp请求超时处理

uniapp请求超时处理

uniapp请求超时处理方法 在uniapp中处理请求超时可以通过多种方式实现,以下是几种常见的处理策略: 设置全局请求超时时间 在main.js中配置全局请求超时时间,适用于所有请求: uni…

uniapp模板库

uniapp模板库

uniapp模板库推荐 官方模板库 uni-app官方提供多个模板,涵盖电商、社交、新闻等多个领域。这些模板可直接在HBuilderX中通过新建项目选择,包含基础结构和常用功能模块,适合快速启动项目。…

uniapp中如何使用iconfont

uniapp中如何使用iconfont

使用 Iconfont 在 Uniapp 中的步骤 下载 Iconfont 资源 访问 Iconfont 官网,选择需要的图标并添加到项目。下载时选择 Font class 格式,解压后会得到 .tt…

uniapp 头条

uniapp 头条

uniapp 适配今日头条(字节跳动小程序)的方法 环境配置 确保HBuilderX版本在2.7.0以上,manifest.json中勾选"字节跳动小程序"平台。在开发者工具中配置正确的AppID和项…

uniapp商场

uniapp商场

uniapp 商城开发指南 开发环境搭建 安装HBuilderX作为开发工具,确保已安装Node.js和npm。创建uniapp项目时选择模板,推荐使用官方提供的商城模板或插件市场中的商城模板。 页…

美颜uniapp

美颜uniapp

美颜功能在UniApp中的实现方法 在UniApp中实现美颜功能,可以通过以下几种方式: 使用第三方SDK或插件 腾讯云美颜SDK:提供直播推流场景下的美颜、滤镜、贴纸等功能,支持UniApp集成…