具有內容同步的行動裝置 mobile-with-content-sync

使用「內容同步」來封裝內容，以便用於原生行動應用程式。 在AEM中撰寫的頁面可作為應用程式內容，即使裝置離線亦然。 此外，由於AEM頁面是以網頁標準為基礎，因此可跨平台運作，讓您將其內嵌於任何原生包裝函式中。 此策略可降低開發工作量，並讓您輕鬆更新應用程式內容。

內容同步框架將建立包含Web內容的存檔檔案。 內容可以是簡單頁面、影像和PDF檔案，或整個Web應用程式中的任何內容。 內容同步API可從行動應用程式或建置程式存取封存檔案，以便擷取內容並納入應用程式中。

下列步驟順序說明內容同步的典型使用案例：

開發內容同步處理常式 developing-the-content-sync-handlers

以下是開發內容同步處理常式的一些准則：

設定內容同步內容 configuring-the-content-sync-content

建立「內容同步」設定，以指定傳送至用戶端的ZIP檔案內容。 您可以建立任意數量的「內容同步」設定。 每個設定都有識別用途的名稱。

若要建立「內容同步」設定，請新增 cq:ContentSyncConfig 節點到儲存庫， sling:resourceType 屬性設定為 contentsync/config. 此 cq:ContentSyncConfig 節點可位於存放庫的任何位置，但AEM發佈執行個體上的使用者必須能存取該節點。 因此，您應在下方新增節點 /content.

若要指定「內容同步ZIP」檔案的內容，請將子節點新增至cq:ContentSyncConfig節點。 每個子節點的以下屬性標識要包含的內容項目，以及添加內容時如何處理該內容項目：

請參閱 內容同步設定範例 以取得更多資訊。

建立「內容同步」設定後，它會顯示在「內容同步」控制台中。

設定內容同步下載的存取權 configuring-access-to-content-sync-downloads

指定可從「內容同步」下載的使用者或群組。 您可以配置預設用戶或組，這些用戶或組可以從所有內容同步快取中下載，並且可以覆蓋預設用戶或組並配置特定內容同步配置的訪問權限。

安裝AEM時，管理員群組的成員預設可從「內容同步」下載。

設定內容同步下載的預設存取權 setting-the-default-access-for-content-sync-downloads

Day CQ Content Sync Manager服務會控制對「內容同步」的存取。 設定此服務以指定預設可從「內容同步」下載的使用者或群組。

如果您 使用Web控制台配置服務，鍵入用戶或組的名稱，作為備援快取可授權屬性的值。

如果您 在存放庫中設定，請使用服務的下列相關資訊：

覆蓋內容同步快取的下載訪問 overriding-download-access-for-a-content-sync-cache

若要為特定內容同步設定設定下載存取權，請將下列屬性新增至 cq:ContentSyncConfig 節點：

例如，您的應用程式可讓使用者直接從內容同步安裝更新。 若要讓所有使用者下載更新，請將可授權屬性的值設為 everyone.

若 cq:ContentSyncConfig 節點沒有可授權的屬性，為Day CQ Content Sync Manager服務的「備援快取可授權」屬性設定的預設使用者或群組，會決定可下載的人員。

配置用於更新內容同步快取的用戶 configuring-the-user-for-updating-a-content-sync-cache

當使用者執行內容同步快取的更新時，特定使用者帳戶會代表使用者執行動作。 匿名用戶預設會更新所有內容同步快取。

您可以覆寫預設使用者，並指定更新特定「內容同步」快取的使用者或群組。

若要覆寫預設使用者，請指定一個使用者或群組，將下列屬性新增至cq:ContentSyncConfig節點，以執行特定內容同步設定的更新：

若 cq:ContentSyncConfig 節點沒有 updateuser 屬性，預設值 anonymous 用戶更新快取。

配置類型 configuration-types

處理作業的範圍包括轉譯簡單JSON到完整轉譯頁面（包括其參考的資產）。 本節列出可用的配置類型及其特定參數：

副本 只需複製檔案和資料夾。

內容 使用標準呈現內容 Sling要求處理.

clientlib 封裝Javascript或CSS用戶端程式庫。

資產

收集資產的原始轉譯。

影像 收集影像。

影像類型可用來將We Retail標誌包含在zip檔案中。

頁面 轉譯AEM頁面並收集參考的資產。

重寫 重寫節點定義如何在匯出的頁面中重寫連結。 重寫的連結可以指向zip檔案中包含的檔案或指向伺服器上的資源。

此 rewrite 節點必須位於下方 page 節點。

此 rewrite 節點可以具有以下一個或多個屬性：

每個屬性都可以有下列其中一個值：

名為的AEM服務 PathRewriterTransformerFactory 可讓您設定要重寫的特定html屬性。 服務可在Web主控台中設定，且具有 rewrite 節點： clientlibs, images 和 links.

AEM 5.5新增了此功能。

內容同步設定範例 example-content-sync-configuration

下列清單顯示「內容同步」的範例設定。

