Pular para o conteúdo principal
Quando você usa o Visual Studio para implantar ou iniciar um projeto do XBOX One Software Development Kit, o conteúdo do subdiretório de projeto Gaming.Xbox.XboxOne.x64\Layout\Image\Loose é implantado no console. Quando você compila um projeto do Microsoft Game Development Kit para XBOX, os arquivos de aplicativo compilados são copiados automaticamente para esse diretório e implantados. Para implantar recursos adicionais do jogo, como texturas e sombreadores, os arquivos deles também precisam ser copiados para o subdiretório Loose do projeto do XBOX One XDK. O diretório Loose é relativo ao diretório do projeto. Por exemplo, se o projeto estiver armazenado no diretório c:\MyProjects\D3D12Game1\D3D12Game1, o diretório Loose será um subdiretório do projeto, localizado aqui: c:\MyProjects\D3D12Game1\D3D12Game1\Gaming.Xbox.XboxOne.x64\Layout\Image\Loose. Todos os arquivos colocados no diretório Loose, seja manualmente ou como parte do processo de build, são implantados com o seu aplicativo. Os arquivos do diretório Loose são implantados com o mesmo caminho relativo que têm no diretório Loose. Por exemplo, os arquivos em Loose\Models são implantados em um subdiretório Models no console. Os arquivos do diretório Loose não são excluídos ao compilar ou limpar o projeto, a menos que existam como conteúdo no projeto (veja Adicionar arquivos ao projeto a seguir). Há três formas principais de adicionar arquivos a Gaming.Xbox.XboxOne.x64\Layout\Image\Loose.

Copiar arquivos manualmente

Copiar arquivos manualmente para o diretório Loose faz com que eles sejam implantados com o projeto enquanto permanecerem no diretório.

Para adicionar arquivos manualmente

  • Use o xcopy para copiar os arquivos do diretório do projeto para o diretório \Layout\Image\Loose.
Esse método é rápido e fácil, mas pode causar problemas se você trabalhar com um laboratório de build ou com desenvolvedores que não copiam todos os arquivos necessários. Os arquivos copiados manualmente para o diretório Loose continuam sendo implantados enquanto estiverem no diretório. Os arquivos copiados manualmente para o diretório Loose não são excluídos quando o projeto é compilado ou limpo. Para impedir que os arquivos sejam implantados, eles precisam ser excluídos do diretório Loose.

Copiar com um evento pós-build

Criar um evento pós-build no Visual Studio para copiar arquivos faz com que eles sejam copiados para o diretório Loose sempre que você compila o projeto. Além disso, um evento pós-build pode usar $(ProjectDir) e $(LayoutDir), propriedades do Visual Studio que identificam o diretório do projeto e o diretório de layout, respectivamente. Por exemplo, a linha de comando a seguir faz com que um arquivo, MyPicture.bmp, seja copiado do diretório do projeto para \Image\Loose no diretório Layout, de onde a implantação o copia para o console.

Para adicionar arquivos usando um evento pós-build

  1. Abra a caixa de diálogo Property Pages do seu projeto. Em Build Events, selecione a página Post-Build Event.
Figura 1. Especificar uma linha de comando para o evento pós-build. Direct3DGame1 Property Pages
  1. Em Command Line, insira uma linha de comando que use o xcopy para copiar os arquivos do diretório do projeto para o diretório Layout\Image\Loose.
Por exemplo, xcopy**(ProjectDir)∗∗∗file−name∗∗∗(ProjectDir)***file-name***(LayoutDir)Image\Loose**, em que file-name corresponde ao nome do arquivo ou dos arquivos que você deseja copiar.
Os arquivos copiados para o diretório Loose com um evento pós-build continuam sendo implantados enquanto estiverem no diretório, mesmo que o evento pós-build seja removido do projeto. Os arquivos copiados para o diretório Loose com um evento pós-build não são excluídos quando o projeto é compilado ou limpo. Para impedir que os arquivos sejam implantados, eles também precisam ser excluídos do diretório Loose.

Adicionar arquivos ao projeto

Os arquivos também podem ser adicionados ao projeto como recursos. Os recursos do projeto são copiados automaticamente para o diretório Loose e implantados com o projeto.

Para adicionar arquivos como um recurso do projeto

  1. Clique com o botão direito do mouse no projeto e selecione Add, Existing Item.
  2. Selecione o item a ser adicionado ao projeto.
  3. Abra a janela de propriedades do recurso e verifique se a propriedade Content está definida como Yes.
Esse método trata os arquivos exatamente como os outros arquivos do projeto, como o executável. Os arquivos são excluídos ao compilar ou limpar o projeto e são copiados automaticamente para o diretório Loose e implantados com o projeto. Remover o arquivo do projeto também o remove do diretório Loose.

Veja também

Implantação no XBOX One
Última modificação em 8 de outubro de 2026