Skip to content
On this page

准备工作

源码

阅读开发文档前,请确保手上已经有 Fantastic-admin 源码,因为文档中提及的内容,都是需要在本地项目中编写或修改代码并运行才能呈现的。如果还没有源码,可以通过下面两种方式获取:

基础版

分支说明

  • master 框架源码分支,不含示例代码,可直接用于实际开发
  • example 演示源码分支,同演示站,在框架源码基础上,提供了大量示例代码

手动下载

推荐去 Github Releases 页面下载最新版本的压缩包,如下图所示:

git 克隆

不推荐

因为你将会获得到一份还未正式发布的最新源码,里面可能包含了新的特性,也可能包含修改变更,但最重要的是这份源码是不稳定的。

sh
# 从 Gitee 克隆

# 拉取框架源码
git clone https://gitee.com/hooray/fantastic-admin.git
# 拉取演示源码
git clone -b example https://gitee.com/hooray/fantastic-admin.git
sh
# 从 Github 克隆

# 拉取框架源码
git clone https://github.com/hooray/fantastic-admin.git
# 拉取演示源码
git clone -b example https://github.com/hooray/fantastic-admin.git

专业版

专业版用户会邀请加入到私有组织,获取源码的方式和基础版一致,只是仓库地址不同。

如果你想获取专业版源码,可以点这里去购买。

JS 版本

框架目前仅提供 TS 版本,如果需要使用 JS 版本,可以在仓库 tags 或 releases 页面里找到 v1.0.0 版本,这个是最后更新的 JS 版本,注意这是框架源码,演示源码只能从 git 提交记录中找了。

开发环境

使用本模板前,需要在本地依次安装好 Node.js, pnpm, GitVisual Studio Code

注意

Node.js 版本需 >= 14.18.0 ,建议为 16.x

然后在 Visual Studio Code 里安装好以下扩展:

在 Visual Studio Code 里打开源码的文件夹,右下角会自动提示需要安装的依赖,直接点击安装即可。

建议

以上 6 个为开发时必备扩展,以下则是作者建议安装的扩展,安装它们将在一定程度上提升开发效率。

除此之外,还需要准备好开发使用的浏览器,推荐使用 Chrome ,并且在 Chrome 里安装好 Vue.js devtools 扩展,安装 Vue 官方提供的调试工具在一定程度上可以提升解决 bug 的效率,当然这个扩展开启后,可能在开发环境操作会有些许卡顿,建议不需要时候可以将扩展禁用。

不过由于安装 Vue.js devtools 需要访问 Chrome 应用商店,如果在大陆地区访问,需要自行准备相关可访问外网的工具。如果不具备该条件,也可访问 Vue.js devtools 官网 了解本地构建或者下载支持 Edge/Firefox 的 Vue.js devtools 。

技术栈

了解并熟悉框架使用到的技术栈,能让你使用本框架更得心应手。