本地开发快速上手¶
首先,非常感谢您愿意贡献自己的力量让 FeelUOwn 播放器变得更好~
推荐的开发流程¶
这里假设读者已经对 Git 和 Python 相关工具比较熟悉
在 GitHub 上 fork 一份代码到自己名下
clone 自己 fork 的代码:
git clone git@github.com:username/FeelUOwn.git
在 Home 目录或者项目目录下创建一个虚拟环境(假设你已经安装 Python 3)
# 以在 Home 目录下创建虚拟环境为例 # 创建 ~/.venvs 目录,如果之前没有创建的话 mkdir -p ~/.venvs # 创建虚拟环境(大家也可以选择用 virtualenv) python3 -m venv ~/.venvs/fuo # 激活虚拟环境 source ~/.venvs/fuo/bin/activate # 安装项目依赖 pip3 install -e .
Note
在 Linux 或者 macOS 下,大家一般都是用 apt-get 或者 brew 将 PyQt5
安装到 Python 系统包目录,
也就是说,在虚拟环境里面, 不能 import 到 PyQt5 这个包 。建议的解决方法是:
- 创建一个干净的虚拟环境(不包含系统包)
pip3 install -e .
安装项目以及依赖- 将虚拟环境配置改成包含系统包,将
~/.venvs/fuo/pyvenv.cfg
配置文件中的include-system-site-packages
字段的值改为true
这样可以尽量避免包版本冲突、以及依赖版本过低的情况
以 debug 模式启动 feeluown
# 运行 feeluown -h 查看更多选项 feeluown --debug
修改代码
push 到自己的 master 或其它分支
给 FeelUOwn 项目提交 PR
(可选)在开发者群中通知大家进行 review
程序启动流程¶
feeluown(fuo)
命令入口文件为 feeluown/entry_points/run.py
,主函数为 run 函数。