콘텐츠 동기화가 있는 모바일 mobile-with-content-sync

CAUTION
AEM 6.4가 확장 지원이 종료되었으며 이 설명서는 더 이상 업데이트되지 않습니다. 자세한 내용은 기술 지원 기간. 지원되는 버전 찾기 여기.
NOTE
단일 페이지 애플리케이션 프레임워크 기반 클라이언트측 렌더링(예: React)이 필요한 프로젝트에 SPA 편집기를 사용하는 것이 좋습니다. 자세히 알아보기.

기본 모바일 애플리케이션에서 사용할 수 있도록 컨텐츠 동기화를 사용하여 컨텐츠를 패키지화합니다. 장치가 오프라인 상태인 경우에도 AEM에서 작성된 페이지를 앱 콘텐츠로 사용할 수 있습니다. 또한 AEM 페이지는 웹 표준을 기반으로 하므로 모든 기본 래퍼에 포함할 수 있도록 교차 플랫폼 작동합니다. 이 전략은 개발 노력을 줄이고 앱 컨텐츠를 쉽게 업데이트할 수 있도록 합니다.

Content Sync 프레임워크는 웹 컨텐츠를 포함하는 아카이브 파일을 만듭니다. 컨텐츠는 간단한 페이지, 이미지, PDF 파일 또는 전체 웹 응용 프로그램에서 임의의 것일 수 있습니다. Content Sync API를 사용하면 모바일 앱 또는 빌드 프로세스에서 아카이브 파일에 액세스할 수 있으므로 컨텐츠를 검색하고 앱에 포함할 수 있습니다.

다음 단계 시퀀스는 컨텐츠 동기화에 대한 일반적인 사용 사례를 보여줍니다.

  1. AEM 개발자는 포함할 콘텐츠를 지정하는 컨텐츠 동기화 구성을 만듭니다.
  2. 컨텐츠 동기화 프레임워크에서 컨텐츠를 수집하고 캐시합니다.
  3. 모바일 장치에서 모바일 애플리케이션이 시작되고 ZIP 파일로 전달되는 서버의 콘텐츠를 요청합니다.
  4. 클라이언트가 ZIP 컨텐츠를 로컬 파일 시스템에 압축 해제합니다. ZIP 파일의 폴더 구조는 클라이언트(예: 브라우저)가 일반적으로 서버에서 요청하는 경로를 시뮬레이션합니다.
  5. 클라이언트는 포함된 브라우저에서 컨텐츠를 열거나 다른 방식으로 사용합니다.
  6. 나중에 클라이언트가 서버에서 업데이트된 컨텐츠를 요청합니다. Content Sync 프레임워크는 점진적 업데이트를 제공하여 다운로드 크기 및 시간을 줄이며, 대역폭 또는 데이터 볼륨이 제한되어 있으므로 모바일 장치에 중요할 수 있습니다.

콘텐츠 동기화 처리기 개발 developing-the-content-sync-handlers

컨텐츠 동기화 핸들러 개발에 대한 지침 중 일부는 다음과 같습니다.

  • 핸들러는 구현해야 합니다. com.day.cq.contentsync.handler.ContentUpdateHandler ( 작업을 수행하는 클래스를 직접 또는 확장하는 방법)
  • 핸들러가 확장할 수 있습니다. com.adobe.cq.mobile.platform.impl.contentsync.handler.AbstractSlingResourceUpdateHandler
  • ContentSync 캐시를 업데이트하는 경우에만 처리기가 true를 보고해야 합니다. 거짓 보고 true로 설정되면 실제로 업데이트가 발생하지 않은 경우 AEM에서 업데이트를 만듭니다.
  • 처리기는 컨텐츠가 실제로 변경된 경우에만 캐시를 업데이트해야 합니다. 흰색이 필요하지 않으면 캐시에 쓰지 마십시오. 이로 인해 불필요한 업데이트가 만들어집니다.
