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 到本地。

_images/1638664526181-09b00c29-fc72-429a-bb99-3f009eae141e.png

  • 在 [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,等待合并。