為移動設備建立站點

建立行動網站與建立標準網站類似，因為它也涉及建立範本和元件。 如需建立範本和元件的詳細資訊，請參閱下列頁面：範本、元件和開發AEM Sites快速入門。 主要差異在於在網站內啟用AEM內建的行動功能。 這需透過建立仰賴行動頁面元件的範本來達成。

您也應考慮使用回應式設計，建立可容納多種螢幕大小的單一網站。

若要開始使用，您可以查看AEM中提供的​We.Retail行動示範網站。

若要建立行動網站，請繼續進行：

1. 建立頁面元件：

   • 將sling:resourceSuperType屬性設定為wcm/mobile/components/page

     如此一來，元件便需仰賴行動頁面元件。

   • 使用專案特定邏輯建立body.jsp。

2. 建立頁面範本：

   • 將sling:resourceType屬性設定為新建立的頁面元件。
   • 設定allowedPaths屬性。

3. 建立網站的設計頁面。

4. 在/content節點下建立站點根頁：

   • 設定cq:allowedTemplates屬性。
   • 設定cq:designPath屬性。

5. 在網站根頁面的頁面屬性中，在​Mobile​標籤中設定裝置群組。

6. 使用新範本建立網站頁面。

行動頁面元件(/libs/wcm/mobile/components/page):

• 將​Mobile​標籤新增至頁面屬性對話方塊。
• 透過其head.jsp，它會從請求中擷取目前的行動裝置群組，如果找到裝置群組，則會使用該群組的drawHead()方法，包含裝置群組的相關模擬器初始化元件（僅限於製作模式）和裝置群組的轉譯CSS。

使用多站點管理器建立移動站點

使用Multi Site Manager(MSM)從標準網站建立行動即時副本。 標準網站會自動轉換為行動網站：行動網站具有行動網站的所有功能（例如在模擬器內進行版本），並可與標準網站同步管理。 請參閱「多網站管理員」頁面中的「為不同管道建立即時副本」區段🔗。

伺服器端行動API

包含行動類別的Java套件包括：

• com.day.cq.wcm.mobile.api — 定義MobileConstants。

• com.day.cq.wcm.mobile.api.device — 定義裝置、DeviceGroup和DeviceGroupList。

• com.day.cq.wcm.mobile.api.device.capability — 定義DeviceCapability。

• com.day.cq.wcm.mobile.api.wurfl — 定義WurflQueryEngine。

• com.day.cq.wcm.mobile.core — 定義MobileUtil，其提供可繞WCM Mobile運作的各種公用程式方法。

行動元件

We.Retail行動示範網站​使用位於/libs/foundation/components下方的下列行動元件：

建立行動元件

AEM行動架構可開發對發出請求的裝置敏感的元件。 下列程式碼範例說明如何在元件jsp中使用AEM行動API，尤其是如何：

• 從請求中取得裝置：

  Device device = slingRequest.adaptTo(Device.class);

• 獲取設備組：

  DeviceGroup deviceGroup = device.getDeviceGroup();

• 獲取設備組功能：

  Collection<DeviceCapability> capabilities = deviceGroup.getCapabilities();

• 從WURFL資料庫獲取設備屬性（原始功能鍵/值）:

  Map<String,String> deviceAttributes = device.getAttributes();

• 獲取設備用戶代理：

  String userAgent = device.getUserAgent();

• 從目前頁面取得裝置群組清單（由作者指派給網站的裝置群組）:

  DeviceGroupList deviceGroupList = currentPage.adaptTo(DeviceGroupList.class);

