앱 구조

마지막 업데이트: 2023-05-04
  • 주제:
  • Mobile
    이 항목에 대한 자세한 내용 보기
  • 작성 대상:
  • User
주의

AEM 6.4가 확장 지원이 종료되었으며 이 설명서는 더 이상 업데이트되지 않습니다. 자세한 내용은 기술 지원 기간. 지원되는 버전 찾기 여기.

노트

단일 페이지 애플리케이션 프레임워크 기반 클라이언트측 렌더링(예: React)이 필요한 프로젝트에 SPA 편집기를 사용하는 것이 좋습니다. 자세히 알아보기.

AEM Mobile 프로젝트에는 페이지, JavaScript 및 CSS 클라이언트 라이브러리, 재사용 가능한 AEM 구성 요소, 컨텐츠 동기화 구성 및 PhoneGap 앱 셸 컨텐츠를 포함한 다양한 컨텐츠 유형 세트가 포함되어 있습니다. 새 AEM Mobile 앱의 기반이 되는 시작 키트 는 장기적으로 휴대성과 유지 관리를 간소화하기 위해 다양한 유형의 모든 컨텐츠를 Adobe의 권장 구조에 가져오는 좋은 방법입니다.

페이지 컨텐츠

AEM Mobile 콘솔에서 응용 프로그램을 인식하려면 응용 프로그램의 모든 페이지가 /content/mobileapps 아래에 있어야 합니다.

chlimage_1-52

AEM 규칙을 통해 앱의 첫 번째 페이지는 앱의 기본 언어(Geometrixx 및 시작 키트 케이스 둘 다에서 'en')로 사용되는 1차 하위 구성요소로 리디렉션되어야 합니다. 최상위 로케일 페이지는 일반적으로 기본 'splash-page' 구성 요소(/libs/mobileapps/components/splash-page?lang=ko)에서 상속되며, 이 구성 요소는 과도한 Content Sync 업데이트(contentInit 코드는 /etc/clientlibs/mobile/content-sync/js/contentInit.js)의 설치를 지원하는 데 필요한 초기화를 처리합니다.

템플릿 및 구성 요소

앱에 대한 템플릿 및 구성 요소 코드는 /apps/에 있어야 합니다.<brand name="">/<app name="">. 규칙에 따라 /apps/에 템플릿 및 구성 요소 코드를 배치해야 합니다.<brand name="">/<app name="">. 이 패턴은 AEM에서 사이트에서 이미 작업한 개발자에게 익숙해야 합니다. 게시 인스턴스에서 기본적으로 /apps/ 가 익명 액세스를 위해 잠기면 일반적으로 그 뒤에 옵니다. 따라서 원시 JSP 코드가 잠재적인 공격자들로부터 숨겨집니다.

앱별 템플릿은 allowedPaths 템플릿 자체의 속성 노드 및 해당 값을 '/content/mobileapps(/)로 설정합니다.*)?' - 또는 템플릿을 단일 앱에만 사용할 수 있어야 하는 경우 더 구체적인 항목을 사용할 수 있습니다. 다음 allowedParentsallowedChildren 속성을 활용하여 새 페이지를 만드는 위치를 기반으로 작성자가 사용할 수 있는 템플릿을 매우 세밀하게 제어할 수도 있습니다.

처음부터 새 앱 페이지 구성 요소를 만들 때는 sling:resourceSuperType 속성을 'mobileapps/components/angular/ng-page'에 추가합니다. 페이지를 단일 페이지 앱으로 작성 및 렌더링할 수 있도록 설정하고, 구성 요소를 변경해야 할 수 있는 모든 .jsp 파일을 오버레이할 수 있습니다. ng-page에는 UI 프레임워크가 전혀 포함되지 않으므로 개발자는 일반적으로 'template.jsp'(/libs/mobileapps/components/angular/ng-page/template.jsp%EC%97%90%EC%84%9C%20%EC%98%A4%EB%B2%84%EB%A0%88%EC%9D%B4%EB%90%A8?lang=ko)를 오버레이합니다.

AngularJS를 활용하려는 작성 가능한 페이지 구성 요소는 다음과 같습니다 sling:resourceSuperType 같은 방식으로 오버레이하고 사용자 지정할 수 있는 /libs/mobileapps/components/angular/ng-component에 있는 구성 요소입니다.

JavaScript 및 CSS Clientlibs

클라이언트 라이브러리와 관련하여 개발자가 저장소에 배치할 수 있는 몇 가지 옵션이 있습니다. 다음 패턴은 지침을 위해 제공되지만, 어려운 요구 사항은 아닙니다.

클라이언트측 코드가 자체적으로 설 수 있고 애플리케이션의 특정 구성 요소와 관련이 없는 경우(즉, 다른 애플리케이션에서 재사용할 수 있는 경우) /etc/clientlibs/에 저장하는 것이 좋습니다<brand name="">/<lib name="">. 반면 clientlib이 단일 앱에만 해당하는 경우 앱 디자인 노드의 하위로 중첩할 수 있습니다. /etc/designs/phonegap/<brand name="">/<app name="">/clientlibs 이 clientlib의 카테고리는 다른 libs에서 사용할 수 없으며 필요에 따라 다른 libs를 포함하는 데 사용해야 합니다. 이 패턴을 수행하면 개발자가 클라이언트 라이브러리가 앱에 추가될 때마다 새 컨텐츠 동기화 구성을 추가할 필요가 없고 앱 디자인 clientlib의 'embed' 속성을 업데이트하기만 하면 됩니다. 예를 들어, /content/phonegap/geometrixx-outdoors/en/jcr:content/page-app/app-config/clientlibs-all에서 clientlibs-all Content Sync 구성 노드를 살펴봅니다.

클라이언트 측 코드가 특정 구성 요소와 밀접하게 연결된 경우 해당 코드를 /apps/의 구성 요소 위치 아래에 중첩된 클라이언트 라이브러리에 배치하고 이 코드를 앱의 'design' clientlib에 포함하십시오.

PhoneGap 구성

각 AEM Mobile 앱에는 PhoneGap에서 사용하는 구성 파일을 호스팅하는 디렉토리가 있습니다 명령줄 인터페이스PhoneGap 빌드 웹 컨텐츠를 실행 가능한 응용 프로그램으로 변환하는 중입니다. 예를 들어 Geometrixx 샘플에서 이 디렉토리(/content/phonegap/geometrixx-outdoors/shell/jcr:content/page-app/app-content?lang=ko)는 Shell의 일부로 위치합니다. 장치 API를 처리하는 플러그인 및 앱 자체의 구성과 같이, 공중에 떠서 업데이트할 수 없는 콘텐츠만 포함된다는 사실로 인해 디자인이 결정했습니다.

이 디렉토리에는 Cordova 후크 플러그인을 설치하고, 리소스 파일을 해당 플랫폼별 위치에 배치하고, 빌드의 일부로 실행해야 하는 기타 작업에 사용할 수 있습니다. 참고: 각 플러그인을 빌드의 일부로 다운로드하는 대신 Kitchen Sink 앱의 패턴을 따라 플러그인 소스 코드 포함 를 사용하십시오.

다음 단계

앱의 구조에 대해 알려면 다음을 참조하십시오 앱 콘솔을 사용하여 앱 만들기 및 편집.

이 페이지에서는