【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 代码块生成。

全文完~

相关推荐
小徐_23331 天前
uni-app vue3 也能使用 Echarts?Wot Starter 是这样做的!
前端·uni-app·echarts
iOS阿玮2 天前
永远不要站在用户的对立面,挑战大众的公知。
uni-app·app·apple
xw52 天前
uni-app中v-if使用”异常”
前端·uni-app
!win !2 天前
uni-app中v-if使用”异常”
前端·uni-app
2501_915918412 天前
iOS 上架全流程指南 iOS 应用发布步骤、App Store 上架流程、uni-app 打包上传 ipa 与审核实战经验分享
android·ios·小程序·uni-app·cocoa·iphone·webview
00后程序员张2 天前
iOS App 混淆与加固对比 源码混淆与ipa文件混淆的区别、iOS代码保护与应用安全场景最佳实践
android·安全·ios·小程序·uni-app·iphone·webview
00后程序员张2 天前
详细解析苹果iOS应用上架到App Store的完整步骤与指南
android·ios·小程序·https·uni-app·iphone·webview
海绵宝宝不喜欢侬2 天前
uniapp-微信小程序分享功能-onShareAppMessage
微信小程序·小程序·uni-app
2501_915106322 天前
Xcode 上传 ipa 全流程详解 App Store 上架流程、uni-app 生成 ipa 文件上传与审核指南
android·macos·ios·小程序·uni-app·iphone·xcode
xkxnq2 天前
Uniapp崩溃监控体系构建:内存泄漏三维定位法(堆栈/资源/线程)
uni-app