首页
/ uni-app 项目教程

uni-app 项目教程

2024-08-07 04:08:58作者:柯茵沙

1. 项目的目录结构及介绍

uni-app 项目的目录结构遵循 Vue.js 项目的标准结构,并添加了一些特定于跨平台开发的文件和目录。以下是一个典型的 uni-app 项目目录结构:

uni-app-project/
├── components/          # 存放可复用的 Vue 组件
├── pages/               # 存放应用的页面
├── static/              # 存放静态资源文件,如图片、字体等
├── unpackage/           # 编译后的文件存放目录
├── App.vue              # 应用的根组件
├── main.js              # 应用的入口文件
├── manifest.json        # 应用的配置文件
├── pages.json           # 页面路由和窗口样式配置
├── uni.scss             # 全局样式文件
└── README.md            # 项目说明文档

目录详细介绍

  • components/: 存放可复用的 Vue 组件,这些组件可以在多个页面中使用。
  • pages/: 存放应用的页面,每个页面通常包含一个 .vue 文件。
  • static/: 存放静态资源文件,这些文件在编译时会被直接复制到输出目录。
  • unpackage/: 编译后的文件存放目录,包含各个平台的编译结果。
  • App.vue: 应用的根组件,定义了应用的全局样式和结构。
  • main.js: 应用的入口文件,负责初始化 Vue 实例和引入必要的插件。
  • manifest.json: 应用的配置文件,包含应用的基本信息、权限配置等。
  • pages.json: 页面路由和窗口样式配置,定义了应用的路由和页面样式。
  • uni.scss: 全局样式文件,定义了应用的全局样式变量和样式。
  • README.md: 项目说明文档,提供了项目的详细说明和使用指南。

2. 项目的启动文件介绍

main.js

main.js 是 uni-app 项目的入口文件,负责初始化 Vue 实例和引入必要的插件。以下是一个典型的 main.js 文件内容:

import Vue from 'vue'
import App from './App'

import './uni.scss' // 引入全局样式文件

Vue.config.productionTip = false

App.mpType = 'app'

const app = new Vue({
    ...App
})

app.$mount()

详细介绍

  • 引入 Vue 和 App 组件: 首先引入 Vue 库和根组件 App
  • 引入全局样式文件: 引入 uni.scss 文件,定义全局样式。
  • 配置 Vue: 设置 Vue.config.productionTipfalse,关闭生产环境提示。
  • 创建 Vue 实例: 使用 new Vue 创建 Vue 实例,并挂载到根组件 App
  • 挂载应用: 调用 $mount 方法将 Vue 实例挂载到 DOM 上。

3. 项目的配置文件介绍

manifest.json

manifest.json 是 uni-app 项目的配置文件,包含应用的基本信息、权限配置等。以下是一个典型的 manifest.json 文件内容:

{
  "name": "uni-app-project",
  "appid": "",
  "description": "A uni-app project",
  "versionName": "1.0.0",
  "versionCode": "100",
  "transformPx": false,
  "app-plus": {
    "usingComponents": true,
    "modules": {
      "Maps": {}
    },
    "distribute": {
      "android": {
        "permissions": [
          "<uses-permission android:name=\"android.permission.CHANGE_NETWORK_STATE\"/>",
          "<uses-permission android:name=\"android.permission.MOUNT_UNMOUNT_FILESYSTEMS\"/>"
        ]
      }
    }
  },
  "h5": {
    "title": "uni-app H5",
    "router": {
      "mode": "history"
    }
  }
}

详细介绍

  • 基本信息: 包含应用的名称、ID、描述、版本号等基本信息。
  • 平台配置:
登录后查看全文
热门项目推荐
相关项目推荐