Como usar o Microsoft Store Web Installer para distribuir seus aplicativos na Web

Microsoft Store Web Installer – Introdução e fluxo do usuário

O Microsoft Store Web Installer é um instalador autônomo para aplicativos da Store. Ele ajuda você a baixar e instalar aplicativos de sites como apps.microsoft.com e o selo da Microsoft Store nos sites dos desenvolvedores.

Esse sistema cria um instalador baseado em stub .exepara seu aplicativo, gerado com segurança pelo serviço online da Microsoft Store. Você baixa esse instalador localmente quando seleciona o botão de destino em uma página da Web. É leve, contendo apenas as informações mais básicas necessárias em vez do binário de aplicativo completo.

Exemplo de captura de tela do download de um aplicativo da Microsoft Store e onde abrir o arquivo.

Quando você ativa esse arquivo, o instalador verifica os pré-requisitos (como arquitetura do sistema, idade do usuário e disponibilidade no mercado do usuário) e inicia a instalação do produto usando a mesma API que o aplicativo store. O instalador também rastreia todas as IDs de campanha fornecidas pela origem. Se o aplicativo não atender aos pré-requisitos, o instalador iniciará o aplicativo store para que os usuários possam exibir informações adicionais.

Exemplo de captura de tela de um aplicativo da Microsoft Store instalado localmente.

Depois que a instalação for concluída, o instalador iniciará automaticamente o aplicativo e fechará.

Disponibilidade de funcionalidades

Essa funcionalidade está disponível para os seguintes tipos de conteúdo hospedados na Web:

  • Conteúdo msix empacotado gratuito publicado na Microsoft Store
  • Aplicativos Win32 publicados na Microsoft Store

No momento, essa funcionalidade não está disponível para os seguintes tipos de conteúdo:

  • Aplicativos MSIXVC publicados na Microsoft Store
  • Conteúdo pago publicado na Microsoft Store
  • Conteúdo classificado acima de Todos/ESRB (ou equivalente) ao entrar no Windows usando uma conta escolar

Habilitar esse recurso para seu aplicativo

Para habilitar o Instalador Web da Loja para seu aplicativo, defina os seguintes parâmetros na URL de chamada:

  • No apps.microsoft.com: você não precisa fazer alterações para habilitar o Instalador Web da Loja para seu aplicativo, desde que o aplicativo seja coberto na seção disponibilidade de recursos e você não substitua esse recurso usando o parâmetro mode=full URL.

    • O Instalador Web da Loja é o instalador padrão no apps.microsoft.com. O parâmetro de modo permite que você abra a página de detalhes do produto (PDP) da Loja para esse usuário.

  • No seu site: siga estas etapas para alternar para o instalador da Web no selo do seu site:

    1. Vá para apps.microsoft.com/badge.
    2. Insira os dados certos para seu aplicativo.
    3. Defina o modo de inicialização como Direto para garantir que o código necessário seja gerado para seu aplicativo.
    4. Copie o código e insira o novo selo em seu site.

Notas importantes para administradores corporativos

  • Se você usar a política do MDM ApplicationManagement/RequirePrivateStoreOnly, a política de grupo de aplicativos Exibir apenas a loja privada dentro da Microsoft Store, ou definir o valor DWORD RemoveWindowsStore no registro como 1 para impedir que dispositivos locais ou ingressados no domínio acessem a Microsoft Store, lembre-se de que essas configurações são para desabilitar o aplicativo da Store. Essa política não bloqueia a instalação nem as atualizações de aplicativos disponíveis na Loja.
  • Para controlar melhor os tipos de aplicativos que os computadores ingressados no domínio podem instalar, incluindo aplicativos da Loja e do Microsoft Store Web Installer, visite AppLocker – Segurança do Windows. Use essa política em combinação com RequirePrivateStoreOnly e RemoveWindowsStore ou use-a de forma independente.
  • Para bloquear especificamente instalações a partir do Microsoft Store Web Installer, você pode bloquear o acesso ao seguinte domínio - get.microsoft.com. Essa ação impede que o instalador seja baixado e executado no site da Microsoft Store ou em vários sites de desenvolvedores distribuindo aplicativos por meio desse mecanismo. Bloquear essa URL não afeta o aplicativo da Microsoft Store no Windows ou aplicativos já instalados. Esses aplicativos continuam operando, a menos que você combine essa ação com as políticas acima.

Perguntas frequentes

  1. Qual é o Microsoft Store Web Installer e como posso implementá-lo?

    O Microsoft Store Web Installer é um pequeno instalador executável (.exe) que permite que os usuários instalem aplicativos diretamente da Web sem abrir o aplicativo da Microsoft Store. Quando os usuários clicam em um link de instalação em uma página da Web, o instalador verifica a qualificação do sistema e baixa e instala o aplicativo diretamente no back-end da Store. Isso simplifica o processo de instalação para aplicativos gratuitos distribuídos por meio de sites.

    Implemente o Web Installer inserindo um selo da Microsoft Store com instalação direta em seu site:

    Os usuários que clicarem no seu selo baixarão e iniciarão automaticamente o instalador do aplicativo sem precisar abrir o aplicativo da Loja.

  2. Como faço para vincular ao meu aplicativo no Microsoft Store?

    Você pode tornar seu aplicativo facilmente detectável fornecendo links diretos para a listagem do aplicativo na Microsoft Store. Veja como obter e usar estes links:

    • Obtendo a URL direta para a listagem da Loja:
      Navegue até a página identidade do produto do aplicativo na seção Gerenciamento de produtos no Partner Center. Você encontrará uma URL estruturada como: https://apps.microsoft.com/store/detail/<your app's Store ID>

    Os clientes que clicam neste link são levados para a listagem da Loja baseada na Web, onde podem baixar e instalar seu aplicativo por meio da Microsoft Store.

    • Usando o selo da Microsoft Store:
      Você pode criar um selo da Microsoft Store com a marca que se vincula diretamente ao seu aplicativo. Para gerar seu selo personalizado:
    1. Vá para a página do criador de selos da Microsoft Store .
    2. Forneça o ID de Loja de 12 caracteres do aplicativo (encontrado no Centro de Parceiros na seção Identidade do Produto).

    O selo é um componente da Web que detecta automaticamente o idioma e o tema do usuário. Ele não herdará estilos CSS de sua página, mas você pode personalizar seu tamanho usando um seletor de partes CSS:

    /* Adjust the badge size to match other buttons on your page. */
ms-store-badge::part(img) {
    max-width: 200px;
}

    Esse selo indica claramente que seu aplicativo está disponível na Microsoft Store e pode ajudar a aumentar a confiança e os downloads do cliente.

    • Link do Aplicativo da Loja Direta usando o esquema de URI:
      Se você quiser abrir diretamente o aplicativo da Microsoft Store (sem iniciar um navegador primeiro), use o seguinte esquema de URI: ms-windows-store://pdp/?ProductId=<your app's Store ID>

    Essa abordagem é particularmente útil quando você sabe que seus usuários já estão em um dispositivo Windows ou ao direcionar usuários de dentro de um aplicativo WinUI.

  • Last updated on