+ weretail_go [cq:ContentSyncConfig]
  - sling:resourceType = "contentsync/config"

  + etc.designs.default [nt:unstructured]
    - path = "/etc/designs/default"
    - type = "copy"

  + etc.designs.mobile [nt:unstructured]
    - path = "/etc/designs/mobile"
    - type = "copy"

  + events.plist [nt:unstructured]
    - path = "/content/weretail_mobile/en/events/jcr:content/par/events"
    - type = "content"
    - extension = "plist"

  + events.touch.html [nt:unstructured]
    - path = "/content/weretail_mobile/en/events"
    - type = "pages"
    - extension = "html"
    - selector = "touch"

  + logo [nt:unstructured]
    - path = "/etc/designs/mobile/jcr:content/mobilecontentpage/logo"
    - type = "logo"

  + manifest [nt:unstructured]
    - indexPage = "/content/weretail_mobile/en/events.touch.html"
    - metadataPlist = "/content/weretail_mobile/en/events/_jcr_content/par/events.plist"

  + ...

etc.designs.default和etc.designs.mobile 設定的前兩個項目應該相當明顯。 由於我們將包含許多行動頁面，因此需要/etc/designs下方的相關設計檔案。 由於不需要額外處理，複製就足夠了。

events.plist 這個項目有點特別。 如簡介所述，應用程式應提供具有事件位置標籤的地圖檢視。 我們將以PLIST格式的單獨檔案提供必要的位置資訊。 為了讓此功能發揮作用，索引頁上使用的事件清單元件有一個名為plist.jsp的指令碼。 當以.plist副檔名要求元件的資源時，就會執行此指令碼。 照常，元件路徑會在path屬性中指定，且類型會設為content，因為我們想要利用 Sling要求處理.

events.touch.html 接下來是應用程式中將顯示的實際頁面。 路徑屬性會設為事件的根頁面。 該頁面下方的所有事件頁面也會納入，因為深層屬性預設為true。 我們使用頁面作為配置類型，因此可能會從頁面上的影像或下載元件參照的任何影像或其他檔案都將包含在內。 此外，設定觸控選取器可提供行動版頁面。 Feature Pack中的設定包含更多這類項目，但此處僅供簡單使用。

標誌 目前尚未提及標誌組態類型，且並非任何內建類型。 不過，「內容同步」架構在某個程度上可擴充，此為範例，將於下一節中說明。

清單 Zip檔案中通常會包含某種中繼資料，例如內容的開始頁面。 但是，對此類資訊進行硬式編碼會使您以後無法輕鬆更改它。 內容同步架構可透過在設定中尋找資訊清單節點來支援此使用案例，此節點只需依名稱識別，不需要設定類型。 該特定節點上定義的每個屬性都會新增至檔案，該檔案也稱為manifest，且位於zip檔案的根目錄中。

在範例中，事件清單頁面應是初始頁面。 此資訊提供於 indexPage 因此，可以隨時容易地改變屬性。 第二個屬性定義 events.plist 檔案。 正如我們稍後將看到的，客戶端應用程式現在可以讀取清單並根據清單進行操作。

設定後，內容即可透過瀏覽器或任何其他HTTP用戶端下載，或如果您正在為iOS開發，則可使用專用的WAppKitSync用戶端程式庫。 下載位置由設定的路徑和 .zip 擴充功能，例如使用本機AEM例項時： http://localhost:4502/content/weretail_go.zip

內容同步主控台 the-content-sync-console

「內容同步」控制台列出儲存庫中的所有「內容同步」配置（所有類型節點） cq:ContentSyncConfig)和，並針對每個設定，可讓您執行下列動作：

這可供開發和疑難排解使用。

此主控台可從以下位置存取：

http://localhost:4502/libs/cq/contentsync/content/console.html

如下所示：

擴充內容同步架構 extending-the-content-sync-framework

雖然配置選項的數量已相當廣泛，但可能不涵蓋您的特定使用案例的所有要求。 本節說明內容同步架構的擴充功能點，以及如何建立自訂設定類型。

對於每種設定類型， 內容更新處理常式，此元件為針對該特定類型註冊的OSGi元件工廠。 這些處理常式會收集內容、處理內容，並將其新增至由內容同步架構維護的快取。 實現以下介面或抽象基類：

將類註冊為OSGi元件工廠，並將其部署在OSGi容器中，並成套。 您可以使用 Maven SCR插件 使用JavaDoc標籤或注釋。 以下範例顯示JavaDoc版本：

/*
 * @scr.component metatype="no"
 * factory="com.day.cq.contentsync.handler.ContentUpdateHandler/customtype"
 */
public class CustomTypeUpdateHandler implements ContentUpdateHandler {
    // add your code here
}

/*
 * @scr.component metatype="no" inherit="true"
 * factory="com.day.cq.contentsync.handler.ContentUpdateHandler/othertype"
 */
public class OtherTypeUpdateHandler extends AbstractSlingResourceUpdateHandler {
    // add your code here
}

