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 文件へ的内容。

相关推荐
m0_748256785 分钟前
SpringBoot 依赖之Spring Web
前端·spring boot·spring
web1350858863534 分钟前
前端node.js
前端·node.js·vim
m0_5127446435 分钟前
极客大挑战2024-web-wp(详细)
android·前端
若川44 分钟前
Taro 源码揭秘:10. Taro 到底是怎样转换成小程序文件的?
前端·javascript·react.js
潜意识起点1 小时前
精通 CSS 阴影效果:从基础到高级应用
前端·css
奋斗吧程序媛1 小时前
删除VSCode上 origin/分支名,但GitLab上实际上不存在的分支
前端·vscode
IT女孩儿1 小时前
JavaScript--WebAPI查缺补漏(二)
开发语言·前端·javascript·html·ecmascript
m0_748256563 小时前
如何解决前端发送数据到后端为空的问题
前端
请叫我飞哥@4 小时前
HTML5适配手机
前端·html·html5
@解忧杂货铺5 小时前
前端vue如何实现数字框中通过鼠标滚轮上下滚动增减数字
前端·javascript·vue.js