` |
| Gerenciador de pacotes | `apt-get` | `choco` ou instaladores diretos |
## Como escrever blueprints para Windows
### Blueprint de plataforma única
Se o seu repositório for compatível apenas com Windows, use `runs-on: windows` no nível superior:
```yaml theme={null}
runs-on: windows
initialize:
- name: "Install Node.js"
uses: github.com/actions/setup-node@v4
with:
node-version: "20"
- name: "Install build tools"
run: |
choco install visualstudio2022buildtools -y
choco install python --version=3.12 -y
maintenance: |
npm install
knowledge:
- name: lint
contents: npm run lint
- name: test
contents: npm test
- name: build
contents: npm run build
```
### Blueprint multiplataforma
Para fazer o build do mesmo repositório tanto no Linux quanto no Windows, escreva cada plataforma como um documento YAML separado por `---`. Cada documento declara seu próprio rótulo `runs-on`. Consulte o destaque [YAML com vários documentos](/pt-BR/onboard-devin/environment/blueprints#blueprint-sections) no guia de blueprint para entender melhor esse formato.
```yaml theme={null}
runs-on: default
initialize: |
curl -LsSf https://astral.sh/uv/install.sh | sh
apt-get update && apt-get install -y build-essential
maintenance: |
uv sync
knowledge:
- name: test
contents: uv run pytest
---
runs-on: windows
initialize: |
choco install python --version=3.12 -y
maintenance: |
uv sync
knowledge:
- name: test
contents: uv run pytest
```
Cada documento gera um build do snapshot separado para a sua plataforma. As sessões são inicializadas a partir do snapshot específico da plataforma.
O YAML de nível superior deve ser um mapeamento, não uma sequência. Escrever o exemplo acima como uma única lista (`- runs-on: default` / `- runs-on: windows`) faz com que ele seja rejeitado pelo backend com `Invalid YAML: each YAML document must be a mapping, not a sequence; use '---' to separate multiple blocks`. Use o separador `---` mostrado acima.
## O campo `runs-on`
O campo `runs-on` corresponde a uma configuração de máquina registrada na sua conta:
| Valor | Plataforma |
| -------------------- | ------------------------- |
| `default` ou `linux` | Linux (plataforma padrão) |
| `windows` | Windows |
Você pode especificar `runs-on` como uma string ou uma lista:
```yaml theme={null}
# Plataforma única
runs-on: windows
# Múltiplas plataformas em um bloco (os mesmos comandos são executados em cada uma)
runs-on: [default, windows]
```
Quando um bloco lista várias plataformas, o sistema de build cria um snapshot por plataforma usando os mesmos comandos.
A sintaxe de lista executa comandos idênticos em todas as plataformas da lista. Use-a apenas quando os comandos forem realmente compatíveis com várias plataformas (e.g., `npm install`, `uv sync`). Para comandos específicos de cada plataforma (como `apt-get` no Linux ou `choco` no Windows), use o [formato com vários documentos](#multi-platform-blueprint) — um documento por plataforma, separado por `---`.
## Uso e custo
As sessões do Windows consomem aproximadamente **9% mais** uso (ACUs ou cota) em comparação com sessões equivalentes no Linux. Para saber como o uso é contabilizado, consulte [Uso](/pt-BR/admin/billing/usage#windows-sessions).
## Comportamento da sessão no Windows
### Shell
Nas sessões do Windows, o **Git Bash** é usado como shell padrão — o mesmo bash usado no Linux. A sintaxe padrão do bash funciona em ambas as plataformas:
```yaml theme={null}
- run: |
export MY_VAR="hello"
echo $MY_VAR
```
### Caminhos
O Windows usa o formato de caminho do Git Bash (`/c/...` em vez de `C:\...`):
```yaml theme={null}
# Caminhos Linux
- run: cp config.json ~/.config/myapp/config.json
# Caminhos Windows (formato Git Bash)
- run: cp config.json /c/Users/Administrator/.config/myapp/config.json
```
### Segredos
Os segredos ficam disponíveis como variáveis de ambiente durante as sessões, usando a sintaxe padrão do bash (`$SECRET_NAME`):
```yaml theme={null}
maintenance:
- name: "Configure registry"
run: |
npm config set //registry.npmjs.org/:_authToken $NPM_TOKEN
```
### Arquivos anexados
No Windows, os arquivos importados são gravados em `/c/Users/Administrator/.files/` em vez de `/home/ubuntu/.files/`.
### Computer Use
[Computer Use](/pt-BR/work-with-devin/computer-use) tem suporte completo em sessões do Windows. O Devin conta com um ambiente de desktop do Windows com acesso ao Chrome, mouse e teclado, o que permite testar apps web, bem como aplicativos de desktop nativos do Windows (e.g. apps WPF e WinForms) e gravar suas sessões de teste.
## Dicas de Blueprint para Windows
### Instalação de ferramentas
Use `choco` (Chocolatey) ou scripts de download direto:
```yaml theme={null}
initialize:
- name: "Install Chocolatey packages"
run: |
choco install git -y
choco install nodejs-lts -y
choco install python --version=3.12 -y
choco install dotnet-sdk -y
```
### Padrões comuns
**Projeto .NET:**
```yaml theme={null}
runs-on: windows
initialize:
- name: "Install .NET SDK"
run: |
choco install dotnet-sdk -y
maintenance: |
dotnet restore
knowledge:
- name: build
contents: dotnet build
- name: test
contents: dotnet test
- name: lint
contents: dotnet format --verify-no-changes
```
**Projeto Visual Studio / C++:**
```yaml theme={null}
runs-on: windows
initialize:
- name: "Install Visual Studio Build Tools"
run: |
choco install visualstudio2022buildtools -y
choco install visualstudio2022-workload-vctools -y
maintenance: |
msbuild /t:Restore MySolution.sln
knowledge:
- name: build
contents: msbuild MySolution.sln /p:Configuration=Release
- name: test
contents: vstest.console.exe bin/Release/Tests.dll
```