NOTE
활성화 ContentSync 디버그 로깅 패키지에서 OSGI 로거 구성을 통해 com.day.cq.contentsync. 이를 통해 실행된 핸들러와 캐시를 업데이트하고 캐시 업데이트를 보고했는지 여부를 추적할 수 있습니다.

컨텐츠 동기화 컨텐츠 구성 configuring-the-content-sync-content

클라이언트에 전달되는 ZIP 파일의 컨텐츠를 지정하려면 컨텐츠 동기화 구성을 만드십시오. 임의의 수의 컨텐츠 동기화 구성을 만들 수 있습니다. 각 구성에는 식별을 위한 이름이 있습니다.

컨텐츠 동기화 구성을 만들려면 cq:ContentSyncConfig 노드에 대한 노드, 및 sling:resourceType 속성 설정 contentsync/config. 다음 cq:ContentSyncConfig 노드는 저장소의 어느 곳에서든 찾을 수 있지만 AEM 게시 인스턴스의 사용자가 노드에 액세스할 수 있어야 합니다. 따라서 아래에 노드를 추가해야 합니다 /content.

컨텐츠 동기화 ZIP 파일의 컨텐츠를 지정하려면 cq:ContentSyncConfig 노드에 하위 노드를 추가합니다. 각 하위 노드의 다음 속성은 포함할 컨텐츠 항목과 추가 시 처리되는 방식을 식별합니다.

  • path: 컨텐츠의 위치.
  • type: 컨텐츠 처리에 사용할 구성 유형의 이름입니다. 섹션에서 몇 가지 유형을 사용할 수 있습니다 구성 유형.

자세한 내용은 컨텐츠 동기화 구성 예 추가 정보.

컨텐츠 동기화 구성을 만들면 컨텐츠 동기화 콘솔에 표시됩니다.

NOTE
Content Sync 프레임워크는 자산 및 디자인 관련 파일의 종속성이 Content Sync 패키지에 포함되어 있는지 확인하지 않습니다. ZIP 파일에 모든 필수 파일을 포함해야 합니다.

컨텐츠 동기화 다운로드에 대한 액세스 구성 configuring-access-to-content-sync-downloads

콘텐츠 동기화에서 다운로드할 수 있는 사용자 또는 그룹을 지정합니다. 모든 컨텐츠 동기화 캐시에서 다운로드할 수 있는 기본 사용자 또는 그룹을 구성하고 기본값을 재정의하고 특정 컨텐츠 동기화 구성에 대한 액세스를 구성할 수 있습니다.

AEM이 설치되면 기본적으로 관리자 그룹의 구성원이 컨텐츠 동기화에서 다운로드할 수 있습니다.

컨텐츠 동기화 다운로드에 대한 기본 액세스 설정 setting-the-default-access-for-content-sync-downloads

Day CQ Content Sync Manager 서비스는 컨텐츠 동기화에 대한 액세스를 제어합니다. 기본적으로 콘텐츠 동기화에서 다운로드할 수 있는 사용자 또는 그룹을 지정하도록 이 서비스를 구성합니다.

만약 웹 콘솔을 사용하여 서비스 구성를 채울 수 있는 대체 캐시 속성의 값으로 사용자 또는 그룹의 이름을 입력합니다.

만약 저장소에서 구성를 채울 때는 서비스에 대해 다음 정보를 사용하십시오.

  • PID: com.day.cq.contentsync.impl.ContentSyncManagerImpl
  • 속성 이름: contentsync.fallback.authorizable

컨텐츠 동기화 캐시에 대한 다운로드 액세스 재정의 overriding-download-access-for-a-content-sync-cache

특정 컨텐츠 동기화 구성에 대한 다운로드 액세스를 구성하려면 다음 속성을 cq:ContentSyncConfig 노드:

  • 이름: 작성 가능
  • 유형: 문자열
  • 값: 다운로드할 수 있는 사용자 또는 그룹의 이름입니다.

