在本篇文章带大家掌握 uni-app 项目的创建、运行、以及 Android 真机环境配置,内容侧重于动手操作,需要理解的部分较少,操作过程中遇到错误后,可以从头重新进行操作,直到环境正常运行。
在使用 uni-app 框架进行开发时有两种方式来创建项目,一种使用 cli 方式创建,另一种是通过 HBuilder X 方式创建,这两种方式本质上并无差别,采用哪种方式取决于自已项目的定位。
HBuilderX.exe
双击即可启动 HBuilder X 了,为了方便使用可以创建桌机快捷方式。注意千万不要将 HBuilder X 放到中文目录中!.dmg
程序uni-app 是基于 Vue.js 开发的框架,如果采用 Vue2 的语法可以使用 vue-cli
来创建项目:
# vue-cli 创建 uni-app 项目
vue create -p dcloudio/uni-preset-vue my-project
如果采用 Vue3 的语法可以通过 degit
从 github
仓库下载项目模板方式创建项目:
# 下载 git 仓库中的项目模板
npx degit dcloudio/uni-preset-vue#vite my-vue3-project
以上是使用 cli 方式创建基于 Vue2 和 Vue3 项目的操作步骤,一般会使用 VS Code 做为开发工具,这种方式创建的项目在 App 运行、调试、打包方面有所欠缺,因此如果要开发 App 的话,一般不采用该种方式。
在创建的项目中可以看到 Vue 的单文件组件,即 uni-app 创建的项目本质上就是 Vue 的项目,代码逻辑的细节我暂时先不去分析,先来看看 uni-app 的项目是如何启动的。
在 HBuilder X 菜单栏中找到【运行】或者按快捷键 Ctrl + R(Command + R)
至此便不难理解何谓跨端开发了,就是通过编定一套代码,分别打包不同平台的应用。
H5 端运行有两种方式,一种是运行到浏览器,另一种是运行到内置浏览器,当选择内置浏览器时会提示安装【内置浏览器】插件。
运行到小程序端里需要做两种事情,分别是设置小程序的【AppID】 和开启【服务端口】,以微信小程序为例:
运行到 App 端时需要先安装【真机运行插件】,如下图所示:
等待【真机运行插件】安装完毕后,再次打开【运行】=> 运行到手机或模拟器
从上图中可以看到,运行到 App 时 Android 和 IOS 分别又分为运行到【真机】和【模拟器】
真机,顾名思义就是真实的 Android 和 iPhone 手机
模拟器,是在电脑上虚拟出来的手机环境,Android 需要安装 Android Studio,IOS 需要安装 Xcode
选择【真机】还是【模拟器】呢?
Android 建议使用真机,IOS 建议使用模拟器
==================================================
开发 IOS 时只能在 Mac OS 平台下,Android 则在 Mac OS 和 Windows 下都可以,基于这个情况咱们介绍一下如何将 uni-app 项目运行到 Android 真机上。
=================================================
以上的步骤都是准备工作,接下来回到 HBuilder X 中,选择【运行】=>【运行到 Android App 基座】
首次在 App 中运行时还会自动安装【uni-app(Vue3)编译器】,安装完毕后【重新运行】就可以在手机中运行 uni-app 项目了。
没有 Android 手机怎么办?
可以第三方平台的【云手机】服务(一般都是付费的,但是有试用额度),推荐使用腾讯的 WeTest。
HBuilder X 的插件市场提供了大量的插件来提升项目开发的效率,刚刚在运行 uni-app 时就自动安装几个插件,本小节介绍一下 HBuilder X 插件的安装、管理以衣配置。
点击 HBuilder X 左下角的用户登录
注册完账号后,再次回到这里来进行登录。
找到【菜单】=>【工具】=>【插件安装】,在新打开的窗口中可以看到当前已经安装的插件
在插件市场通过搜索方式找到 Prettier 插件
点载下载插件并导入 HBuilder X 会自动打开 HBuilder X,并要求是否确认安装插件
打开 HBuilder X 的设置或使用快捷键 Ctrl + , (Command + ,)
安装了 Prettier 插件后默认为启用状态,需要大家补充的是自定义 Prettier 的生效文件范围,添加对 .js
文件的支持,接下来在项目的根目录中创建 .prettierrc
并添加如下配置:
{
"printWidth": 80,
"tabWidth": 2,
"useTabs": false,
"semi": false,
"singleQuote": true,
"vueIndentScriptAndStyle": true,
}
除上插件相关配置外,大家还需要对 HBuilder X 本身的设置做一些调整,主要有以下几个方面:
当配置了【保存自动格式】时,会自动的根据插件来进行代码格式化的处理,由于我们安装了 Prettier 插件,所以此时 HBuilder X 会提示我们是否要选择使用 Prettier 来格式化代码,不要选择内置。