• 檢查設備組是否支援映像

  if (deviceGroup.hasCapability(DeviceCapability.CAPABILITY_IMAGES)) {
  …
  或
  if MobileUtil.hasCapability(request, DeviceCapability.CAPABILITY_IMAGES) {
  …

模擬器

以模擬器為基礎的製作功能可讓作者建立適用於行動用戶端的內容頁面。 行動內容製作遵循就地WYSIWYG編輯的相同原則。 為了讓作者對行動裝置上的頁面外觀有感覺，使用裝置模擬器來編輯行動內容頁面。

行動裝置模擬器以一般模擬器架構為基礎。 有關更多詳細資訊，請參閱模擬器頁。

裝置模擬器會在頁面上顯示行動裝置，而通常的編輯（parsys、元件）則發生在裝置的畫面中。 設備模擬器取決於為站點配置的設備組。 可以為設備組分配多個模擬器。 然後，內容頁面上會提供所有模擬器。 預設情況下，將顯示分配給該站點的第一個設備組的第一個模擬器。 模擬器可透過頁面頂端的模擬器輪播或透過Sidekick的編輯按鈕進行切換。

建立模擬器

要建立模擬器，請參閱「通用模擬器」頁中的建立自定義移動模擬器部分。

移動模擬器的主要特性

• 設備組由以下多個模擬器之一組成：設備組配置頁，例如/etc/mobile/groups/touch，包含jcr:content節點下方的emulators屬性。

  注意：雖然同一模擬器可能屬於多個設備組，但這沒什麼意義。

• 通過設備組的配置對話框，使用所需模擬器的路徑設定emulators屬性。 例如：/libs/wcm/mobile/components/emulators/iPhone4。

• 模擬器元件(例如/libs/wcm/mobile/components/emulators/iPhone4)擴展基本移動模擬器元件(/libs/wcm/mobile/components/emulators/base)。

• 配置設備組時，可選擇擴展基本移動模擬器的每個元件。 因此，可輕鬆建立或擴展自定義模擬器。

• 在編輯模式下的請求時，模擬器實作會用於呈現頁面。

• 當頁面的範本仰賴行動頁面元件時，模擬器功能會自動整合至頁面（透過行動頁面元件的head.jsp）。

裝置群組

行動裝置群組會根據裝置功能提供行動裝置的分段。 裝置群組提供在製作執行個體上以模擬器為基礎製作以及在發佈執行個體上正確呈現內容所需的資訊：一旦作者將內容新增至行動頁面並發佈後，即可在發佈例項上請求頁面。 在那裡，內容頁面不是模擬器編輯視圖，而是使用其中一個配置的設備組呈現。 根據移動設備檢測進行設備組的選擇。 然後，相符的裝置群組會提供必要的樣式資訊。

裝置群組定義為/etc/mobile/devices下方的內容頁面，並使用​行動裝置群組​範本。 裝置群組範本可作為內容頁面形式之裝置群組定義的設定範本。 其主要特點是：

• 位置: /libs/wcm/mobile/templates/devicegroup
• 允許的路徑：/etc/mobile/groups/*
• 頁面元件：wcm/mobile/components/devicegroup

將設備組分配給您的站點

建立行動網站時，您需要將裝置群組指派給您的網站。 AEM會根據裝置的HTML和JavaScript轉譯功能，提供三個裝置群組：

• ​​功能電話，適用於功能裝置，例如支援基本HTML但不支援影像和JavaScript的Sony Ericsson W800。

• ​​智慧型手機，適用於支援基本HTML和影像的Blackberry等裝置，但不支援JavaScript。

• ​​觸控電話，適用於完全支援HTML、影像、JavaScript和裝置旋轉的iPad等裝置。

由於模擬器可以與設備組關聯（請參閱建立設備組部分），因此將設備組分配給站點使作者能夠在與設備組關聯的模擬器之間進行選擇，以編輯該頁。

若要將裝置群組指派給您的網站：

1. 在瀏覽器中，前往​Siteadmin​主控台。

2. 在​Websites​下方開啟行動網站的根頁面。

3. 開啟頁面屬性。

4. 選取​Mobile​標籤：

   • 定義裝置群組。
   • 按一下​「確定」。

裝置群組篩選器

設備組篩選器定義基於功能的標準，以確定設備是否屬於該組。 建立裝置群組時，您可以選取用於評估裝置的篩選器。

在AEM收到來自裝置的HTTP要求時，與群組相關聯的每個篩選器都會將裝置功能與特定條件進行比較。 當裝置具備篩選器所需的所有功能時，即視為屬於群組。 功能從WURFL™資料庫中檢索。

裝置群組可使用零個或多個篩選器來偵測功能。 此外，篩選器可與多個裝置群組搭配使用。 AEM提供預設篩選條件，可判斷裝置是否具備為群組選取的功能：

• CSS
• JPG和PNG影像
• JavaScript
• 裝置旋轉

如果設備組未使用篩選器，則為組配置的選定功能是設備所需的唯一功能。

有關詳細資訊，請參閱建立設備組篩選器。

建立設備組

當AEM安裝的群組不符合您的需求時，建立裝置群組。

1. 在瀏覽器中，前往​工具​主控台。

2. 在​工具 > 行動 > 裝置群組​下建立新頁面。 在​建立頁面​對話方塊中：

   • 作為​Title​輸入Special Phones。
   • 作為​名稱​輸入special。
   • 選取​行動裝置群組範本。
   • 按一下​建立。

3. 在CRXDE中，新增​static.css​檔案，其中包含/etc/mobile/groups/special節點下方裝置群組的樣式。

4. 開啟​特殊電話​頁。

5. 要配置設備組，請按一下​Settings​旁的​Edit​按鈕。

   在​一般​標籤上：

   • 標題:行動裝置群組的名稱。
   • 說明:群組的說明。
   • User-Agent:與裝置相符的使用者代理字串。此為選用項目，可以是規則運算式。 範例: BlackBerryZ10
   • 功能:定義群組是否可以處理影像、CSS、JavaScript或裝置旋轉。
   • 最小螢幕寬​度和高度
   • 禁用模擬器:在內容編輯期間啟用/停用模擬器。

   在​模擬器​頁簽上：

   • 模擬器:選擇分配給此設備組的模擬器。

   在​Filters​標籤上：

   • 若要新增篩選器，請按一下「新增項目」並從下拉式清單中選取篩選器。
   • 系統會依篩選器的顯示順序來評估篩選器。 當裝置不符合篩選器的條件時，系統不會評估清單上的後續篩選器。

6. 按一下「確定」。

行動裝置群組設定對話方塊的外觀如下：

每個設備組的自定義CSS

如前所述，可以將自定義CSS與設備組頁建立關聯，這與設計頁的CSS非常相似。此CSS用於影響設備組特定的頁面內容在作者和發佈時的呈現。然後，將自動包括此CSS:

• 在製作例項的頁面中，針對此裝置群組使用的每個模擬器。
• 在發佈例項的頁面中，如果請求的使用者代理與此特定裝置群組中的行動裝置相符，則顯示該請求。

伺服器端裝置偵測

使用篩選器和裝置規格庫，判斷執行HTTP要求的裝置功能。

開發設備組篩選器

建立設備組篩選器以定義一組設備功能需求。 建立您所需的篩選器，以鎖定所需的裝置功能群組。

設計您的篩選器，以便使用篩選器的組合來定義功能群組。 通常，不同裝置群組的功能會有重疊之處。 因此，您可能會對多個裝置群組定義使用某些篩選器。

建立篩選器後，即可在群組設定中使用它。

有關資訊，請轉至建立設備組篩選器。

使用WURFL™資料庫

AEM使用截斷版本的WURFL™資料庫，根據裝置的使用者代理查詢裝置功能，例如螢幕解析度或javascript支援。

通過解析/libs/wcm/mobile/devicespecs/wurfl.xml.處的wurfl.xml檔案，將WURFL™資料庫的XML代碼表示為/var/mobile/devicespecs下的節點。在cq-mobile-core捆綁包首次啟動時，將對節點進行擴展。

設備功能以節點屬性的形式儲存，節點表示設備型號。 您可以使用查詢來檢索設備或用戶代理的功能。

隨著WURFL™資料庫的不斷發展，您可能需要定制或替換它。 要更新移動設備資料庫，您有以下選項：

• 如果您有允許此用途的授權，請將檔案取代為最新版本。 請參閱安裝其他WURFL資料庫。
• 使用AEM中可用的版本，並設定符合您的使用者代理字串且指向現有WURFL™裝置的regexp。 請參閱新增以regexp為基礎的使用者代理比對。

測試User-Agent到WURFL™功能的映射

當裝置存取您的行動網站時，AEM會偵測到裝置，並根據其功能將其對應至裝置群組，並傳送與裝置群組對應之頁面檢視。 相符的裝置群組提供必要的樣式資訊。 可在「行動使用者代理測試」頁面上測試對應：

http://localhost:4502/etc/mobile/useragent-test.html

安裝不同的WURFL™資料庫

隨AEM安裝的截斷WURFL™資料庫是預先更新的版本
2011年8月30日。 如果您的WURFL版本在2011年8月30日之後發行，請確保您的使用符合您的許可證。

安裝WURFL™資料庫：

1. 在CRXDE Lite中，建立下列資料夾：/apps/wcm/mobile/devicespecs
2. 將WURFL™檔案複製到資料夾。
3. 將檔案更名為wurfl.xml。

AEM會自動解析wurfl.xml檔案並更新/var/mobile/devicespecs下方的節點。

添加基於regexp的用戶代理匹配

將user-agent添加為/apps/wcm/mobile/devicespecs/wurfl/regexp下的規則表達式，以指向現有的WURFL™設備類型。

1. 在​CRXDE Lite​中，在/apps/wcm/mobile/devicespecs/regexp下建立節點，例如apple_ipad_ver1。

2. 將下列屬性新增至節點：

   • regexp:定義使用者代理的規則運算式，例如：.*Mozilla。*iPad。*AppleWebKit。*Safari。*
   • deviceId:在wurfl.xml中定義的裝置ID，例如：apple_ipad_ver1

上述設定會使User-Agent與提供的規則運算式相符的裝置對應至apple_ipad_ver1 WURFL™裝置ID（若存在）。

客戶端設備檢測

本節說明如何使用AEM的裝置用戶端偵測，以最佳化頁面呈現或為用戶端提供替代的網站版本。

AEM支援以BrowserMap為基礎的裝置用戶端偵測。 BrowserMap 會以用戶端程式庫的形式隨附於AEM /etc/clientlibs/browsermap。

BrowserMap 提供三種策略，您可以用來為客戶提供替代網站，其採用順序如下：

1. 替代連結

2. 設備組特定URL

3. 選取器型URL

提供備用連結

PageVariantsProvider OSGi服務能夠為屬於同一系列的站點生成替代連結。 為了配置要由服務考慮的站點，必須從站點的根目錄向jcr:content節點添加cq:siteVariant節點。

cq:siteVariant節點必須具有以下屬性：

• cq:childNodesMapTo — 確定子節點將映射到的連結元素的屬性；建議您以這樣的方式組織網站的內容，讓根節點的子代代表全域網站語言變體的根(例如， /content/mysite/en、 /content/mysite/de)，在此情況下，的 cq:childNodesMapTo 值應為 hreflang;

• cq:variantDomain — 指出 Externalizer 要用來產生頁面變體絕對URL的網域；若未設定此值，則會使用相對連結產生頁面變體；

• cq:variantFamily — 指明本站點屬於哪個網站系列；同一網站的多個特定裝置表示應屬於同一家族；

• media — 儲存連結元素的媒體屬性值；建議您使用已註冊的名 BrowserMap 稱， DeviceGroups這樣程式庫就可 BrowserMap 以自動將用戶端轉送至網站的正確變體。

PageVariantsProvider和Externalizer

當cq:siteVariant節點的cq:variantDomain屬性值不為空時，PageVariantsProvider服務將使用此值作為Externalizer服務的配置域生成絕對連結。 請務必設定Externalizer服務以反映您的設定。

定義設備組特定URL

如果您不想使用替代連結，可以為每個DeviceGroup配置全域URL。 建議您建立自己的用戶端程式庫，內嵌browsermap.standard用戶端程式庫，但重新定義裝置群組。

BrowserMap的設計方式是，通過從自定義的客戶端庫中建立同名的新設備組並將其添加到BrowserMap對象，來覆蓋設備組定義。

定義基於選擇器的URL

如果未採用任何先前機制來指示BrowserMap的替代網站，則將使用DeviceGroups名稱的選取器新增至URL，在此情況下，您應提供將處理請求的專屬servlet。

例如，由BrowserMap識別為smartphone的裝置瀏覽www.example.com/index.html會轉送至www.example.com/index.smartphone.html.

在您的頁面上使用BrowserMap

若要在頁面中使用標準的BrowserMap用戶端程式庫，您必須在頁面的head區段中使用cq:include標籤包含/libs/wcm/core/browsermap/browsermap.jsp檔案。

<cq:include script="/libs/wcm/core/browsermap/browsermap.jsp" />

除了在JSP檔案中新增BrowserMap用戶端程式庫外，您還必須將設為client-side的cq:deviceIdentificationMode字串屬性新增至網站根目錄下的jcr:content節點。

覆寫BrowserMap的預設行為

如果要自定義BrowserMap — 通過覆蓋DeviceGroups或添加更多探測器來自定義 — 則應建立自己的客戶端庫，在其中嵌入browsermap.standard客戶端庫。

此外，您必須手動呼叫JavaScript程式碼中的BrowserMap.forwardRequest()方法。

建立自定義的BrowserMap客戶端庫後，我們建議使用以下方法：

1. 在應用程式中建立browsermap.jsp檔案

   <%@include file="/libs/foundation/global.jsp" %>
   <%@ taglib prefix="c" uri="https://java.sun.com/jsp/jstl/core" %>
   <%@ page import="
       com.day.cq.wcm.api.variants.PageVariant,
       com.day.cq.wcm.api.variants.PageVariantsProvider,
       com.day.cq.wcm.api.devicedetection.DeviceIdentificationMode,
       com.day.cq.wcm.api.WCMMode"
   %>
   <%
       final PageVariantsProvider p = sling.getService(PageVariantsProvider.class);
       if(p == null) {
           throw new IllegalStateException("Missing PageVariantsProvider service");
       }
       for(PageVariant v : p.getVariants(currentPage, slingRequest)) {
           final String curVar = v.getAttributes().get("data-current-variant");
           String media = v.getAttributes().get("media");
           if (media != null) {
               media = media.replaceAll(" ", "");
           }
   %>
       <link
           rel="alternate"
           data-cq-role="site.variant"
           title="<%= xssAPI.encodeForHTMLAttr(v.getTitle()) %>"
           hreflang="<%= xssAPI.encodeForHTMLAttr(v.getAttributes().get("hreflang")) %>"
           media="<%= xssAPI.encodeForHTMLAttr(media) %>"
           href="<%= xssAPI.getValidHref(v.getURL()) %>"
           <% if(curVar != null) { %> data-current-variant="<%= curVar %>"<% } %>
       />
   <%
       }
       Boolean browserMapEnabled = true;
       final DeviceIdentificationMode dim = sling.getService(DeviceIdentificationMode.class);
       String[] selectors  = slingRequest.getRequestPathInfo().getSelectors();
       boolean isPortletRequest = false;
       for (int i = 0; i < selectors.length; i++) {
           if ("portlet".equals(selectors[i])) {
               isPortletRequest = true;
               break;
           }
       }
       if (isPortletRequest) {
           log.debug("Request was made by a portlet container - BrowserMap will not be embedded");
       } else {
           final WCMMode wcmMode = WCMMode.fromRequest(slingRequest);
           boolean shouldIncludeClientLib = false;
           if (WCMMode.EDIT != wcmMode && WCMMode.PREVIEW != wcmMode && WCMMode.DESIGN != wcmMode) {
               if (dim != null) {
                   final String mode = dim.getDeviceIdentificationModeForPage(currentPage);
                   shouldIncludeClientLib = DeviceIdentificationMode.CLIENT_SIDE.equals(mode);
                   if (shouldIncludeClientLib) {
                       browserMapEnabled = (Boolean) request.getAttribute("browsermap.enabled");
                       if (browserMapEnabled == null) {
                           browserMapEnabled = true;
                       }
                   }
               }
           }
   %>
           <c:if test="<%= !browserMapEnabled %>">
               <meta name="browsermap.enabled" content="false">
           </c:if>
           <c:if test="<%= shouldIncludeClientLib %>">
               <meta name="viewport" content="width=device-width, initial-scale=1.0">
               <cq:includeClientLib categories="browsermap.custom"/>
           </c:if>
   <%
       }
   %>
   

2. 將broswermap.jsp檔案加入標題區段。

   <cq:include script="browsermap.jsp" />
   

從特定頁面排除BrowserMap

如果您想要從您不需要用戶端偵測的部分頁面中排除BrowserMap程式庫，可以新增請求屬性：

<%
request.setAttribute("browsermap.enabled", false);
%>

這會使/libs/wcm/core/browsermap/browsermap.jsp指令碼將中繼標籤新增至會讓BrowserMap不執行任何偵測的頁面：

<meta name="browsermap.enabled" content="false">

測試網站的特定版本

通常，BrowserMap指令碼會一律將訪客重新導向至最適合的網站版本，通常會視需要將訪客重新導向至案頭或行動網站。

您可以將device參數新增至URL，以強制任何請求的裝置來測試特定版本的網站。 下列URL會轉譯Geometrixx Outdoors網站的行動版本。

http://localhost:4502/content/geometrixx-outdoors/en.html?wcmmode=disabled&device=smartphone

覆蓋的裝置值會儲存在Cookie中，以便您不需將device參數新增至每個URL即可瀏覽您的網站。

因此，您需要呼叫相同的URL並將device設為browser，才能返回網站的案頭版本。

行動請求處理

AEM會依照下列方式處理由屬於觸控裝置群組的行動裝置發出的請求：

1. iPad會傳送要求至AEM發佈例項，例如http://localhost:4503/content/geometrixx_mobile/en/products.html

2. AEM會判斷所請求頁面的網站是否為行動網站（透過檢查第一層頁面/content/geometrixx_mobile是否延伸行動頁面元件）。 如果是：

3. AEM會根據請求標題中的使用者代理來查閱裝置功能。

4. AEM會將裝置功能對應至裝置群組，並將touch設為裝置群組選取器。

5. AEM會將請求重新導向至http://localhost:4503/content/geometrixx_mobile/en/products.touch.html.

6. AEM會將回應傳送至iPad:

   • products.touch.html 都是平時的，平易近人。
   • 演算元件使用選取器來調整呈現方式。
   • AEM會自動將行動選擇器新增至頁面中的所有內部連結。

統計資料

您可以取得行動裝置向AEM伺服器提出之請求數的統計資料。 可以劃分請求數：

• 每個設備組和設備
• 每年，月和日

要查看統計資訊，請執行以下操作：

1. 前往​工具​主控台。

2. 開啟​Device Statistics​頁面，位於​Tools > Mobile​下。

3. 按一下連結可檢視特定年份、月份或日的統計資料。

Statistics​頁如下所示：

如果需要在統計資訊中生成條目，可以按如下方式繼續：

1. 使用行動裝置或模擬器(例如Firefox上的https://chrispederick.com/work/user-agent-switcher/)。

2. 停用製作模式，在製作例項上要求行動頁面，例如：

   http://localhost:4502/content/geometrixx_mobile/en/products.html?wcmmode=disabled

「統計資料」頁現在可用。

支援「傳送連結給朋友」連結的頁面快取

Dispatcher通常可使用行動頁面，因為為裝置群組轉譯的頁面可由裝置群組選取器在頁面URL中區分，例如/content/mobilepage.touch.html。 系統不會快取對沒有選取器的行動頁面的要求，在此情況下，裝置偵測會運作，最後重新導向至相符的裝置群組（或就此而言「不相符」）。 連結重寫器會處理呈現有裝置群組選擇器的行動頁面，該連結重寫器會重新寫入頁面內的所有連結以同時包含裝置群組選擇器，以防止對已合格頁面上的每次點按重新執行裝置偵測。

因此，您可能會遇到下列情況：

使用者Alice會重新導向至coolpage.feature.html，並將該URL傳送給朋友Bob，該朋友Bob透過位於touch裝置群組中的其他用戶端存取該URL。

如果從前端快取提供coolpage.feature.html,AEM將無法分析請求，以找出行動選擇器與新的使用者代理不符，而Bob會獲得錯誤的表示。

若要解決此問題，您可以在頁面上加入簡單的選取UI，讓使用者可以覆寫AEM選取的裝置群組。 在上例中，如果最終用戶認為其設備足夠好，則頁面上的連結（或表徵圖）允許其切換到coolpage.touch.html。