uni-app 项目教程

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.productionTip 为 false，关闭生产环境提示。
• 创建 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、描述、版本号等基本信息。
• 平台配置: