> ## 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.

# 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)

<a id="general" />

## 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)](/pt-BR/tools/tools-console/commandlinetools/xbconnect), [XBOX Manager](/pt-BR/tools/tools-console/xbom/xbom) ou [Windows Device Portal](/pt-BR/tools/tools-console/wdp/wdp).
* **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](/pt-BR/build/core-features/common/game-config/MicrosoftGameConfig-Localization) para obter informações adicionais sobre como adicionar recursos localizados ao seu projeto.

**Figura 1.   A página de propriedades XBOX General** <img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/property_page_general.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=2dd98c01503a3c4b3a5a8fb40167fca2" alt="Página de propriedades General" width="1162" height="809" data-path="images/gdk/tools/property_page_general.png" />

<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.
</Note>

```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.

<a id="deploy" />

## 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](/pt-BR/home/setup-install/concepts/deployment).

### 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).

> <img src="https://mintcdn.com/microsoft-4404708b/z-rLYkO3Ax6HPtgm/images/gdk/tools/caution.gif?s=c35e42b8bb5ca0bdac12d10f6c467c29" alt="cuidado" width="11" height="11" data-path="images/gdk/tools/caution.gif" />**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)](/pt-BR/tools/tools-console/wdp/wdp) ou em [Developer Home no console (Dev Home)](/pt-BR/tools/tools-console/devhome/devhome).

**Figura 2.   As páginas de propriedades XBOX Deploy de acordo com o método de implantação** <img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/property_page_deploy.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=2645bd2b57441d389e5d623a215d9602" alt="Página de propriedades Deploy para Push" width="1173" height="817" data-path="images/gdk/tools/property_page_deploy.png" />

<img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/property_page_deploy_external.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=6956ecceabb322d6b75dae3477011d39" alt="Página de propriedades Deploy para External" width="1173" height="817" data-path="images/gdk/tools/property_page_deploy_external.png" />

<img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/property_page_deploy_rfpc.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=cc068e6967bb903be4e5a6c57149bd2c" alt="Página de propriedades Deploy para Run from PC" width="1173" height="817" data-path="images/gdk/tools/property_page_deploy_rfpc.png" />

<a id="layout" />

## 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** <img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/property_page_layout.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=996357b982ee8d5b00c0ea2b5252398c" alt="Página de propriedades Layout" width="785" height="545" data-path="images/gdk/tools/property_page_layout.png" />

<a id="debugging" />

## 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** <img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/property_page_debug.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=76a15961c2b3b73d8fc332052faa57f8" alt="Página de propriedades Debugging" width="1172" height="812" data-path="images/gdk/tools/property_page_debug.png" />

<a id="related" />

## 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**.

<a id="gamedependency" />

## 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.

<a id="ID4EIIAC" />

## Veja também

[Gerenciamento de aplicativos (xbapp.exe)](/pt-BR/tools/tools-console/commandlinetools/xbapp)

[Connect (xbconnect.exe)](/pt-BR/tools/tools-console/commandlinetools/xbconnect)

[Implantar seu título no seu dev kit XBOX](/pt-BR/home/setup-install/concepts/deployment)

[Como implantar arquivos de recursos do jogo usando o Visual Studio](/pt-BR/tools/tools-console/visualstudio/how-to-deploy-resources)


## Related topics

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