Taro v4框架开发微信小程序(使用CLI创建项目与文件)

Taro 计划在 2024 年第二季度推出其 4.0 正式版,而目前我们正在使用这个版本的测试版进行学习。一旦 Taro 发布了最新版,相应的文档也会得到更新。

安装脚手架

安装 Taro 的 v4.0.0 CLI 工具:

bash 复制代码
npm i -g @tarojs/cli@beta

创建项目

命令格式:taro init 项目名称

例如,若要创建一个名为 learn-taro-wxapp 的项目,可如下操作:

bash 复制代码
taro init learn-taro-wxapp

# 亦可省略 CLI 工具的安装,直接使用 npx 创建项目
npx @tarojs/cli@beta init learn-taro-wxapp

执行上述命令后,CLI 工具会询问我们几个问题:

  • 项目介绍
  • 所选择的框架
  • 是否使用 TypeScript
  • 要使用哪种 CSS 预处理器
  • 选择的编译工具
  • 包管理器的选择
  • 模板源选项
  • 以及最后的模板选择

完成这些设置后,我们需要在项目根目录下的 project.config.json 文件中填入小程序的 appid

紧接着在终端中运行项目:

bash 复制代码
pnpm dev:weapp
# 或者
npm dev:weapp

在这个例子中,我使用 pnpm 作为包管理工具来启动项目。

打开微信开发者工具,目录路径指向编译后生成的 dist 目录,随后点击"确定"。

这样,我们便能预览到项目的效果。

项目结构

arduino 复制代码
├── dist                        // 编译结果所在的目录
|
├── config                      // 项目编译配置目录
|   ├── index.js                // 默认配置
|   ├── dev.js                  // 开发环境配置
|   └── prod.js                 // 生产环境配置
|
├── src                         // 源码所在目录
|   ├── pages                   // 页面文件夹
|   |   └── index               // index 页面目录
|   |       ├── index.tsx       // index 页面逻辑文件
|   |       ├── index.scss      // index 页面样式文件
|   |       └── index.config.ts // index 页面配置文件
|   |
|   ├── app.ts                  // 项目的入口文件
|   ├── app.scss                // 项目的通用样式文件
|   ├── app.config.ts           // 项目的入口配置文件
|   └── index.html              // 静态页面模板
|
├── project.config.json         // 微信小程序项目配置文件
|
├── .eslintrc                   // ESLint 配置文件
├── .editorconfig               // 编辑器格式配置文件
├── .gitignore                  // git 忽略文件配置
|
├── .env.dev                    // 开发环境变量文件
├── .env.prod                   // 生产环境变量文件
├── .env.test                   // 测试环境变量文件
|
├── project.tt.json             // 抖音小程序项目配置文件
|
├── jest.config.ts              // Jest 测试框架的配置文件
├── babel.config.js             // Babel 配置文件
├── tsconfig.json               // TypeScript 配置文件
|
└── package.json                // 项目依赖配置文件

创建页面

命令格式:taro create 文件名称

例如,若要创建一个名为 newPage 的页面,我们可以这么操作:

bash 复制代码
 taro create newPage

CLI 工具会在 src/pages 目录下生成一个 newPage 文件夹,当中会包含三个文件:index.tsxindex.scss 以及 index.config.ts。同时,在 app.config.ts 中会添加新页面的路径。

如果需要指定创建页面的目录:

命令格式:taro create 文件名 --dir 目录名称

bash 复制代码
 taro create newPage --dir mydir

如果需要为页面指定子包:

命令格式:taro create 文件名 --subpkg 子包名称

bash 复制代码
taro create newPage --subpkg mysubpages

要修改创建文件的默认模板内容,首先使用 npm root -g 命令查找全局 node_modules 的路径,例如,在我的电脑上路径为 C:\Users\55856\AppData\Local\pnpm\node_modules

接着,通过编辑器打开路径下的 @tarojs/cli 模块的 templates/default/src/pages/index/index.jsx 文件,我们就可以编辑模板的内容。

<Text> 标签的内容修改成 "辰火流光"。

现在,再用创建页面的命令,来测试刚才的修改是否生效:

结果显示,自定义模板的内容已经成功生效。

通过这种方式,你可以按需修改模板文件中的 index.cssindex.config.js 文件へ的内容。

相关推荐
twins352037 分钟前
解决Vue应用中遇到路由刷新后出现 404 错误
前端·javascript·vue.js
qiyi.sky1 小时前
JavaWeb——Vue组件库Element(3/6):常见组件:Dialog对话框、Form表单(介绍、使用、实际效果)
前端·javascript·vue.js
煸橙干儿~~1 小时前
分析JS Crash(进程崩溃)
java·前端·javascript
安冬的码畜日常1 小时前
【D3.js in Action 3 精译_027】3.4 让 D3 数据适应屏幕(下)—— D3 分段比例尺的用法
前端·javascript·信息可视化·数据可视化·d3.js·d3比例尺·分段比例尺
l1x1n02 小时前
No.3 笔记 | Web安全基础:Web1.0 - 3.0 发展史
前端·http·html
昨天;明天。今天。2 小时前
案例-任务清单
前端·javascript·css
zqx_73 小时前
随记 前端框架React的初步认识
前端·react.js·前端框架
惜.己3 小时前
javaScript基础(8个案例+代码+效果图)
开发语言·前端·javascript·vscode·css3·html5
什么鬼昵称4 小时前
Pikachu-csrf-CSRF(get)
前端·csrf
长天一色4 小时前
【ECMAScript 从入门到进阶教程】第三部分:高级主题(高级函数与范式,元编程,正则表达式,性能优化)
服务器·开发语言·前端·javascript·性能优化·ecmascript