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.
Tipos de implantação
A implantação pode ser classificada por identidade (registrada vs. não registrada) e por método: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
- Habilite o RfPC nas configurações de implantação do seu projeto.
- Configure o firewall (veja abaixo).
- Opcionalmente, ajuste as configurações de
XrfsSvceXbtpLinkSvcpara 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.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:
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.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.
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/SystemScratchfoi refinado.
Solução de problemas de implantação
Comece por:- Analisar e diagnosticar erros
- Solução de problemas comuns do GDK
- Problemas da plataforma de implantação (erros de XTF, falhas de instalação não registrada, diagnósticos do
xbtplink)