一、github下载源码
远程地址:https://github.com/apache/superset,有github账号的可以先将源码fork到自己的仓库,再创建branch,相关git知识自行补充
下载:1(无git账号):git clone https://github.com/apache/superset;2(有git账号):从自己的库git clone到本地,再git check out yourbranch
二、环境搭建
后端环境需要python,下载安装(https://www.python.org/downloads/windows),搭建虚拟环境具体可参考文档:https://docs.python.org/zh-cn/3/library/venv.html
1、本地新建空文件夹,例:D:\dailyTest\VirtualEnv
输入命令:python -m venv D:\dailyTest\VirtualEnv
2、进入虚拟环境(以VS code为例)
其他工具请自行百度进入虚拟环境的方法
1)File(文件) -> Perference(首选项) -> Setting(设置) -> Python.Venv Path
Python.Venv Path 搜索不到时可在左侧应用商店下载python插件 重新打开Vs Code搜索
2)View(查看) -> Command Palette(命令面板) -> Python: Select Interpreter 点击选择
打开终端即进入虚拟环境 输入activate激活虚拟环境 也可在后续激活
三、下载依赖并启动superset
参考文档:https://github.com/apache/superset/blob/master/CONTRIBUTING.md
1、前端(superset-frontend)文件夹下:npm/yarn install
本地环境:package.json => "engines": { "node": "^14.15.5", "npm": "^7.5.4" }
1)webpack.config.js文件中include => 添加path.resolve(__dirname, './src')
2)npm run dev-server 可启动演示模板 需在webpack.proxy-config.js中配置后端接口
3)npm run dev 需配合后端 superset run -p 8088 --with-threads --reload --debugger 使用才能联调
2、后端(superset)文件夹,与CONTRIBUTING.md同目录下
Python版本3.7或3.8,依次执行以下命令:
# 创建一个虚拟环境并激活它(推荐) 如已激活则pass
python3 -m venv venv # setup a python3 virtualenv
source venv/bin/activate
# 安装外部依赖
pip install -r requirements/local.txt
# 在可编辑(开发)模式下安装Superset
pip install -e .
注:在以上两次安装可能会遇到问题,如:需要安装=>Microsoft Visual C++ Build Tools
error: Microsoft Visual C++ 14.0 is required. Get it with "Microsoft Visual C++ Build Tools": https://visualstudio.microsoft.com/downloads/
# 在元数据中创建一个管理用户(使用“admin”作为用户名,以便加载示例)
superset fab create-admin
# 初始化数据库
superset db upgrade
# 创建默认角色和权限
superset init
# 加载案例,前提是注册了“admin”用户
superset load-examples
# 设置环境
set FLASK_ENV=development
# 启动superset服务
superset run -p 8088 --with-threads --reload --debugger
至此,后端服务启动完成
四、后续更新如上图
superset 前端二次开发 => 接入Echarts,添加新图表:mix-line-bar