Requisitos do pacote do aplicativo

  • Artigo

Siga estas diretrizes para preparar os pacotes do seu aplicativo para envio à Microsoft Store.

Antes de criar o pacote do seu aplicativo para a Microsoft Store

Certifique-se de de testar seu aplicativo com o kit de certificação de aplicativos do Windows. Também recomendamos que você teste seu aplicativo em diferentes tipos de hardware. Observe que, até certificarmos seu aplicativo e disponibilizá-lo na Microsoft Store, ele só poderá ser instalado e executado em computadores que tenham licenças de desenvolvedor.

Compilando o pacote do aplicativo usando o Microsoft Visual Studio

Se você estiver usando o Microsoft Visual Studio como seu ambiente de desenvolvimento, já tem ferramentas internas que tornam a criação de um pacote de aplicativo um processo rápido e fácil. Para obter mais informações, confira Pacote de aplicativos.

Observação

Certifique-se de que todos os seus nomes de arquivos usem ANSI.

Ao criar seu pacote no Visual Studio, verifique se você está conectado com a mesma conta associada à sua conta de desenvolvedor. Algumas partes do manifesto do pacote têm detalhes específicos relacionados à sua conta. Essas informações são detectadas e adicionadas automaticamente. Sem as informações adicionais incluídas no manifesto, você pode encontrar falhas de carregamento de pacote.

Quando você cria os pacotes UWP do seu aplicativo, o Visual Studio pode criar um arquivo .msix ou appx ou um arquivo .msixupload ou .appxupload. Para aplicativos UWP, recomendamos que você sempre carregue o arquivo .msixupload ou .appxupload na página Pacotes . Para obter mais informações sobre como colocar aplicativos UWP em pacotes para a Store, consulte Colocar um aplicativo UWP no pacote com o Visual Studio.

Os pacotes do seu aplicativo não precisam ser assinados com um certificado enraizado em uma autoridade de certificação confiável.

Pacotes de aplicativos

Para aplicativos UWP, o Visual Studio pode gerar um pacote de aplicativos (.msixbundle ou .appxbundle) para reduzir o tamanho do aplicativo a ser baixado pelos usuários. Isso pode ser útil se você tiver definido ativos específicos de idioma, uma variedade de ativos de escala de imagem ou recursos que se aplicam a versões específicas do Microsoft DirectX.

Observação

 Um pacote de aplicativos pode conter seus pacotes para todas as arquiteturas.

Com um pacote de aplicativos, um usuário baixará apenas os arquivos relevantes, em vez de todos os recursos possíveis. Para obter mais informações sobre pacotes de aplicativos, consulte Colocar aplicativos em pacotes e Colocar um aplicativo UWP no pacote com o Visual Studio.

Compilar o pacote do aplicativo manualmente

Se não usar o Visual Studio para criar seu pacote, você deve criar o manifesto do pacote manualmente.

Certifique-se de revisar a documentação do manifesto do pacote do aplicativo para obter os detalhes e requisitos completos to manifesto. Seu manifesto deve seguir o esquema de manifesto do pacote para passar na certificação.

Seu manifesto deve incluir algumas informações específicas sobre sua conta e seu aplicativo. Você pode encontrar essas informações consultando Ver detalhes da identidade do aplicativo na seção Gerenciamento do produto da página de visão geral do seu aplicativo no painel.

Observação

 Os valores no manifesto diferenciam maiúsculas de minúsculas. Espaços e outras pontuações também devem corresponder. Insira os valores cuidadosamente e revise-os para garantir que estejam corretos.

Os pacotes de aplicativos (.msixbundle ou .appxbundle) usam um manifesto diferente. Revise a documentação do Manifesto do pacote para obter os detalhes e os requisitos para manifestos do pacote de aplicativos. Observe que em um .msixbundle ou .appxbundle, o manifesto de cada pacote incluído deve usar os mesmos elementos e atributos, exceto para o atributo ProcessorArchitecture do do elemento Identity.

Dica

 Certifique-se de executar o kit de certificação de aplicativos do Windows, antes de enviar seus pacotes. Isso pode ajudar a determinar se o manifesto tem algum problema que possa causar falhas de certificação ou de envio.

Requisitos de formato do pacote

Os pacotes do seu aplicativo devem estar em conformidade com esses requisitos.

Propriedade do pacote do aplicativo Requisito
Tamanho do pacote .msixbundle ou .appxbundle: máximo de 25 GB por pacote
Pacotes .msix ou .appx destinados ao Windows 10 ou Windows 11: máximo de 25 GB por pacote
Bloquear hashes de mapa Algoritmo SHA2-256

Importante

Você não pode mais carregar novos pacotes XAP criados usando os SDKs do Windows Phone 8.x. Os aplicativos com pacotes XAP que já estão na Store continuarão funcionando em dispositivos móveis Windows 10. Para obter mais informações, confira essa postagem de blog.

Versões suportadas

Para aplicativos UWP, todos os pacotes devem ter como destino uma versão do Windows 10 ou do Windows 11 suportada pela Store. As versões suportadas pelo pacote devem ser indicadas nos atributos MinVersion e MaxVersionTested do elemento TargetDeviceFamily do manifesto do aplicativo.

As versões atualmente suportadas variam de:

  • Mínimo: 10.0.10240.0
  • Máximo: 10.0.22621.0

Arquivo XML StoreManifest

StoreManifest.xml é um arquivo de configuração opcional que pode ser incluído em pacotes de aplicativos. Seu objetivo é habilitar recursos, como declarar seu aplicativo como um aplicativo de dispositivo da Microsoft Store ou declarar requisitos dos quais um pacote depende para serem aplicáveis a um dispositivo, que o manifesto do pacote não cobre. Se usado, o StoreManifest.xml é enviado com o pacote do aplicativo e deve estar na pasta raiz do projeto principal do aplicativo. Para obter mais informações, consulte Esquema StoreManifest.

Envie um URL de download habilitado para HTTPS (link direto) para os binários do instalador do produto. Os produtos enviados dessa maneira estão sujeitos aos seguintes requisitos:

  • O binário do instalador pode ser apenas um .msi ou .exe.

  • O binário e todos os seus arquivos PE devem ser assinados digitalmente com um certificado de assinatura de código que se conecta a um certificado emitido por uma AC (Autoridade de Certificação) que faz parte do Programa Raiz Confiável da Microsoft.

  • Você deve enviar uma URL de download com versão no Partner Center. O binário associado a essa URL não deve ser alterado após o envio.

  • Para distribuir binários atualizados, você deverá fornecer uma URL de download com versão atualizada no Partner Center associada ao binário atualizado. Você é responsável por manter e atualizar a URL de download.

  • Iniciar a instalação não deve exibir uma interface do usuário de instalação (ou seja, a instalação silenciosa é necessária), no entanto, uma caixa de diálogo de Controle de Conta de Usuário (UAC) é permitida.

  • O instalador é autônomo e não é um instalador da Web/uma ferramenta de download de fragmentos que baixa fragmentos quando executado.

Importante

Os requisitos de pacote do aplicativo não são compatíveis com complementos de aplicativos.