Ambientes
Os ambientes de tag definem vários aspectos principais das criações da biblioteca que são implantadas em seu site ou aplicativo:
- O nome do arquivo da build.
- O domínio e o caminho da build, dependendo do host atribuído pelo ambiente.
- O formato de arquivo da build, dependendo da opção de arquivamento escolhida.
Ao criar um build de biblioteca, você deve atribuí-lo a um ambiente. As extensões, regras e elementos de dados da build são compilados e colocados no ambiente atribuído. Cada ambiente fornece um código integrado exclusivo que permite integrar a build atribuída ao site.
Diferentes artefatos do podem existir em cada ambiente. Esses artefatos permitem testar diferentes bibliotecas em ambientes diferentes, conforme você as envia por meio do fluxo de trabalho.
Este documento fornece etapas sobre como instalar, configurar e criar diferentes ambientes na interface do usuário da Coleção de dados.
Tipos de ambientes
As tags aceitam três tipos de ambientes diferentes, cada um correspondente a um estado diferente no fluxo de trabalho de publicação:
Diferentes artefatos do podem existir em cada ambiente. Dessa forma, você pode testar diferentes bibliotecas em ambientes diferentes, conforme você as envia por meio do fluxo de trabalho.
Instalação installation
Cada ambiente tem um conjunto de instruções usadas para conectá-lo ao seu aplicativo. Para propriedades da Web, essas instruções fornecem códigos integrados. Para propriedades móveis, essas instruções fornecem o código necessário para instanciar as bibliotecas que você está usando e recuperar a configuração no tempo de execução.
Para acessar as instruções de instalação de um ambiente, navegue até a guia Ambientes da propriedade e clique no ícone Instalar do ambiente.
Se estiver usando uma propriedade da Web, você receberá um código integrado para ser usado na tag <head> do seu documento. Você também tem a opção de implantar arquivos de biblioteca de forma síncrona ou assíncrona no tempo de execução. Dependendo da configuração escolhida, as instruções de instalação exibidas serão diferentes. Os códigos integrados são explicados com mais detalhes posteriormente neste documento.
Se estiver usando uma propriedade móvel, você receberá instruções separadas para instalar dependências para Android (via Gradle) e iOS (via CocoaPods).
Configuração móvel
Para propriedades móveis, você pode visualizar as opções de configuração de um ambiente selecionando-o na lista. Aqui, você pode mudar o nome do ambiente. Atualmente, os ambientes móveis só podem usar hosts gerenciados pela Adobe.
Consulte a visão geral dos hosts para obter mais informações.
Configuração da Web
As configurações do ambiente atribuído determinam o seguinte para propriedades da Web:
- Host: o local do servidor em que você deseja que a build seja implantada.
- Configuração de arquivamento: se o sistema deve produzir um conjunto implantável de arquivos ou compactá-los em um formato de arquivo.
- Código integrado: o código do
<script>que será incorporado no HTML das páginas do site, usado para implantar a build da biblioteca no tempo de execução.
Na guia Ambientes, selecione um ambiente listado para exibir seus controles de configuração.
Host host
Selecione Host para escolher um host pré-configurado para o ambiente no menu suspenso
Quando um build é concluído, é enviado ao local especificado para o host atribuído. Para obter informações sobre como criar e configurar hosts de marcas, consulte a visão geral dos hosts.
Configuração de arquivamento archive
A maioria das builds consiste em vários arquivos. As builds de vários arquivos contêm um arquivo da biblioteca principal (vinculado ao código integrado) que contém referências internas aos outros arquivos que são chamados quando necessário.
O botão Criar arquivo permite alternar a configuração de arquivamento do ambiente. Por padrão, a opção de arquivamento é desligada e a build é entregue em um formato que é executado como está (JavaScript para propriedades da Web e JSON para propriedades móveis).
Se você optar por ativar a configuração de arquivamento, configurações adicionais aparecerão na interface do usuário, permitindo que você criptografe opcionalmente o arquivo de arquivamento e defina um caminho para a biblioteca se estiver usando a hospedagem própria.
O caminho pode ser um URL completo ou um caminho relativo que pode ser usado em vários domínios. Isso é importante porque a maioria das builds tem vários arquivos que contêm referências internas umas às outras.
Se você usar a opção de arquivamento, todos os arquivos de build serão entregues como um arquivo ZIP. Isso pode ser útil se:
- Você estiver hospedando a biblioteca automaticamente mas não quiser configurar um host SFTP para entrega.
- É necessário executar a análise do código na build antes da implantação.
- Você só quiser ver o conteúdo da build para ver o que há nela.
Integrar código embed-code
Um código integrado é uma tag <script> que deve ser colocada nas seções <head> das páginas do site para carregar e executar o código que foi criado. Cada configuração de ambiente gera automaticamente seu próprio código integrado. Basta copiá-lo e colá-lo nas páginas do site nas quais você deseja executar as tags.
Ao visualizar as instruções de instalação, é possível optar por fazer com que o script carregue os arquivos da biblioteca de forma síncrona ou assíncrona. Essa configuração não é persistente e não reflete a forma como as tags foram implementadas no site. Em vez disso, apenas mostra a maneira apropriada de instalar o ambiente.
Implantação assíncrona
A implantação assíncrona permite que o navegador continue carregando o restante da página enquanto a biblioteca está sendo recuperada. Há apenas um código integrado ao usar essa configuração, que deve ser colocado no documento <head>.
Para obter mais informações sobre essa configuração, consulte o guia sobre implantação assíncrona.
Implantação síncrona
Quando o navegador lê um código de integração usando implantação síncrona, ele recupera a biblioteca de tags e a executa antes de continuar carregando a página.
Os códigos integrados síncronos consistem em duas tags <script> que devem ser colocadas dentro do HTML do seu site. Uma tag <script> deve ser colocada no documento <head>, enquanto a outra deve ser colocada antes da tag </body> de fechamento.
Integrar atualizações de código
Como os códigos integrados são gerados com base nas configurações do ambiente, algumas alterações de configuração atualizarão automaticamente o código integrado do ambiente em questão. Essas alterações incluem:
- Mudar de um host gerenciado pela Adobe para um host SFTP ou vice-versa.
- Alteração da configuração de arquivamento.
- Atualizar o campo de caminho se a configuração de arquivamento estiver ativada.
Criar um ambiente
Três ambientes são automaticamente atribuídos a uma propriedade quando ela é criada pela primeira vez: desenvolvimento, armazenamento temporário e produção. Isso é suficiente para executar o fluxo de trabalho de publicação. No entanto, você pode adicionar outros ambientes de desenvolvimento, se desejar, pois isso pode ser útil em equipes maiores onde vários desenvolvedores estão trabalhando em projetos diferentes ao mesmo tempo.
Na guia Ambientes da propriedade, selecione Adicionar ambiente.
Na tela seguinte, selecione a opção Desenvolvimento.
A próxima tela permite nomear o novo ambiente, selecionar um host e escolher uma configuração de arquivamento. Quando terminar, clique em Salvar para criar o ambiente.
A guia Ambientes será exibida novamente, com as instruções de instalação do novo ambiente exibidas.
Próximas etapas
Ao ler este documento, você deve ter um entendimento prático para configurar ambientes na interface do usuário e instalá-los em seu site ou aplicativo. Agora você está pronto para começar a publicar as builds de biblioteca.
Conforme você publica iterações da biblioteca, pode ser necessário rastrear e arquivar builds anteriores para fins de solução de problemas e reversão. Consulte o guia sobre republicação de bibliotecas mais antigas para obter mais informações.