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

# Como implantar arquivos de recursos do jogo usando o Visual Studio

> Como implantar arquivos de recursos do jogo usando o Visual Studio

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](#ID4ESC)
* [Copiar com um evento pós-build](#ID4EXD)
* [Adicionar arquivos ao projeto](#ID4E6F)

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

```text theme={null}
xcopy $(ProjectDir)MyPicture.bmp $(LayoutDir)Image\Loose  
```

#### 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](https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/property_page_post_build_event.png?fit=max\&auto=format\&n=6TXzXmujKayly5Sf\&q=85\&s=cfb00340e22c3878087e359b539a02ff)

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***$(LayoutDir)Image\Loose\*\*, em que *file-name* corresponde ao nome do arquivo ou dos arquivos que você deseja copiar.

> [!NOTE]
>
> 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](/pt-BR/home/setup-install/concepts/deployment)


## Related topics

- [Propriedades do Visual Studio para desenvolvimento para XBOX](/pt-BR/tools/tools-console/visualstudio/durango-property-pages.md)
- [Visual Studio para desenvolvimento para console](/pt-BR/tools/tools-console/visualstudio/visualstudio.md)
- [Depurar projetos de PC usando o Visual Studio](/pt-BR/tools/tools-pc/visualstudio/gr-vs-debugging-with-visualstudio.md)
- [Depurar projetos de PC em dispositivos Windows remotos no Visual Studio](/pt-BR/tools/tools-pc/visualstudio/gr-vs-debugging-with-visualstudio-remote-windows.md)
- [Visual Studio (conteúdo)](/pt-BR/tools/tools-pc/visualstudio/gr-visualstudio-toc.md)
