> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Implantando seu título em um dev kit

> Tipos de implantação (Push, Run from PC, Streaming Install), ferramentas (XBOX Manager, xbapp, Visual Studio) e dicas para acelerar a iteração (NIC de depuração, XTD, cache de dados).

<Note>
  A partir do GDK de março de 2022, o **Run from PC** oferece suporte a **Priority File Set** para controlar quais arquivos são armazenados em cache com o cache de dados — use isso para uma iteração previsível com Run from PC em combinação com o [DirectStorage](/build/console-features/console-features-overview).
</Note>

## Tipos de implantação

A implantação pode ser classificada por identidade (registrada vs. não registrada) e por método:

| Tipo | Descrição |
| - | - |
| **Push** | Copia o pacote completo para o armazenamento local do dev kit. A mais lenta de implantar, a mais rápida de executar. |
| **Run from PC (RfPC)** | Transmite arquivos do seu PC sob demanda. Rápida para iterar; oferece suporte a cache de dados para E/S representativa da versão de varejo. |
| **Streaming Install** | Simula a experiência de Streaming Install de varejo (instalação sob demanda, bloco a bloco). |
| **Registered / Unregistered Folder or Network** | Variantes para testar layouts de arquivos soltos e cenários de rede. |

### Implantação Push

Use Push quando quiser que a implantação tenha exatamente a aparência e o comportamento de uma instalação de varejo — o pacote reside inteiramente na unidade do dev kit.

### Run from PC

Transmite arquivos pela rede (**XBTP**) ou por meio de um compartilhamento SMB legado. Duas variantes:

* **RfPC sobre XBTP** (recomendado) — requer configuração do firewall e os serviços XrfsSvc / XbtpLinkSvc no PC.
* **RfPC legado baseado em compartilhamento SMB**.

#### Configuração do RfPC sobre XBTP

1. Habilite o RfPC nas configurações de implantação do seu projeto.
2. Configure o firewall (veja abaixo).
3. Opcionalmente, ajuste as configurações de `XrfsSvc` e `XbtpLinkSvc` para equipes grandes ou máquinas de build compartilhadas.

#### Configuração do firewall

Permita os processos XrfsSvc e XbtpLinkSvc no Firewall do Windows Defender no seu PC de desenvolvimento. As portas do XBTP são descritas em [Configurando o acesso à rede de desenvolvimento](/pt-BR/home/setup-install/devkits/settings/configure-dev-network).

#### Cache de dados (XBOX Series X Dev Kit)

O cache de dados espelha os arquivos que o RfPC serve para que o comportamento de E/S se aproxime bastante de uma implantação Push — útil ao iterar em caminhos de código do DirectStorage.

* Habilite / gerencie o cache pelo DevHome ou pelo XBOX Manager.
* O **Priority File Set** (GDK de março de 2022 em diante) permite pré-armazenar em cache arquivos específicos, melhorando a previsibilidade. As regras são criadas em um esquema de Priority File Set e podem ser aplicadas pela linha de comando ou pelo Visual Studio. Há suporte para geração automática.

#### RfPC legado com compartilhamento SMB

Ainda tem suporte. Requer compartilhamentos SMB no PC de desenvolvimento apontando para o layout do seu pacote. Links simbólicos têm suporte para redirecionar partes do pacote.

### Streaming Install

Instala em blocos enquanto o título é executado — exercita os caminhos de código do Streaming Install que seu título usará na versão de varejo.

## Ferramentas

### XBOX Manager

* **Default Deploy**
* Assistente **Deploy/Install Application**
* **Drag deploy**
* Implantação pelo **Folder Explorer**
* **Inicialização** de títulos implantados
* A lista **Games & Apps** exibe os tipos de implantação (Push, RfPC, não registrada).

### Prompt de comando (`xbapp`)

Implante e inicie a partir de scripts:

```text theme={null}
xbapp deploy <package>
xbapp launch <aumid>
xbapp launch /d <aumid>        REM defer execution (attach a debugger first)
```

### Visual Studio

Implante e inicie a partir dos destinos do MSBuild integrados ao GDK. Escolha o tipo de implantação nas propriedades do projeto.

### Outros inicializadores

* **XBOX Gaming Explorer** — inicie títulos implantados de dentro do Visual Studio.
* **DevHome** — inicie títulos pela interface do console.

### Pastas de sobreposição

Sobreponha arquivos individuais em cima de um pacote instalado para iteração rápida — sem reempacotar, sem reimplantar. Consulte [Depuração com pastas de sobreposição](/build/console-features/debugging-diagnostics/debugging-with-overlay-folders).

## Melhorando a velocidade de iteração

### Implante pela NIC de depuração

A segunda NIC do dev kit (10 GbE) é drasticamente mais rápida que a porta de 1 GbE para implantações.

**Pré-requisitos**

* Uma NIC de 10 GbE no seu PC de desenvolvimento e um switch de 10 GbE (ou cabo direto).
* Configure o adaptador de 10 GbE no PC de desenvolvimento.
* Aponte seu workspace para o IP da NIC de depuração.

Consulte [Usando a segunda NIC do dev kit](/build/console-features/debugging-diagnostics/devkit-second-nic).

### Implante com o XTD (XBOX Transfer Device)

O **XTD** transfere grandes volumes de dados via Thunderbolt.

* Nem todo dev kit oferece suporte ao XTD, então verifique a lista de compatibilidade nas especificações de hardware de varejo e de dev kit do XBOX.
* Configure o XTD no seu PC de desenvolvimento e conecte o cabo Thunderbolt ao dev kit.
* Solucione problemas com o fluxo de trabalho de diagnóstico padrão (veja abaixo).
* O XTD também acelera capturas e análises do PIX.
* **Combine o XTD com a NIC de depuração** para a iteração mais rápida possível.

## Mudanças com o GDK

* Suporte a **builds empacotadas lado a lado** — várias builds do mesmo título instaladas ao mesmo tempo.
* **Títulos XBOX One (ERA)** são implantados pelo caminho do GDK.
* Mudanças no **AUMID** — verifique os scripts de inicialização se você migrou do XDK.
* Atualizações do **scratch unificado** — o comportamento de `TitleScratch` / `SystemScratch` foi refinado.

## Solução de problemas de implantação

Comece por:

* [Analisar e diagnosticar erros](/build/console-features/debugging-diagnostics/inspecting-errors)
* [Solução de problemas comuns do GDK](/build/console-features/debugging-diagnostics/troubleshooting-common-issues)
* [Problemas da plataforma de implantação](/build/console-features/debugging-diagnostics/troubleshooting-common-issues) (erros de XTF, falhas de instalação não registrada, diagnósticos do `xbtplink`)


## Related topics

- [Desenvolva um novo título GDK](/pt-BR/home/build-first-title/developing-new-titles.md)
- [Compile e execute seu primeiro título de console com o GDKX](/pt-BR/home/build-first-title/first-console-title-walkthrough.md)
- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [Documentação de desenvolvimento de jogos XBOX](/pt-BR/index.md)
- [Integração de Parceiro XBOX para acesso e publicação](/pt-BR/home/onboarding.md)