Komma igång med tilläggsutveckling
För att du ska komma igång och bygga tillägg kommer vi att använda verktyget för öppen källkod, som Adobe ingenjörer tillhandahåller för att skapa de filer och den filstruktur som behövs för tilläggspaketet, så allt du har kvar att göra är den värdefulla delen: skriv koden i själva verket.
Förhandskrav
- Installera Node.js.
Tilläggsinställningar
Skapa en katalog där tilläggsfilerna ska finnas.
mkdir example && cd example
Den här guiden använder tilläggsverktyget för att bygga ut den inledande tilläggsstrukturen så att utvecklare snabbt kan börja koda. Om du vill kan du utföra den här processen manuellt utan att använda verktyget för att skapa ställningar.
Kör verktyget ställningar.
npx @adobe/reactor-scaffold
Ställningsverktyget frågar efter några initiala konfigurationsalternativ enligt följande:
- Visningsnamn - det synliga namnet på tillägget
- Plattform - Anger om tillägget har utvecklats för webb, mobil eller kant
- Version - Tilläggets version
- Beskrivning - En kort beskrivning av syftet med tillägget
- Författare - Namnet på tilläggets författare
Verktyget kommer sedan att innehålla alternativ för att skapa tilläggsstrukturen:
- Vyn för tilläggskonfiguration: Vyn, HTML-filen, genom vilken ett tillägg samlar globala inställningar från en användare.
- Händelsetyper: Definierar en aktivitet för observation. Du kan till exempel veta när en användare rullar snabbt eller när en användare interagerat med ett sidelement. Händelser kan sedan användas i regler för att utföra åtgärder.
- Villkorstyper: Villkorstyper utvärderar om något är sant eller falskt.
Detta kan till exempel returneras om användarens webbläsare är Chrome, om användaren använder en iPad eller om användaren finns på en viss domän. - Åtgärdstyper: Den åtgärd som ska utföras när en händelse inträffar. Skicka till exempel en analysfyr, visa ett erbjudande, spara en cookie eller öppna en supportchatt.
- Dataelementtyper: Ett dataelement hämtar en datadel. Dessa data kan lagras lokalt, i en cookie, i ett DOM-element eller på en anpassad plats.
- Delade moduler (endast webben): En delad modul är en mekanism genom vilken tillägg kan kommunicera med andra tillägg.
- Vyer: Varje händelse, villkor, åtgärd eller dataelementtyp kan innehålla en vy som gör att användaren kan ange inställningar.
- URL för Exchange (endast webb och kant): När ett tillägg publiceras till Adobe offentliga katalog anger du URL:en för listan här.
- Ikonsökväg: En sökväg till en ikonfil för tillägget.
- Efterföljande körningar av byggnadsverktyget hoppar över den inledande konfigurationen.
- Mer än en av varje händelse, villkor, åtgärd, kan läggas till.
- Det får bara finnas en konfigurationsvy.
Nästa steg
- Följ översikten över överföringsprocessen och förbered dig för att validera och överföra tillägget för testning i taggens ekosystem.