Partilhar via


Criar um pacote MSIX com MSIX Core a partir do 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 o ClickOnce. Isso permitirá que seus usuários baixem um setup.exe e instalem o aplicativo MSIX através do instalador do MSIX Core.

Hospede seu aplicativo em um servidor Web

Para preparar seu aplicativo para inicialização com o instalador do MSIX Core, você precisará hospedar o pacote do aplicativo 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 na 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, vá para a página do 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 Code ou Docker Container e o Runtime Stack. Caso contrário, deixe todo o resto padrão.
  4. Clique em Criar e termine o assistente.

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

  1. Depois de criar o aplicativo Web, selecione-o.
  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 rato no espaço vazio do Explorador de Ficheiros e selecione Carregar Ficheiros para começar a carregar os pacotes da sua aplicação.
  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 a aplicação web para tipos MIME do pacote de aplicação

Adicione um novo arquivo chamado Web.config ao aplicativo Web. Abra o arquivo Web.config e adicione o seguinte XML 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 recursos do Windows.
  2. Selecione Serviços de Informações da Internet.
  3. Certifique-se também de instalar o ASP.NET 4.5 ou superior. Na caixa de diálogo Recursos do Windows, expanda Serviços de Informações da Internet ->Serviços da World Wide Web ->Recursos de Desenvolvimento de Aplicativos e selecione uma versão do ASP.NET 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 Web são necessários. Se você já tiver o Visual Studio 2017 ou uma versão posterior instalada, certifique-se de ter as cargas de trabalho de desenvolvimento ASP.NET e Web instaladas. Caso contrário, instale o Visual Studio a partir daqui.

Criar um aplicativo Web

Inicie o Visual Studio como administrador e crie um novo projeto Visual C# Web Application 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 de 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 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 da aplicação.

Criar uma página Web

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

Configurar a aplicação web para tipos MIME do pacote de aplicação

Abra o arquivo Web.config no gerenciador de soluções e adicione o seguinte XML 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 ser membro da AWS. Para obter mais informações, consulte Detalhes da conta da AWS.

Crie um bucket do Amazon S3 e faça upload de 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 do S3 são uma maneira conveniente de hospedar pacotes de aplicativos e páginas da Web do Windows 10 para distribuição.

  1. Faça login na AWS. Em Serviços , localize S3.
  2. Selecione Criar bucket e insira um nome de bucket para seu site. Siga as instruções de diálogo para definir propriedades e permissões. Para garantir que seu aplicativo do Windows 10 possa ser distribuído a partir do seu site, habilite as permissões de Leitura e Gravação para seu 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 para o bucket do S3.

Configurar a aplicação web para tipos MIME do pacote de aplicação

Usando uma interface de serviço Web como o navegador S3 para adicionar novos cabeçalhos 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: Content-Type
    • Valor do cabeçalho: application/msix

Observação

 A AWS tem algumas diretrizes rígidas 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.

Use o instalador MSIX Core para criar o aplicativo ClickOnce

Encontre a sua aplicação ClickOnce setup.exe. Isso está se referindo ao clone do projeto Git, compilá-lo e publicá-lo por meio do projeto Visual Studio.

Execute o comando URL para criar o novo setup.exe

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

Navegue até o diretório onde 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#"

Assine o pedido

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 podes apontar para o novo setup.exe com um link ou botão de download no site deles. MSIX Core é direcionado para usuários no Windows 10, versão 1703 e anteriores. O App Installer é o processo de instalação ideal para pacotes MSIX no Windows 1709 ou uma versão posterior. O App Installer otimiza o espaço em disco no lado do consumidor e pode instalar aplicativos diretamente de locais HTTP. O MSIX Core detetará se um consumidor está no Windows 1709 ou em uma versão posterior e o redirecionará para o App Installer.

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 o processo de instalação para usar o MSIX Core (para Windows 10, versão 1703 e anterior) ou o App Installer (para Windows 10, versão 1709 e posterior).

Experiência do utilizador

Os utilizadores simplesmente descarregam e executam o setup.exe a partir da página Web do desenvolvedor.

  • Se o instalador do MSIX Core ainda não estiver instalado quando o usuário executar o 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 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 executar o 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.