DocumentaçãoAEM 6.5Guia do usuário

Configurar o projeto do Visual Studio e criar o aplicativo do Windows set-up-the-visual-studio-project-and-build-the-windows-app

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Usuário
  • Desenvolvedor

O AEM Forms fornece o código-fonte completo do aplicativo AEM Forms. A origem contém todos os componentes para criar um aplicativo de espaço de trabalho personalizado. O arquivo morto de código-fonte, adobe-lc-mobileworkspace-src-<version>.zip, faz parte do pacote adobe-aemfd-forms-app-src-pkg-<version>.zip na Distribuição de Software.

Para obter a origem do aplicativo AEM Forms, execute as seguintes etapas:

  1. Abra a Distribuição de softwares. Você precisa de uma Adobe ID para fazer logon na Distribuição de softwares.

  2. Selecione Adobe Experience Manager, disponível no menu de cabeçalho.

  3. Na seção Filtros:

    1. Selecione Forms na lista suspensa Solução.
    2. Selecione a versão e o tipo do pacote. Você também pode usar a opção Downloads de Pesquisa para filtrar os resultados.

  4. Selecione o nome do pacote aplicável ao seu sistema operacional, selecione Aceitar termos do EULA e selecione Baixar.

  5. Abra o Gerenciador de Pacotes e clique em Carregar Pacote para carregar o pacote.

  6. Selecione o pacote e clique em Instalar.

  7. Para baixar o arquivo morto do código-fonte, abra https://<server>:<port>/crx/de/content/forms/mobileapps/src/adobe-lc-mobileworkspace-src-<version>.zip no navegador.
    O pacote de origem é baixado no dispositivo.

A imagem a seguir exibe o conteúdo extraído de adobe-lc-mobileworkspace-src-<version>.zip.

mws-content-1

A imagem a seguir exibe a estrutura de diretório da pasta windows na pasta src.

win-dir

Configuração do ambiente setting-up-the-environment

Para dispositivos Windows, é necessário:

  • Microsoft Windows 8.1 ou Windows 10
  • Microsoft Visual Studio 2015
  • Ferramentas do Microsoft Visual Studio para Apache Cordova

Configurando o Projeto do Visual Studio para o aplicativo AEM Forms setting-up-visual-studio-project-for-aem-forms-app

Execute as seguintes etapas para configurar o projeto de aplicativo AEM Forms no Visual Studio.

  1. Copie o arquivo morto adobe-lc-mobileworkspace-src-<version>.zip para a pasta %HOMEPATH%\Projects no dispositivo Windows 8.1 ou Windows 10 com o Visual Studio 2015 instalado e configurado.
  2. Extraia o arquivo morto no diretório %HOMEPATH%\Projects\MobileWorkspace.
  3. Navegue até o diretório %HOMEPATH%\Projects\MobileWorkspace\adobe-lc-mobileworkspace-src-[versionsrc]\windows.
  4. Abra o arquivo CordovaApp.sln usando o Visual Studio 2015 e prossiga para a compilação do aplicativo AEM Forms.

Criar aplicativo AEM Forms build-aem-forms-app

Execute as seguintes etapas para criar e implantar o aplicativo AEM Forms.

