Criar um pacote MSIX com o MSIX Core com base no código-fonte

O MSIX Core traz a implantação do MSIX para selecionar versões anteriores do Windows. Você pode aproveitar o instalador do MSIX Core para criar um aplicativo usando ClickOnce. Isso permitirá que os usuários baixem um setup.exe e instalem o aplicativo MSIX por meio do instalador do MSIX Core.

Hospedar seu aplicativo em um servidor Web

Para preparar seu aplicativo para inicialização com o instalador do MSIX Core, você precisará hospedar seu pacote de aplicativos em um servidor Web. Esta seção fornece detalhes sobre como configurar um aplicativo Web no Azure, Serviços de Informações da Internet (IIS)e Amazon Web Services (AWS).

Azure

Para usar essa opção, você deve ter uma assinatura do Azure. Para obter um, consulte a página da conta do Azure.

Criar um aplicativo Web do Azure

Para começar, acesse a página portal do Azure e siga estas etapas:

  1. Clique em Criar um Recurso.
  2. Clique em Web e selecione Aplicativo Web.
  3. Em Detalhes da Instância, crie um nome de aplicativo exclusivo e selecione as configurações apropriadas para seu aplicativo. Por exemplo, você precisará escolher entre Código ou Contêiner do Docker e a Pilha de Runtime. Caso contrário, deixe todo o resto como padrão.
  4. Clique em Criar e concluir o assistente.

Hospedar o pacote do aplicativo e a página da Web

  1. Depois de criar o aplicativo Web, selecione o aplicativo.
  2. Em Ferramentas de Desenvolvimento, clique em Editor do Serviço de Aplicativo.
  3. No editor, há um arquivo de hostingstart.html padrão. Clique com o botão direito do mouse no espaço vazio do Explorador de Arquivos e selecione Upload arquivos para começar a carregar seus pacotes de aplicativos.
  4. Clique com o botão direito do mouse no espaço vazio do painel Explorador de Arquivos novamente e selecione Novos Arquivos para criar um novo arquivo. Nomeia o arquivo como você deseja que sua página HTML padrão seja.

Configurar o aplicativo Web para tipos MIME do pacote de aplicativos

Adicione um novo arquivo chamado Web.config ao aplicativo Web. Abra o Web.config arquivo e adicione o XML a seguir ao arquivo.

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <system.webServer>
    <!--This is to allow the web server to serve resources with the appropriate file extensions-->
    <staticContent>
      <mimeMap fileExtension=".appx" mimeType="application/appx" />
      <mimeMap fileExtension=".msix" mimeType="application/msix" />
    </staticContent>
  </system.webServer>
</configuration>

Serviços de Informações da Internet (IIS)

O IIS é um recurso Windows opcional. Para instalar o IIS:

  1. Clique em Iniciar e pesquise Windows recursos de Windows ativar ou desativar.
  2. Selecione Serviços de Informações da Internet.
  3. Além disso, instale o ASP.NET 4.5 ou superior. Na caixa Windows Recursos do Windows, expanda Serviços de Informações da Internet ->World Wide Web Services ->Application Development Features e selecione uma versão do ASP.NET que seja maior ou igual a ASP.NET 4.5.
  4. Clique em OK para iniciar a instalação.

Visual Studio 2017 (ou uma versão posterior) e ferramentas de desenvolvimento para a Web são necessárias. Se você já tiver Visual Studio 2017 ou uma versão posterior instalada, certifique-se de ter as cargas de trabalho de ASP.NET e desenvolvimento web instaladas. Caso contrário, instale Visual Studio aqui.

Compilar um aplicativo Web

Comece Visual Studio como administrador e crie um novo projeto de Aplicativo Web do Visual C# com um modelo de projeto vazio.

Configurar o IIS com seu aplicativo Web

  1. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto raiz e selecione Propriedades.
  2. Em propriedades, selecione a guia Web .
  3. Na seção Servidores , escolha IIS Local no menu suspenso e clique em Criar Diretório Virtual.

Adicionar o pacote do aplicativo ao aplicativo Web

Adicione o pacote do aplicativo que você deseja distribuir ao aplicativo Web:

  1. No Gerenciador de Soluções, clique com o botão direito do mouse no nó do projeto.
  2. Selecione Adicionar ->Nova Pasta e nomeia os pacotes de pastas.
  3. Para adicionar pacotes de aplicativos à pasta, clique com o botão direito do mouse na pasta pacotes e selecione Adicionar ->Item Existente. Navegue até o local do pacote do aplicativo.

Criar uma página da Web

Crie uma página HTML ou qualquer outro aplicativo Web conforme necessário de acordo com suas necessidades. Adicione o link da nova setup.exe.

Configurar o aplicativo Web para tipos MIME do pacote de aplicativos

Abra o Web.config do gerenciador de soluções e adicione o XML a seguir no elemento <de configuração> .

<system.webServer>
  <!--This is to allow the web server to serve resources with the appropriate file extensions-->
  <staticContent>
    <mimeMap fileExtension=".appx" mimeType="application/appx" />
    <mimeMap fileExtension=".msix" mimeType="application/msix" />
  </staticContent>
