Miljöer
Taggmiljöer definierar flera viktiga aspekter av de biblioteksbyggen som du distribuerar på din webbplats eller i din app:
- Budets filnamn.
- Domänen och sökvägen för bygget, beroende på miljöns tilldelade värd.
- Filformatet för bygget, beroende på vilket arkivalternativ som har valts.
När du skapar en biblioteksversion måste du tilldela den till en miljö. Byggnadens tillägg, regler och dataelement kompileras sedan och placeras i den tilldelade miljön. Varje miljö har en unik inbäddningskod som gör att du kan integrera den tilldelade inbäddningen på din plats.
Olika artefakter kan finnas i varje miljö. På så sätt kan du testa olika bibliotek i olika miljöer när du kör dem i ditt arbetsflöde.
Det här dokumentet innehåller anvisningar om hur du installerar, konfigurerar och skapar olika miljöer i användargränssnittet för datainsamling.
Miljötyper
Taggar har stöd för tre olika miljötyper, som alla motsvarar olika lägen i publiceringsarbetsflödet:
Olika artefakter kan finnas i varje miljö. På så sätt kan du testa olika bibliotek i olika miljöer samtidigt som du använder dem i publiceringsarbetsflödet.
Installation installation
Varje miljö har en uppsättning instruktioner som används för att ansluta den till ditt program. För webbegenskaper innehåller dessa instruktioner inbäddningskoder. För mobila egenskaper innehåller dessa instruktioner den kod som krävs för att instansiera biblioteken som du använder och hämta konfigurationen vid körning.
Om du vill få tillgång till installationsinstruktionerna för en miljö går du till fliken Environments för egenskapen och väljer sedan ikonen Install för den miljön.
Om du använder en webbegenskap får du en inbäddningskod som ska användas i taggen <head> i dokumentet. Du får också möjlighet att distribuera biblioteksfiler synkront eller asynkront vid körning. Beroende på vilken inställning du väljer visas olika installationsanvisningar. Inbäddningskoder förklaras närmare senare i det här dokumentet.
Om du använder en mobil egenskap får du separata instruktioner för hur du installerar beroenden för Android (via Gradle) och iOS (via CocoaPods).
Mobilkonfiguration
För mobila egenskaper kan du visa konfigurationsalternativen för en miljö genom att välja den i listan. Härifrån kan du ändra namnet på miljön. I mobilmiljöer kan för närvarande endast värdar som hanteras av Adobe användas.
Mer information finns i översikten på värdar.
Webbkonfiguration
Inställningarna från den tilldelade miljön avgör följande för webbegenskaper:
- Värd: Den serverplats där du vill att din version ska distribueras.
- Arkivinställning: Anger om systemet ska skapa en distributionsbar uppsättning filer eller låta dem komprimeras i ett arkivformat.
- Bädda in kod: Den
<script>-kod som ska bäddas in HTML på webbplatsens sidor, som används för att distribuera biblioteksbygget vid körning.
På fliken Environments väljer du en listad miljö för att visa dess konfigurationskontroller.
Värd host
Välj Host om du vill välja en förkonfigurerad värd för miljön i listrutan.
När ett bygge skapas levereras det till den plats som du angav för den tilldelade värden. Mer information om hur du skapar och konfigurerar taggvärdar finns i värdöversikten.
Arkivinställning archive
De flesta byggen består av flera filer. Flerfilsbyggen innehåller en huvudbiblioteksfil (länkad i inbäddningskoden) som innehåller interna referenser till andra filer som hämtas in efter behov.
Med knappen Create archive kan du växla systemens arkivinställning. Som standard är arkivalternativet inaktiverat och bygget levereras i ett format som körs i befintligt skick (JavaScript för webbegenskaper och JSON för mobilegenskaper).
Om du aktiverar arkivinställningen visas ytterligare konfigurationsinställningar i användargränssnittet, vilket gör att du kan kryptera arkivfilen och definiera en sökväg till biblioteket om du använder självbetjäning.
Sökvägen kan vara antingen en fullständig URL eller en relativ sökväg som kan användas i flera domäner. Detta är viktigt eftersom de flesta byggen har flera filer som innehåller interna referenser till varandra.
Om du använder arkivalternativet levereras alla byggfiler som en ZIP-fil i stället. Detta kan vara användbart om:
- Du är själv värd för biblioteket men vill inte konfigurera en SFTP-värd för leverans.
- Du måste köra kodanalys på bygget före distributionen.
- Du vill bara titta på bygginnehållet för att se vad det innehåller.
Bädda in kod embed-code
En inbäddningskod är en <script>-tagg som måste placeras i <head> -avsnitten på webbplatsens sidor för att koden som du skapar ska kunna läsas in och köras. Varje miljökonfiguration genererar automatiskt sin egen inbäddningskod, så du behöver bara kopiera och klistra in den på din plats på de sidor där du vill att taggar ska köras.
När du visar installationsinstruktionerna kan du välja att skriptet ska läsa in biblioteksfilerna synkront eller asynkront. Den här inställningen är inte beständig och återspeglar inte hur du har implementerat taggar på din plats. Istället är det bara tänkt att visa rätt sätt att installera miljön.
Asynkron distribution
Asynkron distribution gör att webbläsaren kan fortsätta läsa in resten av sidan medan biblioteket hämtas. Det finns bara en inbäddningskod när den här inställningen används, som måste placeras i dokumentet <head>.
Mer information om den här inställningen finns i guiden om asynkron distribution.
Synkron distribution
När webbläsaren läser en inbäddningskod med synkron distribution, hämtas taggbiblioteket och körs innan sidan läses in.
Synkrona inbäddningskoder består av två <script>-taggar som måste placeras HTML på webbplatsen. En <script>-tagg måste placeras i dokumentet <head>, medan den andra måste placeras precis före den avslutande </body>-taggen.
Bädda in koduppdateringar
Eftersom inbäddningskoder genereras baserat på dina miljökonfigurationer, kommer vissa konfigurationsändringar automatiskt att uppdatera inbäddningskoden för miljön i fråga. Bland dessa ändringar finns:
- Byta från en värddator som hanteras av Adobe till en SFTP-värd, eller vice versa.
- Ändra arkivinställningen.
- Uppdaterar sökvägsfältet om arkivinställningen är aktiverad.
Skapa en miljö
Tre miljöer tilldelas automatiskt till en egenskap när egenskapen skapas: utveckling, staging och produktion. Detta räcker för att köra publiceringsarbetsflödet. Om du vill kan du dock lägga till ytterligare utvecklingsmiljöer, eftersom detta kan vara användbart för större team där flera utvecklare arbetar med olika projekt samtidigt.
Välj Add Environment på fliken Environments för egenskapen.
På nästa skärm väljer du alternativet Development.
På nästa skärm kan du namnge den nya miljön, välja en värd och välja en arkivinställning. När du är klar väljer du Save för att skapa miljön.
Fliken Environments visas igen och installationsanvisningarna för den nya miljön visas.
Nästa steg
Genom att läsa det här dokumentet bör du ha en fungerande förståelse för hur du konfigurerar miljöer i användargränssnittet och installerar dem på din webbplats eller i din app. Nu kan du börja publicera dina biblioteksbyggen.
När du publicerar versioner av ditt bibliotek över tid kan du behöva spåra och arkivera tidigare versioner för felsökning och återställning. Mer information finns i guiden Publicera om äldre bibliotek.