예를 들어 앱을 사용하면 사용자가 콘텐츠 동기화에서 직접 업데이트를 설치할 수 있습니다. 모든 사용자가 업데이트를 다운로드할 수 있도록 하려면 승인 가능한 속성의 값을 로 설정합니다 everyone.

만약 cq:ContentSyncConfig 노드에 승인 가능한 속성이 없습니다. CQ Content Sync Manager 서비스의 대체 캐시 승인 가능 속성에 대해 구성된 기본 사용자 또는 그룹이 다운로드할 수 있는 속성을 결정합니다.

콘텐츠 동기화 캐시 업데이트를 위한 사용자 구성 configuring-the-user-for-updating-a-content-sync-cache

사용자가 컨텐츠 동기화 캐시에 대한 업데이트를 수행할 때 특정 사용자 계정은 사용자를 대신하여 작업을 수행합니다. 익명 사용자는 기본적으로 모든 콘텐츠 동기화 캐시를 업데이트합니다.

기본 사용자를 재정의하고 특정 콘텐츠 동기화 캐시를 업데이트하는 사용자 또는 그룹을 지정할 수 있습니다.

기본 사용자를 무시하려면 cq:ContentSyncConfig 노드에 다음 속성을 추가하여 특정 컨텐츠 동기화 구성에 대한 업데이트를 수행하는 사용자 또는 그룹을 지정합니다.

  • 이름: updateuser
  • 유형: String
  • 값: 업데이트를 수행할 수 있는 사용자 또는 그룹의 이름입니다.

만약 cq:ContentSyncConfig 노드 없음 updateuser 속성, 기본값 anonymous 사용자가 캐시를 업데이트합니다.

구성 유형 configuration-types

처리 범위는 간단한 JSON 렌더링에서 참조된 자산을 포함한 페이지의 본격적인 렌더링에 이르기까지 다양할 수 있습니다. 이 섹션에는 사용 가능한 구성 유형 및 특정 매개 변수가 나와 있습니다.

복사 파일과 폴더를 복사하면 됩니다.

  • 경로 - 경로가 단일 파일을 가리키면 파일만 복사됩니다. 폴더(페이지 노드 포함)를 가리키면 아래의 모든 파일과 폴더가 복사됩니다.

콘텐츠 표준을 사용하여 컨텐츠 렌더링 Sling 요청 처리.

  • 경로 - 출력해야 하는 리소스의 경로입니다.

  • 확장 - 요청에 사용해야 하는 확장. 일반적인 예는 다음과 같습니다 htmljson ​하지만 다른 모든 확장은 가능합니다.

  • 선택기 - 점으로 구분된 선택적 선택기. 일반적인 예는 다음과 같습니다 터치 페이지의 모바일 버전 또는 무한대 JSON 출력용.

clientlib Javascript 또는 CSS 클라이언트 라이브러리를 패키징합니다.

  • 경로 - 클라이언트 라이브러리의 루트에 대한 경로입니다.
  • 확장 - 클라이언트 라이브러리 유형입니다. 다음 중 하나로 설정해야 합니다. js 또는 css 지금 당장

assets

자산의 원래 표현물을 수집합니다.

  • 경로 - /content/dam 아래에 있는 자산 폴더의 경로입니다.

이미지 이미지를 수집합니다.

  • 경로 - 이미지 리소스의 경로입니다.

이미지 유형은 zip 파일에 We Retail 로고를 포함하는 데 사용됩니다.

