Criar um pacote MSIX com o MSIX Core a partir do código-fonte

MSIX Core traz a implantação de MSIX para versões anteriores do Windows. Você pode aproveitar o instalador do MSIX Core para criar um aplicativo usando o 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, no IIS (Serviços de Informações da Internet) e no Amazon Web Services (AWS).

Azul

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

Criar um aplicativo Web do Azure

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

1. Clique em Criar um Recurso.
2. Clique na 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 Tempo de Execução. Caso contrário, deixe todo o resto padrão.
4. Clique em Criar e conclua 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 hostingstart.html padrão. Clique com o botão direito do mouse no espaço vazio do Explorador de Arquivos e selecione Carregar Arquivos para começar a carregar os pacotes do aplicativo.
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. Nomeie 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 arquivo Web.config 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 opcional do Windows. Para instalar o IIS:

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

O Visual Studio 2017 (ou uma versão posterior) e as Ferramentas de Desenvolvimento da Web são necessários. Se você já tiver o Visual Studio 2017 ou uma versão posterior instalada, verifique se você tem as cargas de trabalho de ASP.NET e desenvolvimento da Web instaladas. Caso contrário, instale o Visual Studio daqui.

Criar um aplicativo Web

Inicie o 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. Nas propriedades, selecione a guia Web .
3. Na seção Servidores , escolha O IIS Local no menu suspenso e clique em Criar Diretório Virtual.

Adicionar o pacote de aplicativos ao aplicativo Web

Adicione o pacote de aplicativos que você deseja distribuir para o 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 nomeie os pacotes de pasta.
3. Para adicionar pacotes de aplicativos à pasta, clique com o botão direito do mouse na pasta de 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 do novo setup.exe.

Configurar o aplicativo Web para tipos MIME do pacote de aplicativos

Abra o arquivo Web.config do gerenciador de soluções e adicione o XML a seguir dentro do <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>

Amazon Web Services (AWS)

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

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

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

1. Faça logon no AWS. Em Serviços, encontre S3.
2. Selecione Criar bucket e insira um nome bucket para seu site. Siga os prompts de diálogo para definir propriedades e permissões. Para garantir que seu aplicativo Windows 10 possa ser distribuído do seu site, habilite as permissões de Leitura e Gravação para o bucket e selecione Conceder acesso público de leitura a este 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 cabeçalho: Tipo de conteúdo
   • Valor do cabeçalho: application/msix

Usar o instalador do MSIX Core para criar o aplicativo ClickOnce

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

Executar o comando URL para criar novo setup.exe

Verifique se você seguiu as instruções para clonar, compilar e publicar a solução MSIX Core no Visual Studio. Para referência, o projeto do GitHub 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 no site deles. O MSIX Core é direcionado para usuários no Windows 10, versão 1703 e anteriores. O Instalador de Aplicativos é o processo de instalação ideal para pacotes MSIX no Windows 1709 ou em uma versão posterior. O Instalador de Aplicativos otimiza o espaço em disco no lado do consumidor e pode instalar diretamente aplicativos de locais HTTP. O MSIX Core detectará se um consumidor está no Windows 1709 ou em uma versão posterior e os redirecionará para o Instalador de Aplicativos.

No Microsoft Edge, você pode chamar o método getHostEnvironmentValue() e o campo de build do sistema operacional no valor retornado 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 o Instalador de Aplicativos (para Windows 10, versão 1709 e posterior).

Experiência do usuário

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

• Se o instalador do MSIX Core ainda não estiver instalado quando o usuário executar setup.exe, o usuário verá o prompt clickOnce e clicará em Instalar para instalar o instalador do MSIX Core. O instalador é iniciado automaticamente e mostra a tela de instalação do pacote MSIX especificado na cadeia 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 executar setup.exe, o instalador do MSIX Core será iniciado automaticamente 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.