Compartilhar via


DeploymentOptions Enumeração

Definição

Especifica as opções de implantação do pacote.

Essa enumeração dá suporte a uma combinação bit a bit dos valores de membro.

public enum class DeploymentOptions
/// [System.Flags]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class DeploymentOptions
[System.Flags]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum DeploymentOptions
var value = Windows.Management.Deployment.DeploymentOptions.none
Public Enum DeploymentOptions
Herança
DeploymentOptions
Atributos

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Campos

DevelopmentMode 2

Quando você define essa opção, o aplicativo é instalado no modo de desenvolvimento. Para obter informações sobre o modo de desenvolvimento, consulte Comentários. Use essa opção para habilitar os principais cenários de desenvolvimento de aplicativos. Você não pode usar essa opção em conjunto com um pacote de pacote. Se você usar essa opção com um pacote de pacotes, sua chamada retornará ERROR_INSTALL_FAILED.

ForceApplicationShutdown 1

Se esse pacote, ou qualquer pacote que dependa desse pacote, estiver em uso no momento, os processos associados ao pacote serão desligados à força para que o registro possa continuar.

ForceTargetApplicationShutdown 64

Se esse pacote estiver em uso no momento, os processos associados ao pacote serão desligados à força para que o registro possa continuar.

ForceUpdateFromAnyVersion 262144

Force uma versão específica de um pacote a ser preparada/registrada, independentemente de uma versão superior já estar preparada/registrada.

InstallAllResources 32

Quando você define essa opção, o aplicativo é instruído a ignorar as verificações de aplicabilidade de recursos. Isso efetivamente prepara ou registra todos os pacotes de recursos que um usuário passa para o comando, o que força a aplicabilidade de todos os pacotes contidos em um pacote. Se um usuário passar em um pacote, todos os pacotes de recursos contidos serão registrados. Somente Windows.

None 0

O comportamento padrão é usado.

RequiredContentGroupOnly 256

Quando você definir essa opção, somente o grupo de conteúdo necessário será preparado. Um aplicativo pode ser instalado como um pacote apenas com o grupo de conteúdo necessário.

RetainFilesOnFailure 2097152

No caso de uma implantação com falha, não remova os arquivos que foram criados no computador de destino durante o processo de instalação.

StageInPlace 4194304

Quando você definir essa opção, o pacote será preparado no local. Esse campo é útil para notificar o sistema para se preparar para o registro de aplicativos em cenários de área de trabalho virtual.

Comentários

Você pode usar a opção DevelopmentMode para instalar aplicativos sem exigir um pacote de aplicativo. Em vez disso, o mecanismo de implantação processa o arquivo AppxManifest.xml diretamente, o que permite um ciclo de desenvolvimento mais rápido. Os arquivos BlockMap.xml, [Content_Types].xml e assinatura digital não são necessários para a instalação do aplicativo no DevelopmentMode.

Para instalar com êxito um aplicativo no DevelopmentMode, ele deve atender a essas condições adicionais além do que normalmente é necessário para aplicativos UWP:

  • O aplicativo deve ser exclusivo para a conta de usuário atual. Nenhum outro usuário pode ter um aplicativo com o mesmo nome de família de pacotes instalado no computador.
  • Se uma versão anterior do aplicativo tiver sido instalada, a versão anterior também deverá ser instalada no DevelopmentMode. Os aplicativos UWP não podem ser atualizados com um aplicativo DevelopmentMode e vice-versa.
  • O aplicativo deve estar em uma partição do Microsoft Windows NT File System (NTFS). Não há suporte para partições com outros formatos.
  • O aplicativo deve estar em uma unidade local. A instalação de locais de rede não tem suporte.
  • O aplicativo deve estar em um local não criptografado. A instalação de diretórios criptografados não tem suporte.
  • O aplicativo não pode ser instalado no diretório WindowsApps. Se qualquer uma das condições anteriores não for atendida, a instalação falhará.

Além disso, para simplificar e aprimorar a experiência de desenvolvimento de aplicativos, esses principais comportamentos do sistema operacional são modificados quando um aplicativo é instalado no DevelopmentMode:

  • Os arquivos de conteúdo do aplicativo podem ser modificados. Se você modificar um arquivo de conteúdo do aplicativo, as alterações serão refletidas na próxima vez que o aplicativo for iniciado. Você não precisa reinstalar o aplicativo, a menos que modifique o arquivo AppxManifest.xml.
  • A geração de bytecode e o NGEN estão desabilitados. A geração de bytes JS e o NGEN binário do .NET estão desabilitados em pacotes DevelopmentMode para permitir que você modifique arquivos de conteúdo sem reinstalar seu aplicativo.
  • Os arquivos de conteúdo do aplicativo não são removidos quando o aplicativo é desinstalado. Como esses arquivos são potencialmente seu código-fonte, o Windows não exclui esses arquivos quando um aplicativo é desinstalado.
  • O loopback de rede é permitido. Você deve aceitar o loopback de rede, conforme descrito em Como habilitar o loopback e solucionar problemas de isolamento de rede.
  • O aplicativo pode ser iniciado no DesignMode. Para obter informações sobre a classe DesignMode, consulte Classe DesignMode.

Histórico de versão

Versão do Windows Versão do SDK Valor adicionado
1703 15063 RequiredContentGroupOnly
1809 17763 ForceUpdateFromAnyVersion
1903 18362 RetainFilesOnFailure
2004 19041 StageInPlace

Aplica-se a

Confira também