Out of the Box App Handlers out-of-the-box-app-handlers

CAUTION
AEM 6.4 har nått slutet på den utökade supporten och denna dokumentation är inte längre uppdaterad. Mer information finns i teknisk supportperiod. Hitta de versioner som stöds här.
NOTE
Adobe rekommenderar att du använder SPA Editor för projekt som kräver ramverksbaserad klientåtergivning för en sida (t.ex. Reagera). Läs mer.

Se följande riktlinjer för utveckling av Hanterare för innehållssynkronisering:

  • Hanterare måste implementera com.day.cq.contentsync.handler.ContentUpdateHandler (antingen direkt eller genom att utöka en klass som gör det)
  • Hanterare kan utöka com.adobe.cq.momobile.platform.impl.contentsync.handler.AbstractSlingResourceUpdateHandler
  • Hanteraren får bara rapportera true om de uppdaterade ContentSync-cachen. Felaktig rapportering av true tillåter AEM att skapa en uppdatering.
  • Hanteraren bör bara uppdatera cacheminnet om innehållet faktiskt ändras. Skriv inte till cacheminnet om en vit bild inte behövs och undvik att skapa en onödig uppdatering.

Out-of-Box Handlers out-of-the-box-handlers

I följande lista visas färdiga apphanterare:

mobileapppages Återger appsidor.

  • type - String - mobileapppages

  • path - String - sökväg till en sida

  • extension - String - Tillägg som ska användas i begäran. För sidor är det här nästan alltid html men andra är fortfarande möjliga.

  • selector - String - Valfria väljare avgränsade med punkt. Vanliga exempel är touch för återgivning av mobilversioner av en sida.

  • deep - Boolean - Valfri boolesk egenskap som avgör om underordnade sidor också ska inkluderas. Standardvärdet är true.

  • includeImages - Boolean - Valfri boolesk egenskap som avgör om bilder ska inkluderas. Standardvärdet är true.

    • Som standard beaktas endast bildkomponenter med en resurstyp för grund/komponenter/bild.
  • includeVideos - Boolean - Valfri boolesk egenskap avgör om videor ska inkluderas. Standardvärdet är true.

  • includeModifiedPagesOnly - Boolean - Om värdet är false eller utelämnas återger du alla sidor och kontrollerar uppdateringarna vid återgivningen. Om värdet är true tonas basen av ändringar av sidorna lastModified.

  • + rewrite (node)
    - relativeParentPath - String - sökvägen som alla andra sökvägar ska skrivas i förhållande till.

NOTE
Resurstypen för de bild- och videokomponenter som påverkas av hanteraren anges genom att egenskaperna för com.adobe.cq.momobile.platform.impl.contentsync.handler.Tjänsten MobilePagesUpdateHandler OSGi.

mobilepageresurser Samlar appsidesresurser.

mobilecontentlisting Visar innehållet i ContentSync-zippen. Detta används av klientsidan js på enheten för att utföra den initiala filkopiering som krävs för AEM program.

Hanteraren bör läggas till i alla AEM Apps ContentSync Config.

  • type - String - mobilecontentlisting
  • bana - String - behåll tom, måste finnas för att kunna ses som en giltig hanterare, men sökvägen härleds till aktuell ContentSync-cache. Detta värde ignoreras.
  • targetRootDirectory - ​Sträng - det prefix som ska läggas till i sökvägar som målrot för innehållsuppdatering för hanteraren.
  • order - lång - ​Beställ så att ContentSync kör hanteraren. Det här talet ska anges högre än alla andra hanterare, till exempel 100. Den ska köras efter traditionella innehållshanterare.
{
  "files": [
    "config.xml",
    "res/screens/ios/screen-ipad-portrait-2x.png",
    "res/screens/ios/screen-ipad-landscape.png",
    "res/screens/ios/screen-iphone-portrait-2x.png",
    "res/screens/ios/screen-iphone-landscape.png",
    "res/screens/ios/screen-iphone-portrait.png",
    "apps/weretail-app/components/splash-page/clientlibs.css",
    ...
    "pge-content-packages.json"
  ],
  "count": 382,
  "lastModified": 1422902754733
}

