贡献指南
非常感谢您对 Farm 的贡献, 在您提交 Pull Request 之前, 请先阅读以下指南。
行为规范准则
所有贡献者都应该遵循 Rust 行为规范。
错误报告
目前 Farm 正在快速开发和迭代中, 在开发和使用中可能会遇到一些问题, 如果您遇到了一些我们不可预料的问题, 请提交 issues 用来报告错误问题, 通过新建一个 issues 来报告您所遇到的问题。
创建新特性
如果要创建新的功能或者特性, 请在 issues 中添加 feature request。
提交代码指南
-
编写代码的时候, 请遵循代码编写规范。
-
设置您的本地开发环境。
-
在您的本地从
main分支切出一个新的功能特性分支。 -
使用
cargo test确保所有测试均能通过。 -
如果您已经更改了一些包并准备更新版本，则您应该在根目录中输出
npx changeset用来发布新版本并且提交。 我们应该尽量保持发布patch版本, 如果没有重大更改的情况下，请选择 更新patch版本 -
当你完成你的工作后，请通过
pnpm run ready来验证是否可以在本地正常运行
设置
-
Fock 并且 clone 仓库到本地。
-
为你的 PR 创建一个新的分支。
git checkout -b your-branch-name。 -
保证您的
main分支指向远程仓库, 并从分支上发出拉取请求, 请确保您的分支是基于main分支的, 并且运行:
git remote add upstream https://github.com/farm-fe/farm.git
git fetch upstream
git branch --set-upstream-to=upstream/main main
设置您的本地开发环境
依赖
IDE
我们推荐使用 vscode 进行开发, 并且我们推荐两个必要的插件
rust-analyzer支持rust语言。biome使用biome进行格式化和检查代码。
你可以在扩展中安装它们
其他依赖
TIP: 当您在初次开发时, 请确保您的本地环境已经安装了 protoc。如果您的本地环境没有安装 protoc，则在执行 pnpm bootstrap 时会触发脚本, 针对 mac linux 用户会自动安装 protoc, 针对 windows 用户不会自动安装, 但是可以根据提示自行下载安装。
运行项目
Farm 的开发启动非常简单, 您只需在根目录中执行 pnpm bootstrap 一条命令即可构建所有子包中需要构建的代码。
$ pnpm bootstrap # install the dependencies of the project with series of initialization operations.
-
使用
pnpm bootstrap安装依赖项，并通过一系列初始化操作构建核心包。 -
使用示例(打开新终端)：
cd examples/react && pnpm start，如果示例不能正常启动，则上报问题。 -
如果
examples/react正常运行，则表明开发环境配置成功。 -
如果您更改了
crates中的Rust代码，请再次运行Packages/core下的npm run build：rs以获取最新的二进制代码。
当你在开发 node 侧代码时, 根目录执行 pnpm start 就可以实时调试代码了，当你在开发 rust 侧代码时， 根目录执行 pnpm start:rs 就可以实时调试代码了
// node side
pnpm start
// rust side
pnpm start:rs
测试
我们还需要测试两个部分，一套 Rust 测试，一套 Node 测试，在您提交代码之前，请确保所有测试均能通过。
Rust 测试
- 在根目录下输入
cargo test将会运行所有的Rust代码测试用例。
# root path or crates path
cargo test
Node 测试
- 在根目录下输入
pnpm test基于vitest运行所有的Node代码测试用例。
# root path
pnpm test
通过脚手架快速创建插件
Farm 提供了一个脚手架来帮助您快速创建一个插件, 您可以通过以下命令来创建一个插件。
您可以 cd packages/cli 目录下, 运行 npm link 或者全局安装 @farmfe/cli 来使用,
安装完成之后, 您可以通过 farm plugin create 来创建一个插件, 支持 rust 和 js 插件
$ farm plugin create <plugin-name> # create a plugin support js or rust
小提示
Farm 整个项目分为两个部分, JavaScript 和 Rust。
-
JavaScript 部分: 查看 packages 文件夹中的代码, 包含核心包(开发服务, 文件监听, 编译器包装), 脚手架, 运行时和运行时插件 (模块系统, HMR 热更新)。
-
Rust 部分: 查看 crates 以及 rust-plugin 文件夹中的代码, 包含核心包 (编译上下文, 插件驱动等), 编译器 (编译进程、HMR 更新等), Rust 插件。
