11.2. 如何贡献 PikaPython BSP
11.2.1. 制作 BSP 的步骤:
11.2.1.1. 制作 pikapython 模板工程
pikapython 的 BSP 很简单,就是一个可以独立编译的 pikapython 模板工程。
这个工程只需要能够最基本地运行 pikapython 即可。
可以参考新平台移植指南,确保能够正常运行 main.py 中的
print('hello PikaPython!')
。
11.2.1.2. 清理工程
清理编译产物,只留下工程文件和源码。( 编译产物包括中间文件 .o .d ,二进制产物 .bin, .hex ,可执行文件 .exe 等)。
清理 pikapython 文件夹中自动拉取和自动生成的代码,pikapython 文件夹只保留 main.py,requestment.txt, pikaPackage.exe 文件即可。
清理没有用到的源码和库,将工程的体积控制在到50MB以内。如果清理后工程体积仍大于50MB,可以新建一个专门仓库放置BSP,在 pikapython/bsp 中仅放置一个包含专门仓库链接的 README.md。
11.2.1.3. 提交文件
进入 pikapython 代码仓库,gitee 或 github 均可,fork 一份 pikapython 仓库,然后将 fork 后的仓库 clone 到本地。
在 [fork后的仓库]/bsp 目录下新建一个新文件夹,然后拷贝进去模板工程,使用 git 命令添加文件,并推送到 fork 后的 pikapython 仓库中。
cd pikapython/bsp
git add *
git commit -m 'add bsp'
git push
(可选)在 pikapython/README.md 和 pikapython/README_zh.md 中更新 BSP 信息。
开启 Pull Request,等待合并。