Ferramentas para instalar e iniciar seu título no PC
Para obter mais informações sobre a inicialização de apps e a inicialização com o Gaming Runtime, veja Iniciar um jogo Win32.
- wdapp.exe 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. Se quiser habilitar o fluxo completo do Bootstrapper para PC com seu pacote, você pode fazer isso por meio do sinalizador /bootstrapper.
- wdapp.exe 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. 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.
- 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 é 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, 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 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.
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.- Abra Configurações.
- Digite Developer no campo de pesquisa.
- Na lista de opções exibida, selecione Usar recursos de desenvolvedor.
- 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.- Abra um prompt de comando do PowerShell como administrador.
-
Execute este comando:
get-appxpackage *gamings* -
Execute este comando:
remove-package <package fullname from step 2 for the gamingservices package> - 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 aIM_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-
Execute o app
wdapp list. - Na lista resultante, procure as versões dos jogos que você instalou.
-
Desinstale todos os jogos usando
wdapp uninstall <pfn>. - 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 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) comwdapp install.
A solução alternativa
Usewdapp 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, isso fará com que o Gaming Runtime perca as permissões de compartilhamento, e você encontrará este erro em seguida.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.- Antes de compartilhar a pasta, execute ‘icacls /save AclFile’ para salvar as ACLs da pasta do pacote.
- Compartilhe a pasta usando o Compartilhamento de Arquivos do Windows.
- Para restaurar as ACLs anteriores, execute ‘icacls /restore AclFile’.
wdapp.exe unregister e depois wdapp.exe register. Isso restaura as permissões e mantém o compartilhamento da pasta.