playwright-dotnet/ROLLING.md

# Rolling Playwright-dotnet

## Pre-requisites

* install .NET SDK 5 with installer: https://dotnet.microsoft.com/download/dotnet/5.0
* install necessary build tools:
  ```bash
  ./build.sh --init
  # restart terminal after that
  ```

## Rolling

1. Checkout the upstream main/release branch of the `playwright` repository.
1. Checkout the main/release branch of the `playwright-dotnet` repository.
3. Pick the latest driver from GitHub Action where you want to roll to. For releases, it should be `1.X.Y`. For main branch, it should be something like `1.X.Y-<timestamp>`.
4. By default it will pick the `playwright` project from `../playwright`. You can override it by setting the `PW_SRC_DIR` environment variable.

```bash
./build.sh --roll <driver-version>
```

This will complete the entire process (downnload and set the new driver, re-generate API and transport channels, update the README).