請注意， 工廠 定義包含通用介面和以斜線分隔的自訂類型。 此策略使內容同步框架能夠查找和建立自定義類的實例，因為它可識別配置項中的自定義類型。 下一節提供自訂更新處理常式的具體範例。

實作自訂更新處理常式 implementing-a-custom-update-handler

當然，每個We.Retail Mobile頁面的左上角都會包含我們要加入zip檔案的標誌。 不過，為了快取最佳化，AEM不會參考影像檔案在存放庫中的實際位置，因此無法簡單使用 副本 組態類型。 我們需要做的是提供我們自己的 標誌 讓影像可在AEM要求的位置使用的設定類型。 下列程式碼清單顯示標誌更新處理常式的完整實施：

LogoUpdateHandler.java logoupdatehandler-java

package com.day.cq.wcm.apps.weretail.impl;

import javax.jcr.Node;
import javax.jcr.RepositoryException;
import javax.jcr.Session;

import org.apache.sling.api.resource.Resource;
import org.apache.sling.api.resource.ResourceResolver;
import org.apache.sling.jcr.resource.JcrResourceResolverFactory;

import com.day.cq.commons.jcr.JcrUtil;
import com.day.cq.contentsync.config.ConfigEntry;
import com.day.cq.contentsync.handler.ContentUpdateHandler;
import com.day.cq.wcm.foundation.Image;
import com.day.text.Text;

/**
 * The <code>LogoUpdateHandler</code> is used to update the content sync cache
 * with a page logo added using a logo component.
 *
 * @scr.component metatype="no"
 * factory="com.day.cq.contentsync.handler.ContentUpdateHandler/logo"
 */
public class LogoUpdateHandler implements ContentUpdateHandler {

    private static final Logger log = LoggerFactory.getLogger(LogoUpdateHandler.class);

    /** @scr.reference policy="static" */
    protected JcrResourceResolverFactory resolverFactory;

    public boolean updateCacheEntry(ConfigEntry configEntry, Long lastUpdated, String configCacheRoot, Session admin, Session session) {
        ResourceResolver resolver = resolverFactory.getResourceResolver(admin);
        Resource resource = resolver.getResource(configEntry.getContentPath());

        Image img = new Image(resource);
        img.setItemName(Image.NN_FILE, "image");
        img.setItemName(Image.PN_REFERENCE, "imageReference");
        img.setSelector("img");

        try {
            if(img.getLastModified() == null || lastUpdated < img.getLastModified().getTime().getTime()) {
                String src = img.getSrc();
                String parentPath = configCacheRoot + Text.getRelativeParent(src, 1);

                Node parent = JcrUtil.createPath(parentPath, "sling:Folder", admin);
                Node image = resolver.getResource(resource.getPath() + "/image").adaptTo(Node.class);
                JcrUtil.copy(image, parent, Text.getName(src));

                admin.save();

                return true;
            }
        } catch (RepositoryException e) {
            log.error("Unexpected error while updating logo: ", e);
        }

        return false;
    }
}

此 LogoUpdateHandler 類實施 ContentUpdateHandler 介面 updateCacheEntry(ConfigEntry, Long, String, Session, Session) 方法，此方法會使用多個引數：

若要實作自訂處理常式，請先根據設定項目中提供的資源，建立Image類別的例項。 這基本上和我們頁面上實際的標誌元件所執行的程式相同。 它可確保影像的目標路徑與從頁面參照的路徑相同。

接下來，檢查自上次更新後是否修改了資源。 自訂實作應避免不必要的快取更新，若無任何變更，則傳回false。 如果已修改資源，請將影像複製到快取根的預期目標位置。 最後， true 會傳回以指出快取已更新的架構。

在用戶端上使用內容 using-the-content-on-the-client

若要使用內容同步提供的行動應用程式中的內容，您需透過HTTP或HTTPS連線要求內容。 因此，擷取的內容（封裝在ZIP檔案中）可以擷取，並儲存在行動裝置上本機。 請注意，內容不僅指資料，也指邏輯，即完整的Web應用程式；由此，即使沒有網路連接，移動用戶也能夠執行檢索到的web應用程式和相應的資料。

「內容同步」以智慧方式提供內容：只傳送自上次成功資料同步以來的資料變更，因此減少資料傳輸所需的時間。 自1970年1月1日以來，在首次運行應用程式時，請求更改資料，隨後只請求自上次成功同步以來更改的資料。 AEM利用iOS的用戶端通訊架構來簡化資料通訊和傳輸，以便啟用iOS型網頁應用程式時需要最少量的原生程式碼。

所有傳輸的資料都可以提取到相同的目錄結構中，在提取資料時不需要其他步驟（例如依賴性檢查）。 若是iOS，所有資料都儲存在iOS應用程式的「檔案」資料夾內的子資料夾中。

以iOS為基礎的AEM Mobile應用程式的一般執行路徑：

如果無法建立連線，則會顯示先前下載的資料。

其他資源 additional-resources

若要了解管理員和作者的角色和責任，請參閱下列資源：