페이지 AEM 페이지를 렌더링하고 참조된 자산을 수집합니다.

  • 경로 - 페이지 경로.

  • 확장 - 요청에 사용해야 하는 확장. 페이지의 경우 거의 항상 html ​하지만 다른 것들은 여전히 가능합니다.

  • 선택기 - 점으로 구분된 선택적 선택기. 일반적인 예는 다음과 같습니다 터치 페이지의 모바일 버전을 렌더링하는 데 사용됩니다.

  • 깊은 곳 - 하위 페이지를 포함해야 하는지 여부를 결정하는 선택적 부울 속성도 있습니다. 기본값은 입니다. true입니다.

  • includeImages - 이미지를 포함해야 하는지 여부를 결정하는 선택적 부울 속성입니다. 기본값은 입니다. true.

    기본적으로 리소스 유형이 foundation/components/image인 이미지 구성 요소만 포함으로 간주됩니다. 을(를) 구성하여 리소스 유형을 더 추가할 수 있습니다 일 CQ WCM 페이지 업데이트 처리기 클릭합니다.

rewrite 다시 작성 노드는 내보낸 페이지에서 링크를 다시 작성하는 방법을 정의합니다. 다시 작성된 링크는 zip 파일에 포함된 파일 또는 서버의 리소스를 가리킬 수 있습니다.

다음 rewrite 노드는 아래의 위치에 있어야 합니다. page 노드 아래에 있어야 합니다.

다음 rewrite 노드에는 다음 속성 중 하나 이상이 있을 수 있습니다.

  • clientlibs: clientlibs 경로를 다시 기록합니다.

  • images: 이미지 경로를 다시 씁니다.

  • links: 링크 경로를 다시 기록합니다.

각 속성에는 다음 값 중 하나를 사용할 수 있습니다.

  • REWRITE_RELATIVE: 파일 시스템의 page.html 파일에 대한 상대 위치로 경로를 다시 씁니다.

  • REWRITE_EXTERNAL: AEM을 사용하여 서버의 리소스를 가리키면 경로를 다시 기록합니다. 외부 도우미 서비스.

AEM 서비스가 PathRewriterTransformerFactory 다시 작성할 특정 html 속성을 구성할 수 있습니다. 이 서비스는 웹 콘솔에서 구성할 수 있으며 rewrite 노드: clientlibs, imageslinks.

이 기능은 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 확장명을 사용하여 요청될 때 실행됩니다. 평소대로 구성 요소 경로가 경로 속성에 지정되고 유형이 컨텐츠로 설정되는 이유는 활용할 수 있기 때문입니다 Sling 요청 처리.

events.touch.html 다음은 앱에 표시되는 실제 페이지입니다. 경로 속성이 이벤트의 루트 페이지로 설정됩니다. 딥 속성의 기본값은 true이므로 해당 페이지 아래의 모든 이벤트 페이지도 포함됩니다. 페이지를 구성 유형으로 사용하므로 이미지나 페이지의 다운로드 구성 요소에서 참조될 수 있는 모든 이미지 또는 기타 파일이 포함됩니다. 또한 터치 선택기를 설정하면 모바일 버전의 페이지가 제공됩니다. 기능 팩의 구성에는 이러한 유형의 항목이 더 포함되어 있지만 여기서는 간단히 볼 수 있습니다.

로고 지금까지 로고 구성 유형에 대해 언급되지 않았고 기본 제공 유형이 아닙니다. 그러나 Content Sync 프레임워크는 어느 정도 확장 가능하며, 그 예는 다음 섹션에서 다룹니다.

매니페스트 예를 들어 컨텐츠의 시작 페이지처럼 zip 파일에 어떤 종류의 메타데이터를 포함하는 것이 바람직합니다. 그러나 이러한 정보를 하드코딩하면 나중에 쉽게 변경할 수 없습니다. Content Sync 프레임워크는 이름으로 단순히 식별되며 구성 유형이 필요하지 않은 구성에서 매니페스트 노드를 찾아 이 사용 사례를 지원합니다. 특정 노드에 정의된 모든 속성이 파일에 추가됩니다. 이 파일은 매니페스트라고도 하며 zip 파일의 루트에 있습니다.

이 예에서 이벤트 목록 페이지는 초기 페이지여야 합니다. 이 정보는 indexPage 따라서 언제든지 쉽게 변경할 수 있습니다. 두 번째 속성은 events.plist 파일. 나중에 볼 수 있듯이 클라이언트 애플리케이션은 이제 매니페스트를 읽고 그에 따라 작업할 수 있습니다.

