【unibest文档】二、快速开始

大家好,我是 菲鸽,今天带给大家 unibest 文档系列文章第2篇 ------ 快速开始篇。欢迎食用~

unibest - 官方文档地址codercup.github.io/unibest-doc...

快速开始

  • 前置依赖

    • Node.js - >=v18
    • pnpm - >=7.30(推荐使用 8.12+
    • 文本编辑器 - 推荐使用 VSCode,可选 WebStrom
    • 辅助运行工具 - HBuilderX,运行 APP 还是离不开 HBuilderX

创建项目

通过下面的命令可以快速生成项目模板,pnpm create unibest <项目名称> ,如果不写 <项目名称> 会进入命令行交互模式。

bash 复制代码
pnpm create unibest my-project

如果使用 npm,可能有缓存,需要加上 @latest 标识,如果创建失败,请使用 pnpm 安装。

bash 复制代码
npm create unibest my-project
# 如果提示报错,或者生成的项目版本太旧,请使用下面的命令,增加 @latest 标识
npm create unibest@latest my-project

实际操作截图如下:

强烈推荐是用 pnpm,性能更好,速度更快,节省磁盘空间。

如果没有 pnpm 可以通过 npm i -g pnpm 安装。

create unibest 支持 -t 参数选择模板,目前已有两大类 8 个模板

  • 普通 模板( 6个 ):分别是 basedemouchartstabbari18njs
  • hbx 模板( 2个 ):分别是 hbx-basehbx-demo

不带 -t 参数时会默认生成 base 模板。

base 模板是最基本的模板,更新最及时,推荐使用 base 模板创建新项目。其他几个模板也是基于 base 模板得到的。 demo 模板则作为参考用。

js 模板不推荐使用,可以使用 base 模板替代,里面已经做了兼容配置,可以直接编写 js,原本的 ts 文件还能提供部分类型,何乐而不为?

sh 复制代码
# VS Code 模板
pnpm create unibest my-project # 默认用 base 模板
pnpm create unibest my-project -t base # 基础模板
pnpm create unibest my-project -t demo # 所有demo的模板(包括i18n)
pnpm create unibest my-project -t ucharts # 秋云图表模板
pnpm create unibest my-project -t tabbar # 自定义 tabbar 模板
pnpm create unibest my-project -t i18n # 多语言模板
pnpm create unibest my-project -t js # js 模板

# HBuilderX 模板,方便使用 uniCloud 云开发 (未来可以对接 uni-app x)
pnpm create unibest my-project -t hbx-base # hbx的base模板
pnpm create unibest my-project -t hbx-demo # hbx的demo模板,包含所有的demo

至于 uni-app x 模板,紧盯 uni-app 官方动向,等官方出来脚手架,unibest 将第一时间推出该模板。

安装、运行

bash 复制代码
pnpm i
pnpm dev
# dev默认运行的是h5,其他平台执行dev:<uni-platform>,如:
pnpm dev:mp-weixin

pnpm dev 之后在浏览器打开 http://localhost:9000/

其他平台构建和发布,查看第十一章节:《十一、运行发布篇》。

第一次 commit

bash 复制代码
git add .
git commit -m "feat: init project"

v3 代码块

vue 文件中,输入 v3tab 即可快速生成页面模板,可以大大加快页面生成。

原理:基于 VSCode 代码块生成。

全文完~

相关推荐
吴传逞1 天前
记一次uniapp微信小程序开发scss变量失效的问题
微信小程序·uni-app·scss
2501_915921432 天前
小团队如何高效完成 uni-app iOS 上架,从分工到工具组合的实战经验
android·ios·小程序·uni-app·cocoa·iphone·webview
2501_916008892 天前
uni-app iOS 文件管理与 itools 配合实战,多工具协作的完整流程
android·ios·小程序·https·uni-app·iphone·webview
!win !2 天前
uni-app项目Tabbar实现切换icon动效
小程序·uni-app
xw52 天前
uni-app项目Tabbar实现切换icon动效
前端·uni-app
2501_916007472 天前
uni-app iOS 文件调试常见问题与解决方案:结合 itools、克魔、iMazing 的实战经验
android·ios·小程序·https·uni-app·iphone·webview
豆豆(设计前端)2 天前
使用 Uni-app 打包 外链地址APK 及 iOS 注意事项
ios·uni-app
jingling5552 天前
uniapp | 解决组件样式不生效问题
前端·css·uni-app·html·学习方法
^Rocky2 天前
微信小程序(uniapp)实现连接蓝牙
微信小程序·uni-app·蓝牙连接
2501_915918412 天前
uni-app 项目 iOS 上架踩坑经验总结 从证书到审核的避坑指南
android·ios·小程序·https·uni-app·iphone·webview