Requisitos do pacote de aplicativos para o aplicativo MSIX

Requisitos

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.

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.

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.

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.

Requisitos de formato do pacote

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

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.

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.

Numeração de versão do pacote

Cada pacote fornecido deve ter um número de versão (fornecido como um valor no atributo Version do elemento Pacote/Identidade do manifesto do aplicativo). A Microsoft Store impõe certas regras relacionadas a números de versão, que funcionam de forma um pouco diferente em diferentes versões do sistema operacional.

Numeração de versão para pacotes do Windows 10 e 11

Ao escolher um pacote UWP do envio publicado, a Microsoft Store sempre usará o pacote com a versão mais alta aplicável ao dispositivo Windows 10 ou Windows 11 do cliente. Isso oferece maior flexibilidade e o coloca no controle sobre quais pacotes serão fornecidos aos clientes em tipos de dispositivos específicos. É importante ressaltar que você pode enviar esses pacotes em qualquer ordem. Você não está limitado a fornecer pacotes com versões mais altas a cada envio posterior.

Você pode fornecer vários pacotes UWP com o mesmo número de versão. No entanto, os pacotes que compartilham um número de versão também não podem ter a mesma arquitetura, porque a identidade completa que a Store usa para cada um dos pacotes deve ser exclusiva. Para obter mais informações, consulte Identidade.

Quando você fornece vários pacotes UWP que usam o mesmo número de versão, a arquitetura (na ordem x64, x86, Arm, neutral) será usada para decidir qual deles é de classificação mais alta (quando a Store determina qual pacote fornecer ao dispositivo de um cliente). Ao classificar pacotes de aplicativos que usam o mesmo número de versão, a classificação de arquitetura mais alta dentro do pacote é considerada: um pacote de aplicativos que contém um pacote x64 terá uma classificação mais alta do que um que contém apenas um pacote x86.

Isso lhe dá muita flexibilidade para evoluir seu aplicativo ao longo do tempo. Você pode carregar e enviar novos pacotes que usam números de versão mais baixos para adicionar suporte a dispositivos Windows 10 ou Windows 11 para os quais você não fornecia suporte anteriormente, pode adicionar pacotes com versões mais altas que têm dependências mais rígidas para aproveitar os recursos de hardware ou sistema operacional ou pode adicionar pacotes com versões mais altas que servem como atualizações para parte ou toda a sua base de clientes existentes.

O exemplo a seguir ilustra como a numeração de versão pode ser gerenciada para entregar os pacotes pretendidos aos seus clientes por meio de vários envios.

Exemplo: Mudando para um único pacote em vários envios

O Windows 10 permite que você escreva uma única base de código que é executada em todos os lugares. Isso torna o início de um novo projeto multiplataforma muito mais fácil. No entanto, por vários motivos, talvez você não queira mesclar bases de código existentes para criar um único projeto imediatamente.

Você pode usar as regras de controle de versão de pacotes para mudar gradualmente seus clientes para um único pacote da família de dispositivos Universal, enquanto envia várias atualizações provisórias para famílias de dispositivos específicas (incluindo aquelas que aproveitam as APIs do Windows 10). O exemplo abaixo ilustra como as mesmas regras são aplicadas consistentemente em uma série de envios para o mesmo aplicativo.

Usar a numeração de versão para reverter para um pacote enviado anteriormente para novas aquisições

Se você mantiver cópias de seus pacotes, terá a opção de reverter o pacote do seu aplicativo na Store para um pacote anterior do Windows 10, se descobrir problemas com uma versão. Essa é uma maneira temporária de limitar a interrupção para seus clientes, enquanto você corrige o problema.

Para fazer isso, crie um novo envio. Remova o pacote problemático e carregue o pacote antigo que você deseja fornecer na Store. Os clientes que já receberam o pacote que você está revertendo ainda terão o pacote problemático (já que seu pacote mais antigo terá um número de versão anterior). Mas isso impedirá que qualquer outra pessoa adquira o pacote problemático, permitindo que o aplicativo ainda esteja disponível na Store.

Para corrigir o problema para os clientes que já receberam o pacote problemático, você pode enviar um novo pacote do Windows 10 que tenha um número de versão maior do que o pacote incorreto, assim que puder. Após esse envio passar pelo processo de certificação, todos os clientes serão atualizados para o novo pacote, já que ele terá um número de versão maior.

Idiomas com suporte

Você pode enviar aplicativos para a Microsoft Store em mais de 100 idiomas.

Para saber mais sobre como configurar idiomas em seus aplicativos, consulte Globalização e localização e Compreender os idiomas do perfil do usuário e os idiomas do manifesto do aplicativo. Também temos um kit de ferramentas de aplicativo multilíngue para ajudá-lo a escrever aplicativos compatíveis com vários idiomas.

Lista de idiomas com suporte

Estes são os idiomas suportados pela Microsoft Store. Seu aplicativo deve ser compatível com pelo menos um desses idiomas.

Os códigos de idioma que não estão incluídos aqui não são suportados pela Store. Recomendamos que você não inclua pacotes direcionados a códigos de idioma diferentes dos listados abaixo. Esses pacotes não serão distribuídos aos clientes e podem causar atrasos ou falhas na certificação.