Propriedades do Visual Studio para desenvolvimento para 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.

• XBOX General
• XBOX Deploy
• XBOX Layout
• Debugging
• Páginas de propriedades relacionadas
• Pesquisa de dependências do jogo

​

XBOX General

• 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), XBOX Manager ou Windows Device Portal.
• 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 para obter informações adicionais sobre como adicionar recursos localizados ao seu projeto.

Figura 1. A página de propriedades XBOX General

  <?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>  

​

XBOX Deploy

​

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

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

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

• 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: 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) ou em Developer Home no console (Dev Home).

Figura 2. As páginas de propriedades XBOX Deploy de acordo com o método de implantação

​

XBOX Layout

• 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

​

Debugging

• 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áginas de propriedades relacionadas

​

Pesquisa de dependências do jogo

​

Veja também