구성이 설정되면 바로 컨텐츠를 브라우저 또는 다른 HTTP 클라이언트로 다운로드할 수 있고 iOS용으로 개발하는 경우에는 전용 WAppKitSync 클라이언트 라이브러리를 사용할 수 있습니다. 다운로드 위치는 구성의 경로 및 .zip 확장(예: 로컬 AEM 인스턴스 작업 시) http://localhost:4502/content/weretail_go.zip

컨텐츠 동기화 콘솔 the-content-sync-console

컨텐츠 동기화 콘솔에는 저장소의 모든 컨텐츠 동기화 구성(유형의 모든 노드)이 나열됩니다 cq:ContentSyncConfig) 및 를 사용하여 각 구성에 대해 다음을 수행할 수 있습니다.

  • 캐시를 업데이트합니다.
  • 캐시를 지웁니다.
  • 전체 zip을 다운로드합니다.
  • 현재 및 특정 날짜 및 시간 사이의 diff zip을 다운로드하십시오.

개발 및 문제 해결에 유용할 수 있습니다.

콘솔에서 액세스할 수 있는 위치:

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

다음과 같습니다.

chlimage_1-50

콘텐츠 동기화 프레임워크 확장 extending-the-content-sync-framework

구성 옵션 수는 이미 매우 광범위하지만 특정 사용 사례의 모든 요구 사항을 포함하지는 않을 수 있습니다. 이 섹션에서는 컨텐츠 동기화 프레임워크의 확장 지점을 설명하고 사용자 지정 구성 유형을 만드는 방법을 설명합니다.

각 구성 유형에 대해 콘텐츠 업데이트 처리기: 특정 유형에 대해 등록된 OSGi 구성 요소 팩터리입니다. 이러한 핸들러는 컨텐츠를 수집하고 처리하고 Content Sync 프레임워크에서 유지 관리하는 캐시에 추가합니다. 다음 인터페이스 또는 추상 기본 클래스를 구현합니다.

  • com.day.cq.contentsync.handler.ContentUpdateHandler - 모든 업데이트 핸들러가 구현해야 하는 인터페이스
  • com.day.cq.contentsync.handler.AbstractSlingResourceUpdateHandler - Sling을 사용하여 리소스를 렌더링하는 추상 클래스입니다

클래스를 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
}

다음 사항에 주의하십시오. 공장 정의에는 공통 인터페이스와 사용자 지정 유형이 슬래시로 구분됩니다. 이 전략을 사용하면 Content Sync 프레임워크에서 구성 항목에서 사용자 지정 유형을 인식하므로 사용자 지정 클래스의 인스턴스를 찾고 만들 수 있습니다. 다음 섹션에서는 사용자 지정 업데이트 처리기의 구체적인 예를 제공합니다.

CAUTION
AbstractSlingResourceUpdateHandler 기본 클래스를 기반으로 빌드할 때는 상속 정의. 그렇지 않으면 OSGi 컨테이너가 기본 클래스에서 선언되는 필수 참조를 설정하지 않습니다.

사용자 지정 업데이트 처리기 구현 implementing-a-custom-update-handler

모든 We.Retail 모바일 페이지에는 물론 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) 메서드에서 많은 인수를 사용합니다.

  • A ConfigEntry 구성 항목에 대한 액세스 권한을 제공하는 인스턴스로, 이 처리기가 호출되는 인스턴스와 해당 속성을 포함합니다.
  • A lastUpdated 콘텐츠 동기화가 캐시를 마지막으로 업데이트한 시간을 나타내는 타임스탬프입니다. 해당 타임스탬프 이후에 수정되지 않은 콘텐츠는 처리기에서 업데이트해서는 안 됩니다.
  • A configCacheRoot 캐시의 루트 경로를 지정하는 인수입니다. 업데이트된 모든 파일은 이 경로 아래에 저장되어 zip 파일에 추가해야 합니다.
  • 모든 캐시 관련 저장소 작업에 사용해야 하는 관리 세션입니다.
  • 특정 사용자의 컨텍스트에서 콘텐츠를 업데이트하여 개인화된 콘텐츠의 종류를 제공하는 데 사용할 수 있는 사용자 세션입니다.

