uni-app (通过HBuilderX 和 VS Code 开发)详细连接过程教学。

发布于:2024-07-01 ⋅ 阅读:(22) ⋅ 点赞:(0)

使用 HBuilderX 创建 uni-app 项目 并编译到微信开发者工具。

uni-app 支持两种方式创建项目:
  1. 通过 HBuilderX 创建
  2. 通过命令行创建

首先我们需要先下载HBuilderX

下载链接地址:DCloud - HBuilder、HBuilderX、uni-app、uniapp、5+、5plus、mui、wap2app、流应用、HTML5、小程序开发、跨平台App、多端框架

 下载安装 HbuilderX 编辑器

下载会自动匹配电脑系统,直接下载即可,不需要更改。

 通过 HbuilderX 创建 uni-app vue3 项目

安装 uni-app vue3 编译器插件(可以让我们将vue3的代码编译到各端上面去)
编译成微信小程序端代码
路径只需初次使用时设置一次即可

 通过 HBuilderX 创建 uni-app 项目

首先我们需要下载微信小程序:

下载链接:微信开发者工具下载地址与更新日志 | 微信开放文档 (qq.com)

进入小程序点击设置进行开启服务端口(服务端口只需初次使用时开启一次即可

在 HBuilderX 中新建一个uniapp项目

之后直接运行到微信开发者工具上面即可。(会自动继续打开跳转)

整体流程:

 使用 VS Code 创建 uni-app 项目 并编译到微信开发者工具。

 准备工作

1. 下载vscode 地址Download Visual Studio Code - Mac, Linux, Windows

 找一下教程傻瓜式安装即可,这里不过多解释。

为什么选择 VS Code ?
  • HbuilderX 对 TS 类型支持暂不完善
  • VS Code 对 TS 类型支持友好,熟悉的编辑器

例如:

安装插件:

 

创建一个uniapp项目方式:

1.如果下载了HBuilderX :

在HBuilderX创建项目之后直接使用 vs code 打开文件夹即可

适用:

  1. 支持 js 创建模板   (没有ts模板)
  2. 模板类型多种多样  快速高效   
  3. 在vs code 中无需配置 可以直接使用uniapp-run运行到微信开发者工具上面tsconfig.json

2. 没有下载了HBuilderX

使用 cli 脚手架,可以通过 vue-cli 创建 uni-app 项目。

流程:

环境安装

全局安装 vue-cli

npm install -g @vue/cli

创建以 typescript 开发的工程(如命令行创建失败,请直接访问 giteeicon-default.png?t=N7T8https://gitee.com/dcloud/uni-preset-vue/repository/archive/vite-ts.zip 下载模板)

npx degit dcloudio/uni-preset-vue#vite-ts my-vue3-project

 my-vue3-project(为你想要的文件名称) 自行修改即可

此时,会提示选择项目模板(使用Vue3/Vite版不会提示,目前只支持创建默认模板),初次体验建议选择 hello uni-app 项目模板,如下所示:

注意

  • Vue3/Vite版要求 node 版本 18+、20+

 适用:

适合创建 ts 的 uniapp 的模板

运行方式:

在vscode中下载插件

点击设置  >  扩展设置

我们需要配置

 HBuilderX 和vscode 的安装路径 方便我们运行的时候 自启动

看自己电脑上面的安装路径即可 到文件夹的位置比如 

这个文件夹下面即可

HBuilderX 同理 

接下来我们就可以尝试运行了

点击侧边栏

点击添加配置

如果第一次使用可以使用默认模版方式快速创建 launch.json

 点击运行旁边的选择

对文件进行配置

 新增如下两条 

上面其他的是默认的,无需修改

"vueVersion": "v3",  // vue版本
"openDevTool": true,  // 是否自动启动模拟器

添加完成之后点击启动即可

问题:

使用HBuilderX 创建的 js  模板不会有问题

直接在此目录下运行即可

但是  使用 脚手架创建的 ts 模板有些问题

这是我们所在的目录结构

运行时候报错

我们发现使用 uniapp run 运行的时候它直接找 my-vue3-project 下的 manifest.json文件

但是我们创建的ts模板 manifest.json文件在src下面 才会产生这样的问题

为了不报错 我们需要手动配置一些内容

首先 

在我们的ts模板目录下面安装

pnpm i -D @types/wechat-miniprogram @uni-helper/uni-app-types

并且配置一下 tsconfig.json 文件

{
  "extends": "@vue/tsconfig/tsconfig.json",
  "compilerOptions": {
    "sourceMap": true,
    "baseUrl": ".",
    "paths": {
      "@/*": ["./src/*"]
    },
    "lib": ["esnext", "dom"],
    "types": ["@dcloudio/types",
    "@types/wechat-miniprogram",
    "@uni-helper/uni-app-types"
  
  ]
  },
  "vueCompilerOptions": {
    "nativeTags": ["block", "component", "template", "slot"]
   },
  "include": ["src/**/*.ts", "src/**/*.d.ts", "src/**/*.tsx", "src/**/*.vue"]
}

 这样我们运行的时候也不会有类型校验的问题

还有一个问题

当我们配置完成之后再次运行 还是报错 因为我们并没有改变运行路径只是修改了类型校验的问题

我们修改我们文件的运行位置将目录进入到src中

再次运行 

成功运行 并且弹出了微信开发者工具

至此 使用vscode 并且使用ts模板的配置 全部完成.


网站公告

今日签到

点亮在社区的每一天
去签到