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

# Utilizando as ferramentas do Microsoft Game Development Kit (GDK) para instalar e iniciar seu título para PC

> Como usar as ferramentas do Microsoft Game Development Kit (GDK) para instalar, iniciar e solucionar problemas de títulos para PC executados no Microsoft Gaming Runtime.

Este tópico descreve as ferramentas do Microsoft Game Development Kit (GDK) para instalar e iniciar seu título para PC. Ele explica como usar essas ferramentas e fornece informações sobre a solução de problemas de instalação e inicialização no PC.

## Ferramentas para instalar e iniciar seu título no PC

> [!NOTE]
>
> Para obter mais informações sobre a inicialização de apps e a inicialização com o Gaming Runtime, veja [Iniciar um jogo Win32](https://docs.xbox.com/pt-BR/build/core-features/common/game-config/MicrosoftGameConfig-Overview.md#MSGC-PCLaunch).

O Microsoft Game Development Kit (GDK) oferece as seguintes abordagens para instalar seu título.

* [wdapp.exe install](https://docs.xbox.com/pt-BR/tools/tools-pc/commandlinetools/gr-wdapp.md#wdapp_install): usado para instalar um pacote .MSIXVC do seu título. Para obter mais informações sobre como empacotar seu título para PC, veja [Introdução ao empacotamento de títulos para PC usando as ferramentas de empacotamento MSIXVC](https://docs.xbox.com/pt-BR/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC.md). Se quiser habilitar o fluxo completo do [Bootstrapper para PC](https://docs.xbox.com/pt-BR/build/gdk-and-engines/guides/pc-bootstrapper.md) com seu pacote, você pode fazer isso por meio do sinalizador /bootstrapper.

* [wdapp.exe register](https://docs.xbox.com/pt-BR/tools/tools-pc/commandlinetools/gr-wdapp.md#wdapp_register): usado para registrar uma pasta de arquivos soltos para que ela possa ser iniciada. Para obter mais informações, veja [Registro de jogos para PC](https://docs.xbox.com/pt-BR/tools/tools-pc/title-registration-pc.md). A partir do GDK de junho de 2022, você só precisa registrar seu jogo se quiser habilitar os ícones do shell da área de trabalho e do menu Iniciar, como ao testar o cenário de instalação de varejo.

O Microsoft Game Development Kit (GDK) oferece as seguintes abordagens para iniciar seu título:

* Depois de registrar seu título, ele aparece como selecionável no menu Iniciar e pode ser pesquisado na caixa de pesquisa.

* O [wdapp.exe launch](https://docs.xbox.com/pt-BR/tools/tools-pc/commandlinetools/gr-wdapp.md#wdapp_launch) é usado para iniciar um título usando a ID do modelo de usuário do aplicativo (AUMID) ou um caminho para o executável.

* Windows Device Portal (WDP): vá para **Installed Apps** e selecione **Start**.

### Iniciar com o Bootstrapper para PC habilitado

Para iniciar com o fluxo completo do [Bootstrapper para PC](https://docs.xbox.com/pt-BR/build/gdk-and-engines/guides/pc-bootstrapper.md), como um usuário de varejo veria, você deve fazer o sideload de um pacote via wdapp install e usar o sinalizador /bootstrapper. Para builds soltos ou instalações sem o sinalizador, a funcionalidade do Bootstrapper para PC ficará limitada à imposição do modelo de usuário simplificado no momento em que XUserAddAsync for chamado.

### Iniciar com e sem identidade de título

A partir do GDK de junho de 2022, o runtime deve funcionar de forma idêntica, independentemente do método usado para iniciar o título, desde que o [MicrosoftGame.config](https://docs.xbox.com/pt-BR/build/core-features/common/game-config/MicrosoftGameConfig-Overview.md) esteja configurado corretamente.

### Iniciar com argumentos de linha de comando

A partir do GDK de junho de 2022, você pode simplesmente iniciar o executável diretamente, passando quaisquer \[launch args] diretamente.

Além disso, você pode usar um dos seguintes métodos para iniciar seu título com argumentos de linha de comando:

* `WdApp Launch [launch args]` em um prompt de comando do GDK.

* `<ExecutionAlias> [launch args]` em um prompt de comando.

* Argumentos de linha de comando nas propriedades do projeto do Visual Studio.

Para obter mais informações sobre como usar um alias de execução, veja [ExecutionAlias](https://docs.xbox.com/pt-BR/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-executable.md#MicrosoftGameConfig-Alias).

## Solução de problemas de instalação e inicialização no PC

### Código de erro 0x80073CFF: Deployment of package failed because no valid license or sideloading policy could be applied. A developer license or enterprise sideloading configuration may be required.

#### O problema

Você teve um problema ao tentar instalar, registrar ou iniciar seu título.

#### A correção

A correção é habilitar o Modo de Desenvolvedor no seu PC seguindo as etapas abaixo.

1. Abra **Configurações**.

2. Digite *Developer* no campo de pesquisa.

3. Na lista de opções exibida, selecione **Usar recursos de desenvolvedor**.

4. Selecione **Modo de desenvolvedor**. Uma caixa de diálogo é exibida informando que o sistema está adicionando recursos. Aguarde a conclusão desse processo.

### Código de erro 0x80073cfc: The application cannot be started. Try reinstalling the application to fix the problem.

#### O problema

Você teve um problema em uma das etapas iniciais do processo de instalação.

#### A solução alternativa

Você pode desinstalar e reinstalar o Gaming Runtime Services (GRTS). Siga estas etapas para fazer isso.

1. Abra um prompt de comando do PowerShell como administrador.

2. Execute este comando: `get-appxpackage *gamings*`

3. Execute este comando: `remove-package <package fullname from step 2 for the gamingservices package>`

4. Abra o XBOX app e instale um jogo. Isso dispara a instalação do pacote gamingservices pela Microsoft Store.

### Código de erro 0x87e00017: Install source was found but cannot be reached. Likely internet problem.

#### O problema

Esse código de erro corresponde a `IM_E_UNREACHABLE_INSTALL_SOURCE`. Você encontra esse erro se o sistema de implantação não conseguir acessar seus arquivos. No entanto, embora esse possa ser o caso, também pode significar que o diretório de instalação foi corrompido. A causa mais comum disso é uma implantação parcialmente bem-sucedida que não fez a limpeza adequada depois.

#### A correção

Para corrigir esses problemas

1. Execute o app `wdapp list`.

2. Na lista resultante, procure as versões dos jogos que você instalou.

3. Desinstale todos os jogos usando `wdapp uninstall <pfn>`.

4. Tente instalar o jogo novamente.

### Código de erro 0x80080203: The specified package format is not valid: The file is not a valid app package because it is missing a required footprint file.

#### O problema

Isso ocorre porque você tem um "MSIXVC aninhado" (o que pode acontecer facilmente). Digamos que o seu build para desktop seja *C:\MyGame*. Você decide criar um pacote usando o [makepkg.exe](https://docs.xbox.com/pt-BR/build/core-features/common/packaging/deployment/makepkg.md) em uma subpasta de *C:\MyGame* (por exemplo, em *C:\MyGame\Package*). Isso funciona na primeira vez porque nenhum pacote foi gerado, mas você encontra esse problema ao tentar criar um pacote novamente. Além dessa falha (causada pela presença de dois arquivos *AppxManifest.xml* no pacote), executar o *makepkg.exe* em *C:\MyGame* tentaria empacotar o .msixvc existente no novo pacote (a menos que você o tenha excluído do genmap).

#### A correção

Para corrigir esse problema, verifique se o diretório do pacote está fora do diretório que contém o seu *MicrosoftGame.config*.

### Código de erro 0x80070490: Element not found

#### O problema

Esse problema ocorre ao tentar instalar um .XVC (o formato de empacotamento de um pacote XBOX) com `wdapp install`.

#### A solução alternativa

Use `wdapp install` apenas para pacotes .MSIXVC (o formato de empacotamento de um pacote para PC).

### Erros ao iniciar via wdapp quando a pasta do título está compartilhada

#### O problema

Se você compartilhar uma pasta com o Compartilhamento de Arquivos do Windows que já tenha sido registrada com o [wdapp.exe register](https://docs.xbox.com/pt-BR/tools/tools-pc/commandlinetools/gr-wdapp.md#wdapp_register), isso fará com que o Gaming Runtime perca as permissões de compartilhamento, e você encontrará este erro em seguida.

```
    'WdApp.exe launch' must be called with an AUMID to activate an application.

    Use 'WdApp.exe list' to get a list of sideloaded packages including AUMID values.

    Alternatively, if your executable specifies an Alias in the *MicrosoftGame.config*,

    typing the alias name at the command prompt will do an application activation.

    Failed with 0x80070057.
```

#### A solução alternativa

O problema está relacionado à lista de controle de acesso (ACL). Compartilhar a pasta impede o acesso ao modelo de aplicativo. Ou seja, o contêiner perde a permissão de ler arquivos durante o compartilhamento. A solução alternativa é seguir estas etapas para salvar e restaurar os dados da ACL.

1. Antes de compartilhar a pasta, execute 'icacls /save AclFile' para salvar as ACLs da pasta do pacote.

2. Compartilhe a pasta usando o Compartilhamento de Arquivos do Windows.

3. Para restaurar as ACLs anteriores, execute 'icacls /restore AclFile'.

Além dessa solução alternativa, você também pode registrar novamente executando primeiro `wdapp.exe unregister` e depois `wdapp.exe register`. Isso restaura as permissões e mantém o compartilhamento da pasta.

### Código de erro 0x80070005: Access is denied.

#### O problema

Você encontra um erro "0x8007005: Access is Denied" ao executar o comando wdapp install.

#### A correção

Verifique se está passando o caminho completo para o arquivo .msixvc. Por exemplo:

Correto:

*wdapp install "c:\MyGame\GDKBuildFolder\GdkGame\_1.0.0.0\_x64\_\_pmsdash4d.msixvc"*

Incorreto (sem o caminho completo para o .msixvc):

*wdapp install "c:\MyGame\GDKBuildFolder"*

### Código de erro 0x000007b: STATUS\_INVALID\_IMAGE\_FORMAT

#### O problema

Você encontra um erro "0x000007b" ao executar o comando wdapp launch.

#### A correção

O problema é que o executável que está sendo iniciado tem uma arquitetura de plataforma diferente da especificada no MicrosoftGame.config. O elemento DesktopRegistration no MicrosoftGame.config tem um elemento filho opcional chamado ProcessorArchitecture, que pode especificar 'x86' ou 'x64' como valor. Garantir que essa especificação corresponda à arquitetura de plataforma do executável definido no elemento Executable resolverá esse problema.

### Código de erro 0x800701B1: A device which does not exist was specified.

#### O problema

Você encontra um erro "0x800701B1" ao executar o comando wdapp install /drive.

#### A correção

O problema é que a unidade de destino não foi detectada pela Windows Store. Verifique se a unidade de destino está presente na lista suspensa "Novos aplicativos serão salvos em:" em "Configurações -> Configurações de Armazenamento -> Alterar onde o novo conteúdo é salvo" no seu PC local. Se a unidade não estiver presente, verifique a integridade da unidade e se o PC local tem as atualizações mais recentes do Windows.

### Código de erro 0x80072F78: WININET\_E\_INVALID\_SERVER\_RESPONSE

#### O problema

Você encontra um erro "0x80072F78" ao executar o comando wdapp install.

#### A correção

Esse problema foi associado a configurações de proxy de firewall que bloqueiam o endereço "settings-win.data.microsoft.com". Esse endereço é necessário para que as configurações de instalação sejam armazenadas corretamente em cache ao instalar seu título do GDK para PC. Verifique se esse endereço é permitido no software de firewall.

## Veja também

[Introdução ao Microsoft Game Development Kit](https://docs.xbox.com/pt-BR/home/setup-install/get-started.md)

[Introdução ao empacotamento para PC](https://docs.xbox.com/pt-BR/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC.md)

[Bootstrapper para PC](https://docs.xbox.com/pt-BR/build/gdk-and-engines/guides/pc-bootstrapper.md)

[MicrosoftGame.config](https://docs.xbox.com/pt-BR/build/core-features/common/game-config/MicrosoftGameConfig-toc.md)

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

[Registro de jogos para PC](https://docs.xbox.com/pt-BR/tools/tools-pc/title-registration-pc.md)

[Visão geral da instalação de arquivos simples](https://docs.xbox.com/pt-BR/build/core-features/common/packaging/packaging-flatfileinstall.md)

[Ferramentas de linha de comando (para PC)](https://docs.xbox.com/pt-BR/tools/tools-pc/commandlinetools/gr-commandlinetools-toc.md)

[Desenvolvimento de jogos para PC (ambiente e ferramentas)](https://docs.xbox.com/pt-BR/tools/tools-pc/gc-tools-pc-toc.md)


## Related topics

- [Testando pacotes em um PC de desenvolvimento](https://docs.xbox.com/pt-BR/build/core-features/common/packaging/packaging-testing-PC-install.md)
- [Visão geral do Flat File Install](https://docs.xbox.com/pt-BR/build/core-features/common/packaging/packaging-flatfileinstall.md)
- [Introdução ao Unreal Engine para desenvolvimento para PC](https://docs.xbox.com/pt-BR/build/gdk-and-engines/unreal/unreal.md)
- [Ferramentas de desenvolvedor para PC do XBOX GDK](https://docs.xbox.com/pt-BR/tools/tools-pc/index.md)
- [Captura de tela (wdcapture.exe)](https://docs.xbox.com/pt-BR/tools/tools-pc/commandlinetools/gr-wdCapture.md)