사용자 지정 핸들러를 구현하려면 먼저 구성 항목에 제공된 리소스를 기반으로 Image 클래스의 인스턴스를 만듭니다. 이것은 기본적으로 페이지에서 실제 로고 구성 요소가 수행하는 것과 동일한 절차입니다. 이미지의 대상 경로가 페이지에서 참조한 경로와 동일한지 확인합니다.

그런 다음 마지막 업데이트 이후 리소스가 수정되었는지 확인합니다. 사용자 지정 구현은 캐시의 불필요한 업데이트를 방지하고, 아무 것도 변경되지 않는 경우 false를 반환해야 합니다. 리소스를 수정한 경우 캐시 루트에 상대적인 예상 대상 위치에 이미지를 복사합니다. 마지막으로 true 캐시가 업데이트되었음을 나타내는 가 프레임워크에 반환됩니다.

클라이언트에서 컨텐츠 사용 using-the-content-on-the-client

컨텐츠 동기화에서 제공하는 모바일 앱에서 컨텐츠를 사용하려면 HTTP 또는 HTTPS 연결을 통해 콘텐츠를 요청해야 합니다. 그 결과, 검색된 컨텐츠(ZIP 파일로 압축됨)는 모바일 장치에서 추출하여 로컬로 저장할 수 있습니다. 컨텐츠는 데이터뿐만 아니라 논리적, 즉 전체 웹 애플리케이션을 나타냅니다. 따라서 모바일 사용자는 네트워크 연결 없이도 검색된 웹 응용 프로그램과 해당 데이터를 실행할 수 있습니다.

컨텐츠 동기화는 지능적인 방식으로 컨텐츠를 전달합니다. 마지막으로 성공한 데이터 동기화 이후의 데이터 변경 사항만 전달되므로 데이터 전송에 필요한 시간이 줄어듭니다. 애플리케이션 데이터 변경 작업은 1970년 1월 1일 이후 처음 실행될 때 요청되며, 이후에 마지막으로 성공한 동기화 이후 변경된 데이터만 요청됩니다. AEM은 iOS용 클라이언트 통신 프레임워크를 사용하여 데이터 통신을 단순화하고 전송하므로 iOS 기반 웹 애플리케이션을 활성화하는 데 최소한의 기본 코드가 필요합니다.

전송된 모든 데이터는 동일한 디렉토리 구조로 추출할 수 있으며, 데이터를 추출할 때 추가 단계(예: 종속성 검사)가 필요하지 않습니다. iOS의 경우 모든 데이터는 iOS 앱의 Documents 폴더 내의 하위 폴더에 저장됩니다.

iOS 기반 AEM Mobile 앱의 일반적인 실행 경로:

  • 사용자가 iOS 장치에서 앱을 시작합니다.
  • 앱이 AEM 백엔드에 연결하려고 시도하고 마지막 실행 이후 데이터 변경을 요청합니다.
  • 서버는 문제의 데이터를 검색하고 파일로 압축합니다.
  • 데이터는 문서 폴더로 추출되는 클라이언트 장치로 반환됩니다.
  • UIWebView 구성 요소 시작/새로 고침.

이전에 다운로드한 데이터에 연결할 수 없는 경우 이 메시지가 표시됩니다.

추가 리소스 additional-resources

관리자 및 작성자의 역할과 책임에 대해 알아보려면 아래 리소스를 참조하십시오.

recommendation-more-help
547b817b-14b5-4d82-aa0f-a64750e0e592