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

# Propriedades do Visual Studio para desenvolvimento para XBOX

> Propriedades do Visual Studio para desenvolvimento para XBOX

O Microsoft Game Development Kit (GDK) tem páginas de propriedades personalizadas do Visual Studio que são usadas para configurar projetos XBOX.

#### Para acessar as páginas de propriedades do XBOX

1. No **Solution Explorer**, clique com o botão direito do mouse no nome do projeto e selecione **Properties**.
2. Expanda **Configuration Properties**.
3. Observe as páginas de propriedades **XBOX General**, **XBOX Deploy**, **XBOX Layout** e **Debugging**.

As seguintes páginas de propriedades do **XBOX** e relacionadas estão disponíveis.

* [XBOX General](#general)
* [XBOX Deploy](#deploy)
* [XBOX Layout](#layout)
* [Debugging](#debugging)
* [Páginas de propriedades relacionadas](#related)
* [Pesquisa de dependências do jogo](#gamedependency)

## XBOX General

A página de propriedades **XBOX General** contém as propriedades a seguir.

* **Gaming Edition Target.** Especifica a edição do GDK com a qual o projeto será compilado. O padrão é a versão mais alta do GDK instalada no seu PC de desenvolvimento.
* **Gaming Extension Libraries.** Especifica o conjunto de bibliotecas Gaming Extension a ser usado (como Xbox.Services.API.C).
* **Alternate Binary Subdirectory** Essa propriedade opcional é usada para especificar um subdiretório para os binários e as dependências do CRT na raiz do jogo. Ela é usada para espelhar a estrutura da pasta Layout e será utilizada pelo depurador para encontrar o executável durante a depuração. Ao especificar um subdiretório, o MicrosoftGame.config ainda deve ficar na raiz do título. Quaisquer alterações de caminho no MicrosoftGame.config para o local do executável também devem ser atualizadas.
* **Remote IP Address.** Especifica o nome ou o endereço IP do console remoto. Esse é o console no qual os projetos compilados são implantados, executados e depurados. Se essa propriedade for deixada em branco, ou definida como em branco, será usado o console remoto padrão especificado por [Connect (xbconnect.exe)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbconnect.md), [XBOX Manager](https://docs.xbox.com/pt-BR/tools/tools-console/xbom/xbom.md) ou [Windows Device Portal](https://docs.xbox.com/pt-BR/tools/tools-console/wdp/wdp.md).
* **Package Localization Dir.** Especifica um diretório opcional, relativo ao diretório do projeto, para uso ao criar recursos localizados do shell.  Veja [Localização do MicrosoftGame.config](https://docs.xbox.com/pt-BR/build/core-features/common/game-config/MicrosoftGameConfig-Localization.md) para obter informações adicionais sobre como adicionar recursos localizados ao seu projeto.

**Figura 1.   A página de propriedades XBOX General** ![Página de propriedades General](https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/property_page_general.png?fit=max\&auto=format\&n=6TXzXmujKayly5Sf\&q=85\&s=2dd98c01503a3c4b3a5a8fb40167fca2)

> [!NOTE]
>
> Também é possível especificar o IP remoto em um arquivo *project*.vcxproj.user, armazenado junto com *project*.vcxproj no diretório do projeto. Esse arquivo deve ter o formato a seguir.

```text theme={null}
  <?xml version="1.0" encoding="utf-8"?>  
  <Project ToolsVersion="4.0" xmlns="https://schemas.microsoft.com/developer/msbuild/2003">  
    <PropertyGroup>  
      <RemoteAddress>10.10.10.10</RemoteAddress>  
    </PropertyGroup>  
  </Project>  
```

No exemplo anterior, *10.10.10.10* é substituído pelo endereço do seu console remoto.

## XBOX Deploy

A página de propriedades **XBOX Deploy** permite selecionar cada método de implantação. Com base na seleção, a página de propriedades incluirá opções diferentes. Para obter mais informações sobre implantação, veja [Implantar seu título no seu dev kit XBOX](https://docs.xbox.com/pt-BR/home/setup-install/concepts/deployment.md).

### Método de implantação do XBOX: Push (executar a partir do devkit)

Esse método de implantação implanta o título em uma pasta do devkit (xD:\Titles por padrão). Esse método de implantação contém as propriedades a seguir.

* **Deployment folder path override.** Propriedade opcional usada para substituir o caminho de implantação padrão no devkit.
* **Remove extra files from target device.** Propriedade opcional que, quando marcada, remove os arquivos encontrados no console que não fazem parte da saída de build do projeto (arquivos órfãos).

### Método de implantação do XBOX: External (o Visual Studio não é usado para a implantação)

Esse método de implantação delega a implantação a um mecanismo externo e independente. Esse método de implantação contém as propriedades a seguir.

* **Title launch string.** Cadeia de caracteres de inicialização usada para iniciar o título quando a depuração é iniciada (F5).
* **Target devkit titles.** Selecione em uma lista de títulos correspondentes ao projeto atual no devkit de destino para preencher a cadeia de caracteres de inicialização do título.

### Método de implantação do XBOX: Run from PC (registrar compartilhamento de rede)

Esse método de implantação executa o título a partir do PC de desenvolvimento por meio de um compartilhamento de rede acessível ao devkit.

* **Network share path override.** Propriedade opcional usada para substituir o caminho padrão do compartilhamento de rede para a implantação Run From PC.
* **Network share username.** Propriedade opcional usada para acessar locais de compartilhamento de rede que exigem credenciais (compartilhamento de rede SMB).
* **Network share password.** Propriedade opcional usada para acessar locais de compartilhamento de rede que exigem credenciais (compartilhamento de rede SMB).

> ![cuidado](https://mintcdn.com/microsoft-4404708b/z-rLYkO3Ax6HPtgm/images/gdk/tools/caution.gif?s=c35e42b8bb5ca0bdac12d10f6c467c29)**CUIDADO:** esse nome de usuário e essa senha são passados como texto sem formatação e armazenados localmente como texto sem formatação. Para maior segurança, deixe esse campo em branco e gerencie suas credenciais conforme mostrado em [XBOX Device Portal (Windows Device Portal no XBOX)](https://docs.xbox.com/pt-BR/tools/tools-console/wdp/wdp.md) ou em [Developer Home no console (Dev Home)](https://docs.xbox.com/pt-BR/tools/tools-console/devhome/devhome.md).

**Figura 2.   As páginas de propriedades XBOX Deploy de acordo com o método de implantação** ![Página de propriedades Deploy para Push](https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/property_page_deploy.png?fit=max\&auto=format\&n=6TXzXmujKayly5Sf\&q=85\&s=2645bd2b57441d389e5d623a215d9602)

![Página de propriedades Deploy para External](https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/property_page_deploy_external.png?fit=max\&auto=format\&n=6TXzXmujKayly5Sf\&q=85\&s=6956ecceabb322d6b75dae3477011d39)

![Página de propriedades Deploy para Run from PC](https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/property_page_deploy_rfpc.png?fit=max\&auto=format\&n=6TXzXmujKayly5Sf\&q=85\&s=cc068e6967bb903be4e5a6c57149bd2c)

## XBOX Layout

A página de propriedades **XBOX Layout** contém as propriedades a seguir.

* **Layout Directory.** Especifica o diretório local em que os resultados do build são organizados. É a partir desse diretório que o aplicativo é implantado no console remoto.
* **Exclusion Filter.** Especifica arquivos e tipos de arquivo que não serão copiados do diretório de saída do build para o diretório de layout. Observe que essa propriedade não pode ser usada para excluir arquivos que ficam fora do diretório de saída do build.
* **Isolate Configurations.** Quando definida como **Yes**, o Visual Studio trata cada configuração de build como uma saída separada para determinar a lista de arquivos copiados para o diretório de layout. O padrão é **No**.
* **Game OS.** Especifica o caminho para o Game OS a ser fornecido com o layout de arquivos soltos de um título.
* **Deploy from Outdir.** Quando definida como **Yes**, o Visual Studio implantará o conteúdo do diretório de saída do build em vez de copiar os arquivos para o diretório de layout antes da implantação.  Os valores das propriedades **Layout Directory**, **Exclusion Filter** e **Isolate Configurations** serão ignorados.

**Figura 3.   A página de propriedades XBOX Layout** ![Página de propriedades Layout](https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/property_page_layout.png?fit=max\&auto=format\&n=6TXzXmujKayly5Sf\&q=85\&s=996357b982ee8d5b00c0ea2b5252398c)

## Debugging

A página de propriedades **Debugging** contém as propriedades a seguir.

* **Debugger to launch:** para projetos XBOX, selecione **XBOX Game Core Debugger**.
* **Debugger Type.** Especifica o tipo de depurador a ser usado. Quando definido como Auto, o tipo de depurador é selecionado com base no conteúdo do arquivo .exe.
* **Command Arguments.** Os argumentos de linha de comando a serem passados para o aplicativo.
* **Log Module Loading.** Habilita a saída de depuração detalhada, que inclui informações sobre o carregamento de módulos.  A opção **Log Module Loading** é útil para depurar problemas do tipo "dependent dll was not found".

**Figura 4.   A página de propriedades Debugging** ![Página de propriedades Debugging](https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/property_page_debug.png?fit=max\&auto=format\&n=6TXzXmujKayly5Sf\&q=85\&s=76a15961c2b3b73d8fc332052faa57f8)

## Páginas de propriedades relacionadas

Há propriedades adicionais que, embora não sejam exclusivas do XBOX, têm configurações obrigatórias ou recomendadas para aplicativos XBOX. Essas configurações garantem o funcionamento adequado e ideal dos aplicativos XBOX e são as seguintes.

**RandomizedBaseAddress:** precisa ser definida como **Yes**, que é o padrão para um projeto do GDK. Essa configuração é necessária para que a randomização do layout do espaço de endereço (ASLR) funcione. A ASLR é obrigatória para aplicativos XBOX. Não defina **RandomizedBaseAddress** como **No** nem tente desabilitar a ASLR.

**RandomizedBaseAddress** é definida na página de propriedades **Linker**/**Advanced**.

## Pesquisa de dependências do jogo

Ao especificar uma dependência do jogo no seu projeto, a pesquisa examinará o caminho local, além da raiz do jogo G: e de todos os subdiretórios, para encontrar os arquivos dependentes.

## Veja também

[Gerenciamento de aplicativos (xbapp.exe)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbapp.md)

[Connect (xbconnect.exe)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbconnect.md)

[Implantar seu título no seu dev kit XBOX](https://docs.xbox.com/pt-BR/home/setup-install/concepts/deployment.md)

[Como implantar arquivos de recursos do jogo usando o Visual Studio](https://docs.xbox.com/pt-BR/tools/tools-console/visualstudio/how-to-deploy-resources.md)


## Related topics

- [Visual Studio para desenvolvimento para console](https://docs.xbox.com/pt-BR/tools/tools-console/visualstudio/visualstudio.md)
- [Notas de suporte do GDK para o Visual Studio 2022](https://docs.xbox.com/pt-BR/tools/tools-console/visualstudio/vs-2022-support-notes.md)
- [Notas de suporte do GDK para o Visual Studio 2026](https://docs.xbox.com/pt-BR/tools/tools-console/visualstudio/vs-2026-support-notes.md)
- [Depurar projetos XBOX usando o Visual Studio](https://docs.xbox.com/pt-BR/tools/tools-console/visualstudio/debugging-with-visualstudio.md)
- [XBOX Gaming Project Control](https://docs.xbox.com/pt-BR/tools/tools-console/visualstudio/xbox-gaming-project-control.md)
