mirror of
https://github.com/actions/runner.git
synced 2025-12-10 12:36:23 +00:00
41 lines
1.2 KiB
Markdown
41 lines
1.2 KiB
Markdown
# Contribution guide for developers
|
|
|
|
## Required Dev Dependencies
|
|
|
|
 Git for Windows [Install Here](https://git-scm.com/downloads) (needed for dev sh script)
|
|
|
|
## To Build, Test, Layout
|
|
|
|
Navigate to the `src` directory and run the following command:
|
|
|
|
 `dev {command}`
|
|
|
|
 `./dev.sh {command}`
|
|
|
|
**Commands:**
|
|
|
|
* `layout` (`l`): Run first time to create a full agent layout in `{root}/_layout`
|
|
* `build` (`b`): Build everything and update agent layout folder
|
|
* `test` (`t`): Build agent binaries and run unit tests
|
|
|
|
Sample developer flow:
|
|
|
|
```bash
|
|
git clone https://github.com/actions/runner
|
|
cd ./src
|
|
./dev.(sh/cmd) layout # the agent that build from source is in {root}/_layout
|
|
<make code changes>
|
|
./dev.(sh/cmd) build # {root}/_layout will get updated
|
|
./dev.(sh/cmd) test # run all unit tests before git commit/push
|
|
```
|
|
|
|
## Editors
|
|
|
|
[Using Visual Studio 2019](https://www.visualstudio.com/vs/)
|
|
[Using Visual Studio Code](https://code.visualstudio.com/)
|
|
|
|
## Styling
|
|
|
|
We use the .NET Foundation and CoreCLR style guidelines [located here](
|
|
https://github.com/dotnet/corefx/blob/master/Documentation/coding-guidelines/coding-style.md)
|