NOTE
Os dados armazenados no sistema de arquivos do Windows para o aplicativo AEM Forms não são criptografados. É recomendável usar uma ferramenta de terceiros, como a Criptografia de Unidade de Disco BitLocker do Windows, para criptografar dados de disco.

  1. Na Barra de Ferramentas do Visual Studio Standard, selecione Versão na lista suspensa para modo de compilação.

  2. Selecione Windows-AnyCPU, Windows-x64 ou Windows-x86 com base em sua plataforma. Windows-AnyCPU é recomendado.

  3. No Visual Studio Solution Explorer, clique com o botão direito do mouse no projeto CordovaApp.Windows e selecione Loja > Criar AppPackages.

    createapppackages

    O assistente Criar pacotes de aplicativos é exibido.

    O arquivo do instalador CordovaApp.Windows_3.0.2.0_anycpu.appx é criado no diretório platforms\windows\AppPackages\CordovaApp.Windows_3.0.2.0_anycpu_Test.

    Se você encontrar o erro Retarget to windows 8.1 required, clique com o botão direito no erro e, no menu pop-up, selecione Redirecionar para o Windows 8.1.

    retarget-solution

  4. No assistente Criar Pacotes de Aplicativos, selecione clima ou não para carregar seu aplicativo na windows store e clique em Avançar.

    createapppackageswizard1

  5. Faça as alterações nos parâmetros, como a versão e o local de saída da build do aplicativo, conforme necessário.

    createapppackageswizard2

  6. Depois que o projeto for criado, você poderá instalar o aplicativo usando:

    • Windows PowerShell
    • Visual Studio

    O pacote .appx requer os seguintes itens para ser instalado com êxito:

    1. Biblioteca WinJS
    2. Verifique se o pacote vem com um certificado autoassinado ou com um certificado público assinado por uma autoridade confiável, como o VeriSign.
    3. Licença de desenvolvedor

    O diretório Platforms\windows\AppPackages\CordovaApp.Windows_3.0.2.0_anycpu_Test contém os quatro componentes principais:

    1. .appx arquivo
    2. Certificado (Atualmente, é um certificado autoassinado pelo Apache Cordova)
    3. Pasta de dependências
    4. Arquivo do PowerShell (extensão .ps1)

Implantação de um aplicativo usando o Windows PowerShell deploying-an-app-using-windows-powershell

Há duas maneiras de instalar o aplicativo em um dispositivo Windows.

Ao adquirir a licença de desenvolvedor by-acquiring-the-developer-license

  1. Clique com o botão direito do mouse no arquivo do PowerShell ( Add-AppDevPackage.ps1)) e escolha Executar com PowerShell.

  2. A instalação solicita que você obtenha uma licença de desenvolvedor. Use as credenciais de conta da Microsoft para adquirir uma licença de desenvolvedor.
    Esta licença é válida por 30 dias e você pode renová-la gratuitamente.

  3. Quando você adquire a licença de desenvolvedor, a configuração instala o certificado autoassinado no sistema e o aplicativo é instalado com êxito.

Ao usar dispositivos de propriedade empresarial by-using-enterprise-owned-devices

Para dispositivos de propriedade corporativa que ingressaram no domínio da empresa, não é necessário adquirir uma licença de desenvolvedor.

Dispositivos de propriedade corporativa usam as edições Professional e Enterprise do Windows.

A Microsoft recomenda instalar um certificado público emitido por uma autoridade confiável, como o VeriSign.

Para implantar o aplicativo:

  • Verifique se o dispositivo ingressou no domínio da empresa.
  • Habilitar configuração de política de grupo.

Para habilitar a configuração de diretiva de grupo:

  1. Em seu dispositivo, execute gpedit.msc.

  2. Navegue até Configuração do Computador > Modelos Administrativos > Componente do Windows > Implantação do Pacote de Aplicativos.

  3. Clique com o botão direito do mouse em Permitir que todos os aplicativos confiáveis sejam instalados.

  4. Clique em Editar e selecione Habilitado.

  5. Clique em OK.

Edite o script do PowerShell gerado pelo Visual Studio para impedi-lo de adquirir uma licença de desenvolvedor.

No script do PowerShell, defina a variável: $NeedDeveloperLicense = $false.

Para dispositivos que não ingressaram em um domínio, é necessário carregar manualmente a chave de ativação do produto. Você pode comprá-lo de um revendedor Windows.

Para o Windows 8.1 Home Edition, não há política de grupo, o carregamento lateral da empresa não é permitido e você não pode ingressá-lo com o domínio da empresa. Implante o aplicativo em um dispositivo Windows 8.1 Home Edition usando uma licença de desenvolvedor.

Para obter mais informações, clique aqui.

Implantando um aplicativo usando o Visual Studio deploying-an-app-using-visual-studio

Para instalar o aplicativo no Windows usando o Visual Studio:

  1. Conecte o dispositivo usando o depurador remoto.
    Para obter mais informações, consulte Executar aplicativos da Windows Store em um computador remoto.

  2. Com seu aplicativo aberto no Visual Studio, escolha Windows-x64, Windows-x86 ou Windows-AnyCPU na lista Plataformas de Soluções e selecione Computador Remoto.

  3. Seu aplicativo é implantado no computador remoto.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2