mobilinnehållpaketerlista Listar AEM innehållspaket i en viss app samt serverURL att göra uppdateringsbegäranden till. Detta används för att begära innehållsuppdateringar från klientsidan på enheten

Hanteraren ska användas AEM App Shell ContentSync Config (nod med page-type=app-instance)

  • type - String - mobilecontentpackageslista
  • bana ​-Sträng - Sökväg till ett programskal (nod med page-type=app-instance).
  • targetRootDirectory - String - det prefix som ska läggas till i sökvägar som målrot för innehållsuppdatering för hanteraren.
  • order - lång - ​Ordna så att ContentSync kör hanteraren. Det här talet ska anges högre än alla andra hanterare, till exempel 100. Den ska köras efter traditionella innehållshanterare.
NOTE
Följande kodblock är inte en exakt implementering och ska användas som ett referensexempel:
{
  "content": [
    {
      "name": "en",
      "title": "We Retail Mobile App - English",
      "type": "CONTENT",
      "path": "/content/phonegap/weretail-outdoors/en",
      "updatePath": "/content/phonegap/weretail/en/jcr:content/pge-app/app-config"
    },
    {
      "name": "shell",
      "title": "We Retail Mobile App",
      "type": "INSTANCE",
      "path": "/content/phonegap/weretail-outdoors/shell",
      "updatePath": "/content/phonegap/weretail/shell/jcr:content/pge-app/app-config"
    }
  ],
  "serverURL": "http://localhost:4503/"
}

widgetconfig Innehåller en uppdaterad config.xml som sammanfogar alla redigeringar som gjorts via kommandocentralen med en angiven config.xml. Om den här hanteraren inte inkluderas ingen appinformation som ändras via administrationsgränssnittet i cachen.

Hanteraren ska användas i en AEM App Shell ContentSync-konfiguration (nod med page-type=[app-instance]).

  • type - String - ​ widgetconfig
  • bana ​-Sträng - Sökväg till en underordnad programgränssnittsnod (nod med page-type=[app-instance]).
  • targetRootDirectory - String - det prefix som ska läggas till i sökvägar som målrot för innehållsuppdatering för hanteraren.
  • targetIconDirectory - String - katalogen där ikonerna för programmet ska placeras

mobileADBMomobileConfigJSON Inkludera filen ADBMobleConfig.JSON om AMS-molntjänsten har konfigurerats.

Detta används vid kompileringen för att konfigurera AMS-plugin-programmet för analysstöd.

Hanteraren ska användas AEM App Shell ContentSync Config (nod med page-type=app-instance)

  • type - String - mobileADBMomobileConfigJSON
  • path - String - Sökväg till ett programskal (nod med pge-type=app-instance eller en RT som utökar /libs/mobileapps/core/components/instance)
  • targetRootDirectory - String - det prefix som ska läggas till i sökvägar som målrot för innehållsuppdatering för hanteraren

meddelandenconfig Extraherar de meddelandekonfigurationer som krävs på enheten. Egenskaperna extraheras från respektive push-tjänstmolntjänstkonfiguration som är kopplad till appen.

Egenskaper som inte är AEM i molntjänstens jcr:content-nod extraheras och läggs till i page-notifications-config.json JSON-fil för inkludering i programinnehållets www-rot.

AEM är de som är namnmellanrumsbaserade med"cq","sling" eller"jcr". Andra egenskaper kan exkluderas med hjälp av egenskapen excludeProperties på konfigurationsnoden för innehållssynkronisering.

  • type - String - meddelandenconfig
  • excludeProperties - String[] - egenskaper som ska uteslutas

