CONTRIBUTING.zh-CN.md
非常感谢您对 Farm 的贡献, 在您提交 Pull Request 之前, 请先阅读以下指南。
所有贡献者都应该遵循 Rust 行为规范。
目前 Farm 正在快速开发和迭代中, 在开发和使用中可能会遇到一些问题, 如果您遇到了一些我们不可预料的问题, 请提交 issues 用来报告错误问题, 通过新建一个 issues 来报告您所遇到的问题。
如果要创建新的功能或者特性, 请在 issues 中添加 feature request。
编写代码的时候, 请遵循代码编写规范。
设置您的本地开发环境。
在您的本地从 main 分支切出一个新的功能特性分支。
使用 cargo test 确保所有测试均能通过。
如果您已经更改了一些包并准备更新版本，则您应该在根目录中输出npx changeset 用来发布新版本并且提交。 我们应该尽量保持发布 patch 版本, 如果没有重大更改的情况下，请选择 更新 patch 版本
当你完成你的工作后，请通过 pnpm run ready 来验证是否可以在本地正常运行
Fork 并且 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
我们推荐使用 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 测试，在您提交代码之前，请确保所有测试均能通过。
cargo test 将会运行所有的 Rust 代码测试用例。# root path or crates path
cargo test
如果需要更新测试快照，你可以使用 INSTA_UPDATE=always cargo test
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。