Gerenciar pacotes (wdapp.exe) - XBOX Game Development Documentation

Use esta ferramenta para registrar novos locais, alterar estados de gerenciamento do tempo de vida do processo (PLM), remover e manipular configurações de pacotes em dispositivos da Plataforma Universal do Windows (UWP).

Comando	Descrição
registernetworkshare	Registra um aplicativo que está em uma pasta compartilhada na rede
verifynetworkshare	Verifica o acesso de leitura a um compartilhamento de rede
registerscratch	Registra um pacote a partir da unidade de rascunho
registertitlescratch	Registra um pacote a partir da unidade de rascunho do título
launch	Inicia um aplicativo
query	Consulta o estado de execução de um pacote ou aplicativo instalado
terminate	Encerra todos os aplicativos de um pacote especificado
suspend	Simula a suspensão de um aplicativo
register	Registra um aplicativo
unregister	Cancela o registro de um aplicativo
registerdrive	Registra todos os aplicativos de uma unidade
list	Lista os aplicativos
move	Move um aplicativo
copy	Copia um aplicativo
movedrive	Move todos os aplicativos de uma unidade
copydrive	Copia todos os aplicativos de uma unidade
install	Instala um build empacotado
uninstall	Desinstala um aplicativo
applyconfig	Inicia um Game OS com as configurações especificadas
queryconfig	Imprime o número de versão de quatro partes do Game OS em execução
collectxip	Coleta o rastreamento XIP
queryversioninfo	Consulta a versão do Game OS de um pacote especificado
overlayfolder	Gerencia operações de pasta de sobreposição

wdapp registernetworkshare

Registra um aplicativo que está em uma pasta compartilhada na rede. wdapp registernetworkshare <Network Path> [Username] [Password]

Opção	Descrição
`Network Path`	O caminho para o compartilhamento de rede.
`Username`	O nome de usuário para acessar o compartilhamento de rede.
`Password`	A senha para acessar o compartilhamento de rede.
`Verify`	Verifica se os arquivos no local de rede podem ser abertos para confirmar que todos podem ser lidos.

wdapp verifynetworkshare

Verifica o acesso de leitura a uma pasta compartilhada na rede. wdapp verifynetworkshare <Network Path>

Opção	Descrição
`Network Path`	O caminho para o compartilhamento de rede.

wdapp registerscratch

Registra um aplicativo que está na unidade de rascunho. wdapp registerscratch <Relative folder path>

Opção	Descrição
`Relative folder path`	O caminho relativo para o aplicativo.

wdapp registertitlescratch

Registra um aplicativo que está na unidade de rascunho do título. wdapp registertitlescratch <Relative folder path>

Opção	Descrição
`Relative folder path`	O caminho relativo para o aplicativo.

wdapp launch

Inicia o aplicativo fornecido. Se um caminho para um executável for fornecido, o aplicativo será registrado, se necessário, antes da inicialização. wdapp launch [/WaitToExit [:timeoutInSeconds]] <AppUserModelId/AUMID | exe | uri | unregv2>

Opção	Descrição
`AUMID`	A Application User Model ID (AUMID) do aplicativo a ser iniciado.
`exe`	O executável do título.
`uri`	Um URI de um protocolo personalizado registrado ou do protocolo baseado em título que especifica o título a ser iniciado e quaisquer argumentos a serem passados ao título. Por exemplo, se a ID do seu título for 12345abcd, seu produto poderá ser iniciado usando o protocolo baseado em título com o URI ms-xbl-12345abcd://default.
`unregv2:\{InstanceId}\{PackageAlias}\{AUMID}`	O unregv2 permite iniciar um pacote não registrado instalado lado a lado com outros pacotes que compartilham uma ContentID. Use wdapp list /d /u para obter os valores de instanceID e PackageAlias
WaitToExit [:timeoutInSeconds]	Inicia o aplicativo e bloqueia até que o título seja encerrado. Quando o título é encerrado, o xbapp também é encerrado, retornando o código de saída do título. O argumento opcional timeoutInSeconds pode ser usado para forçar a saída. Se o tempo limite for atingido antes que o título seja encerrado, será retornado “The user specified /WaitToExit timeout was exceeded before the game exited.”.

wdapp query