contentSyncConfigContent Samlar in innehåll från en befintlig ContentSync-konfiguration.

  • type - String - contentsyncconfigcontent

  • path - String - Sökväg till något av följande:

    • en annan ContentSync-konfiguration
    • till ett innehållspaket (använder egenskapen phonegap-exportTemplate för att hitta dess ContentSync-konfiguration)
    • till en mobilresurs (appinnehåll hittas under den resursen och, om innehållspaketen har en page-includeInBuild-egenskap som är true, används phonegap-exportTemplate för att hitta dess ContentSync-konfiguration)
  • autoCreateFirstUpdateBeforeImport - Boolean - om true, skapa en inledande uppdatera i målkonfigurationen före import om det inte redan finns en gång

  • autoFillBeforeImport - Boolean - om true, uppdatera/fyll målkonfigurationen före import

  • configSuffix - String - en sträng som ska läggas till i den sökväg som anges i egenskapen "phonegap-exportTemplate" för app-content. Detta kan användas för att skilja olika exportmallar åt. Den här egenskapen kan till exempel anges till "-dev" för att visa att "/…/…/…/appconfig-dev" bör användas (i stället för "/…/…/…/appconfig").

app-assets Inkluderar alla resurser som är associerade med en programinstans. Hanteraren inkluderar alla resurser som hittas under den angivna sökvägen tillsammans med alla resurser som refereras av en programinstans appAssetPath-egenskap.

  • type - String - app-assets

  • bana ​-Sträng - sökväg till en plats under en programinstans där appresurser lagras

mobileappoffers En ny hanterare för innehållssynkronisering har introducerats för att återge anpassat innehåll. Hanteraren mobileappoffers vet hur man återger associerade målerbjudanden som har skapats av innehållsförfattaren. Hanteraren för mobileappoffers utökar den abstrakta siduppdateringshanteraren, vilket innebär att många av egenskaperna liknar varandra. Mer information om hanteraren för mobileappoffers har följande egenskaper.

Hanteraren för mobileappers utökar hanteraren för mobileappspages och lägger till följande egenskaper:

  • locationRoot - String - ange platsen för mobilprogrammet
  • includePageTypes - String - har som standard stöd för cq/personalization/components/teaserpage och cq/personalization/components/offerproxy
  • selector - String - ska anges till Standard
  • path - String- vägen till kampanjens varumärke

mobileappconfig Hanteraren för innehållssynkronisering i mobileappconfig erbjuder ett sätt att injicera JSON-data i MobileAppsConfig.json. För att registrera en leverantörsklass lägger utvecklare till sin MobileAppsInfoProvider-klass med listan över providers. Hanteraren itererar över listan med MobileAppsInfoProviders och tillåter att providern matar in data i den resulterande JSON-filen. Listan med egenskaper som den här hanteraren stöder är:

  • bana ​-Sträng - sökvägen till en programinstansnod med pge-type=app-instance eller en RT som utökar /libs/mobileapps/core/components/instance
  • providers - String [] - listan över kvalificerade MobileAppsInfoProviders
  • targetRootDirectory - String - katalogen där filen MobileAppsConfig.json ska skrivas.
  • fileName - String - valfritt namn på filen som JSON ska skrivas till, standard är MobileAppsConfig.json

Det går att ha flera hanterare för mobilappconfig konfigurerade var och en med en unik uppsättning providers som skriver till olika JSON-filer.

Testar Content Sync-hanterare testing-content-sync-handlers

Steg för att kontrollera integriteten Rensa cache

  • Rensa cache
  • Kör hanteraren (cachen har uppdaterats)
  • Kör hanteraren igen (cachen bör inte uppdateras)

Steg för felsökning

  • Kör konfigurationen
  • Exportera din konfiguration eller granskning på enheten
  • Om återgivningen misslyckas, sök efter saknade stilar/resurser/libs eller sök efter dåliga sökvägar till stilar/resurser/libs

Loggning Aktivera ContentSync-felsökningsloggning via OSGI-loggkonfigurationer i paketet com.day.cq.contentsync På så sätt kan du spåra vilka hanterare som har körts och om de har uppdaterat cachen och rapporterat att cachen har uppdaterats.

Ytterligare resurser additional-resources

Mer information om roller och ansvar för en administratör och utvecklare finns i resurserna nedan:

NOTE
Kom igång med AEM Mobile apputveckling genom att klicka här.
recommendation-more-help
547b817b-14b5-4d82-aa0f-a64750e0e592