使用HBuilderX新建uniapp项目
完成 HBuilderX 安装后,即可创建首个 UniApp 项目,以下是从项目初始化到熟悉目录结构的完整流程:
打开Hbuilder点击文件,点击项目。
输入项目名称和选择储存位置,UniApp 提供多种模板,可根据开发需求选择,新手建议从基础模板入手,选择默认模板即可。
根据需求勾选 “启用 Vue3”(Vue3 支持 Composition API,功能更强大;若习惯 Vue2 语法,可选择 “Vue2”)。
新建完项目后会有如下的文件夹和文件:
下面是不同文件夹的作用:
- pages 文件夹:存放项目所有页面,每个页面对应一个子文件夹(如 “index” 文件夹),每个页面包含.vue 文件(页面布局与逻辑)、.json 文件(页面单独配置,如导航栏标题);
- static 文件夹:存放静态资源(图片、字体、音频等),注意:静态资源需放在此文件夹中,否则可能出现跨端引用问题;
- App.vue文件:它是项目的全局根组件,在整个应用程序中起到统领全局的作用。可以在该文件中定义全局的样式、生命周期函数等。
- index.html:这是 H5 端的入口文件,当将 UniApp 项目打包成 H5 应用时,该文件起到加载页面、初始化环境等作用。在运行 H5 项目时,浏览器会首先加载这个文件,然后通过它来引入和渲染页面内容。
- main.js文件:是项目的入口 JavaScript 文件,主要用于初始化 Vue 实例,并进行一些全局的配置和插件的引入。
- manifest.json文件:是项目的配置文件,涵盖了项目在各个平台(微信小程序、App、H5 等)上的相关配置信息,对项目的发布和运行起着至关重要的作用。
- pages.json:全局页面配置文件,可设置页面路由、导航栏样式、底部 tab 栏等(如配置 “tabBar” 实现多页面切换);
- manifest.json:项目配置文件,包含 AppID、应用名称、图标、权限设置(如相机、定位权限)、各平台(微信小程序、App、H5)的发布配置;
- uni.promisify.adaptor.js文件:UniApp 中很多 API 是基于回调函数的形式,使用起来不太方便,这个文件主要用于将 UniApp 的一些 API 转换为 Promise 形式,方便在代码中使用
async/await
语法进行异步操作,提高代码的可读性和可维护性。 - uni.scss文件:是一个全局的 SCSS 样式文件,SCSS 是 CSS 的扩展语言,支持变量、混合宏、嵌套等高级特性。在这个文件中可以定义全局的 SCSS 变量和样式,然后在其他
.vue
文件中直接使用这些变量和样式,实现样式的统一管理和复用。