</system.webServer>

AWS (Amazon Web Services)

Para usar essa opção, você deve ter uma associação da AWS. Para obter mais informações, confira Detalhes da conta do AWS.

Criar um bucket do Amazon S3 e carregar seus pacotes MSIX e páginas da Web

O Amazon Simple Armazenamento Service (S3) é uma oferta da AWS para coletar, armazenar e analisar dados. Os buckets S3 são uma maneira conveniente de hospedar Windows 10 pacotes de aplicativos e páginas da Web para distribuição.

  1. Faça logoff no AWS. Em Serviços, encontre S3.
  2. Selecione Criar bucket e insira um Nome do bucket para seu site. Siga os prompts de diálogo para definir propriedades e permissões. Para garantir que seu Windows 10 aplicativo possa ser distribuído do seu site, habilita as permissões de Leitura e Gravação para seu bucket e selecione Conceder acesso de leitura público a esse bucket. Clique em Criar bucket para concluir esta etapa.
  3. Quando terminar, carregue seus pacotes MSIX e páginas da Web no bucket S3.

Configurar o aplicativo Web para tipos MIME do pacote de aplicativos

Usando uma interface de serviço Web como o navegador S3 para adicionar um novo Cabeçalho HTTP Padrão.

  1. Navegue até Ferramentas e selecione Cabeçalhos HTTP Padrão.
  2. Na caixa de diálogo Cabeçalhos HTTP Padrão , clique em Adicionar.
  3. Na caixa de diálogo Adicionar Novos Cabeçalhos HTTP Padrão, especifique o nome do bucket, o nome do arquivo, o nome do cabeçalho e o valor do cabeçalho e clique em Adicionar novo cabeçalho.
    • Nome do bucket: msix-packages
    • Nome do arquivo: *.msix
    • Nome do título: Content-Type
    • Valor do header: application/msix

Observação

 A AWS tem algumas diretrizes estritas que você terá que seguir. Por exemplo, os nomes de bucket devem ser exclusivos e, portanto, se você estiver usando o exemplo acima, precisará alterar o nome do Bucket.

Usar o instalador do MSIX Core para criar o ClickOnce aplicativo

Encontre o aplicativo ClickOnce setup.exe. Isso está se referindo ao clone do projeto Git, crie e publique-o por meio Visual Studio projeto.

Execute o comando URL para criar novas setup.exe

Certifique-se de ter seguido as instruções para clonar, criar e publicar a solução MSIX Core Visual Studio. Para referência, o GitHub projeto pode ser encontrado aqui

Navegue até o diretório em que você publicou o arquivo setup.exe e execute este comando:

.\setup.exe -url=<location of your msix in the webservice>

Por exemplo

.\setup.exe -url="https://appinstallerdemo.azurewebsites.net/MSIXCore/msixmgrWrapper.application?https://appinstallerdemo.azurewebsites.net/MSIXCore/notepadplus.msix#"

Assinar o aplicativo

Como a etapa anterior criou um novo setup.exe, você precisará assinar o aplicativo novamente para verificar se você é um editor confiável do aplicativo e estabelecer a integridade do aplicativo. Você pode usar o SignTool e fornecer seu certificado.

Distribuir o aplicativo para seus usuários

Agora você pode apontar para o novo setup.exe com um link ou botão de download em seu site. O MSIX Core é direcionado para usuários Windows 10, versão 1703 e anteriores. O Instalador de Aplicativo é o processo de instalação ideal para pacotes MSIX Windows 1709 ou uma versão posterior. Instalador de Aplicativo otimiza o espaço em disco no lado do consumidor e pode instalar aplicativos diretamente de locais HTTP. O MSIX Core detectará se um consumidor está Windows 1709 ou uma versão posterior e o redireciona para Instalador de Aplicativo.

No Microsoft Edge, você pode chamar o método getHostEnvironmentValue() e o campo os-build no valor de retorno especificará a versão do sistema operacional do usuário. A partir daí, você pode solicitar que o processo de instalação use o MSIX Core (para Windows 10, versão 1703 e anterior) ou Instalador de Aplicativo (para o Windows 10, versão 1709 e posterior).

Experiência do usuário

Os usuários simplesmente baixam e setup.exe da página da Web do desenvolvedor.

  • Se o instalador do MSIX Core ainda não estiver instalado quando o usuário for executado setup.exe, o usuário verá o prompt do ClickOnce e clicará em Instalar para instalar o instalador do MSIX Core. O instalador inicia automaticamente e mostra a tela de instalação do pacote MSIX especificado na cadeia de caracteres de consulta do desenvolvedor para que os usuários possam instalar o aplicativo.
  • Se o instalador do MSIX Core já estiver instalado quando o usuário executa o setup.exe, o instalador do MSIX Core será automaticamente ativado e mostrará a tela de instalação do pacote MSIX especificado na cadeia de caracteres de consulta para que os usuários instalem o aplicativo.