Consulta o estado de execução de um pacote ou aplicativo instalado. wdapp query <pfn>

Opção	Descrição
`pfn`	O nome completo do pacote.

wdapp terminate

Encerra todos os aplicativos que estão em um pacote especificado. wdapp terminate wdapp terminate <pfn>

Opção	Descrição
`pfn`	(Opcional) O nome completo do pacote.

wdapp suspend

Simula a suspensão de todos os aplicativos que estão em um pacote especificado. wdapp suspend wdapp suspend <pfn>

Opção	Descrição
`pfn`	(Opcional) O nome completo do pacote.

wdapp register

Registra o aplicativo especificado que está na unidade especificada. wdapp register <pfn> <drive>

Opção	Descrição
`pfn`	O nome completo do pacote.
`drive`	A unidade na qual o pacote será registrado.
`PackageAlias`	O alias do pacote que você está instalando. Necessário quando você está instalando vários pacotes com a mesma ContentID.

wdapp unregister

Cancela o registro do aplicativo especificado. wdapp unregister <pfn>

Opção	Descrição
`pfn`	O nome completo do pacote.

wdapp registerdrive

Registra todos os aplicativos atualmente não registrados que estão na unidade especificada. wdapp registerdrive <drive>

Opção	Descrição
`drive`	A unidade na qual os pacotes serão registrados.

wdapp list

Lista todos os aplicativos ou especifica vários sinalizadores para controlar quais aplicativos são enumerados. wdapp list [/unregistered] [/system] [/detail] [/drive=<drive>] [/JSON]

Opção	Descrição
`unregistered`	Enumera os aplicativos não registrados.
`system`	Enumera os aplicativos do sistema.
`detail`
`drive`	A unidade na qual os aplicativos serão enumerados.
`JSON`	Imprime somente o blob JSON que contém as informações do pacote

wdapp move

Move um aplicativo para uma unidade diferente. wdapp move <pfn> <destination drive> [new folder name]

Opção	Descrição
`pfn`	O nome completo do pacote.
`destination drive`	A unidade para a qual o aplicativo será movido.
`new folder name`	A pasta para a qual o aplicativo será movido.

wdapp copy

Copia um aplicativo para uma unidade diferente. wdapp copy <pfn> <destination drive> [new folder name]

Opção	Descrição
`pfn`	O nome completo do pacote.
`destination drive`	A unidade para a qual o aplicativo será copiado.
`new folder name`	A pasta para a qual o aplicativo será copiado.

wdapp movedrive

Move todos os aplicativos de uma unidade para uma unidade diferente. wdapp movedrive <source drive> <destination drive>

Opção	Descrição
`source drive`	A unidade da qual os aplicativos serão movidos.
`destination drive`	A unidade para a qual os aplicativos serão movidos.

wdapp copydrive

Copia todos os aplicativos de uma unidade para uma unidade diferente. wdapp copydrive <source drive> <destination drive>

Opção	Descrição
`source drive`	A unidade da qual os aplicativos serão copiados.
`destination drive`	A unidade para a qual os aplicativos serão copiados.

wdapp install

Transmite um build empacotado para o console a partir de um servidor web, um compartilhamento de rede ou um caminho de arquivo do sistema local.

wdapp install <package filepath> [/oddsim] [/drive=<drive>] [/<languages|devices|contenttypes|tags>=<semi-colon delimited specifier list>] [/PackageAlias:<alias>]

Opção	Descrição
`package filepath`
`oddsim`
`drive`
`tags`
`PackageAlias`	Use o PackageAlias para habilitar a instalação lado a lado de pacotes com a mesma ContentID. O alias é o local físico do pacote. Esse valor de alias deve ser globalmente exclusivo apenas para essa instância desse pacote.

wdapp uninstall

Desinstala o aplicativo especificado. Use o PackageAlias e o InstanceID opcionais (use wdapp list /d) para desinstalar um pacote instalado que não está registrado no momento. wdapp uninstall <pfn>

Opção	Descrição
`pfn`	O nome completo do pacote do aplicativo. Por padrão, isso desinstalará o título registrado no momento

wdapp applyconfig

Inicia um Game OS especificado, inicia o Game OS especificado por um arquivo game.config ou inicia o Game OS usado mais recentemente com as configurações padrão. wdapp applyconfig [game.config | gameos.xvd]

Opção	Descrição
`game.config`	Um arquivo game.config usado para especificar o Game OS a ser iniciado.
`gameos.xvd`	O Game OS a ser iniciado.

wdapp installkey

Instala o EKB de console (CEKB) especificado no console a partir de um compartilhamento de rede ou de um caminho de arquivo do sistema local. wdapp installkey [ekb filepath]

Opção	Descrição
`ekb filepath`	Arquivo EKB gerado quando o makepkg.exe foi executado no título.

wdapp queryconfig

Imprime o número de versão de quatro partes do Game OS em execução. Se nenhum Game OS estiver em execução, será retornado um erro. wdapp queryconfig

wdapp collectxip

Se um ERA do XBOX One estiver em execução, coleta o rastreamento XIP e disponibiliza o rastreamento atual no compartilhamento de arquivos do desenvolvedor como <output name> ou <guid>.pfm. wdapp collectxip ["Output file name"]

Opção	Descrição
`output name`	O nome de saída do rastreamento XIP.

wdapp queryversioninfo

Consulta a versão do Game OS associada ao pacote especificado. Também tenta ver se o sistema operacional corresponde a alguma informação carimbada no executável do jogo. Especifique /b para imprimir somente a versão do Game OS sem nenhuma outra saída. Você só pode consultar um pacote registrado; se tiver vários pacotes instalados com a mesma ContentID, precisará registrar o pacote antes de consultar suas informações de versão. wdapp queryversioninfo <pfn> [/b]

Opção	Descrição
`pfn`	O nome completo do pacote a ser consultado.
`/b`	Imprime somente a versão do Game OS sem nenhuma outra saída.

wdapp overlayfolder

Define ou limpa uma pasta de sobreposição para um nome completo de pacote especificado, ou use /R para limpar todas as pastas de sobreposição. wdapp overlayfolder [/R | <pfn> [/r | <overlay folder path>]]

Opção	Descrição
`/R`	Limpa todas as pastas de sobreposição.
`pfn`	O nome completo do pacote para o qual a pasta de sobreposição será definida ou limpa.
`/r`	Limpa a pasta de sobreposição especificada.
`path`	O caminho para a pasta de sobreposição a ser definida.

xbapp lastgamedetails

Recupera alguns detalhes sobre o último jogo executado, incluindo o nome, a versão do sistema operacional e o código de saída

Coluna 1
xbapp lastgamedetails [/X[:]address[+`<accesskey>`]]

Opção	Descrição
`/X[:]*address[<accesskey>]`	- Use esta opção para especificar o nome do host ou o endereço (mostrado como Tools IP no console) de um console de destino sem alterar o console padrão. Para obter detalhes sobre como definir um nome de host para um console, veja Definir um nome de host para o endereço IP do console. - Se você não usar esta opção, será usado o console padrão (definido anteriormente por Conexão (xbconnect.exe)). - Use a string accesskey para fornecer acesso ao console somente às pessoas que têm a chave de acesso. - Defina a chave de acesso usando o comando xbconfig accesskey=your-key e, em seguida, reinicie o console para que a chave de acesso entre em vigor. - Para acessar um console configurado com uma chave de acesso, inclua um sinal de adição (+) e a chave de acesso após o endereço IP ou o nome do host do console. - Se uma chave de acesso for fornecida quando o console padrão for definido por xbconnect, a chave de acesso será armazenada como parte do endereço do console padrão. - Para obter mais informações sobre chaves de acesso, veja Configuração (xbconfig.exe).

Veja também

Ferramentas de linha de comando do console Erros de transporte do XTF

​wdapp registernetworkshare

​wdapp verifynetworkshare

​wdapp registerscratch

​wdapp registertitlescratch

​wdapp launch

​wdapp query

​wdapp terminate

​wdapp suspend

​wdapp register

​wdapp unregister

​wdapp registerdrive

​wdapp list

​wdapp move

​wdapp copy

​wdapp movedrive

​wdapp copydrive

​wdapp install

​wdapp uninstall

​wdapp applyconfig

​wdapp installkey

​wdapp queryconfig

​wdapp collectxip

​wdapp queryversioninfo

​wdapp overlayfolder

​xbapp lastgamedetails

​Veja também