踏上首次使用 AEM Headless 之路 path-to-first-experience

在 AEM Headless 開發人員歷程的這一部分中，您將了解在 AEM 中實作您的第一個 Headless 體驗的步驟 (包括規劃考量事項)，並學習最佳做法以使您的操作過程盡可能順利。

目前進度 story-so-far

在 AEM Headless 歷程的上一個文件「AEM Headless as a Cloud Service 快速入門」中，您已了解 Headless CMS 的基本理論，您現在應該：

本文章以這些基本知識為基礎，以便您了解如何準備您自己的 AEM Headless 專案。

目標 objective

本文件可協助您了解實作第一個專案所需的步驟。閱讀本文件後，您應該：

要求 requirements

在繼續閱讀本文件之前，務必先查閱 AEM Headless 開發人員歷程的上一篇文件AEM Headless as a Cloud Service 快速入門，以確保您：

為成功做規劃 planning-for-success

若要開始您的第一個 AEM Headless 專案，需要確保您有一個內容模型，可支援您想要跨所有管道進行的個人化和更新。

與 AEM 分開，您還需要確保已設定適當的開發環境，如果您正在建置用戶端應用程式，以便測試用戶端對 AEM as a Cloud Service 進行 API 呼叫。

定義內容模型和 API defining-models

您想要促成一致的體驗並管理跨管道的個人化行銷活動，您可以將每個單獨的管道和表面視為其自己獨特的內容結構來傳遞。然而，讓每個管道都有自己的內容模型會很難維護。

相反地，您應該根據組織原則，例如品牌和產品階層、商品或表面目錄或是客戶歷程中的步驟，來考慮不同表面上的內容如何相關。例如，如果您有一組表面可支援您製造的特定品牌汽車，您可能想要從內容模型開始，取得適用於整輛汽車的一般資訊，然後是較為特定項目，例如車輛啟動時到出現維修問題時所需的內容。這類模型會強制繼承一般汽車品牌內容，也允許根據所需特定情境進行變換。這也能協助在未來管理此內容的更新，因為您可以根據角色強制執行控制，例如整體行銷人員或整個汽車品牌的產品經理，對比負責「啟動汽車」體驗的作者。

當您有了內容模型並清楚了解內容所面向的各種用戶端，您必須確保與存取各種內容模型關聯的 GraphQL/API 會發佈到需要此內容的所有用戶端。有不同方法可以存取特定內容。您可以要求一段特定的靜態內容，這樣可以快取內容並提高效能。您也可以要求動態產生的內容，這將需要更多處理。確保用戶端使用最有效滿足其業務需求的 API。

了解您的環境 understanding-environments

AEM 有三種類型的環境：開發、中繼和生產。

開發環境 (您可以有多個) 是實驗和嘗試想法的安全地方。在專案的初始階段，Adobe 建議使用開發環境來嘗試各種版本的內容模型，並查看哪些版本為表面提供預期的輸出。

Headless 專案的中繼環境用於在新的 AEM 產品版本推送到生產環境之前對其進行驗證。在那裡保留最新的生產內容模型清單和內容子集，當您進行變更或 AEM 版本引入變更時，您就可以呈現 JSON 檔案以比較它們是否仍然提供相同的輸出。

生產環境是內容作者建立和管理其實際內容的地方。在生產環境變更模型必須小心進行，並謹記回溯相容性。

在開發階段，建議您使用開發和中繼環境。當您轉向效能測試時，您會想要移至生產環境。

開發人員和內容作者協力合作 cooperation

開發人員需要的 AEM 開發環境是內含填入的內容模型。由於內容作者仍在建立內容，開發人員開發的用戶端將取用 AEM 的 Headless 內容。這就是 API 定義非常重要的原因。開發人員可以使用 AEM SDK 來建立測試連結，以便建立用戶端和單元測試，確保用戶端能夠正確呈現內容。

內容作者根據已在中繼環境定義的內容模型建立內容。使用內容片段製作工具，作者可以建立新的內容片段或編輯現有的內容片段。在發佈之前，作者可以與開發人員合作將內容模型推送至開發環境，或僅為作者設定開發人員環境，來預覽它在用戶端中的外觀。

設定 setup

在 AEM 中開始使用 Headless 技術之前，您需要確保已啟用所有必要的功能。本章節概述相關要求。完成這些步驟的實際步驟將在 AEM Headless 開發人員歷程的後續部分詳細說明。

您也可以選擇參閱其他資源以取得個別主題的詳細資訊。

設定 configuration

實作您的第一個 AEM Headless 應用程式

這是概述需要哪些東西才能使用 AEM 實作您的第一個 Headless 應用程式以傳遞您的內容。如何執行這些步驟會在 Headless 開發人員歷程的後面部分詳細描述。

最佳做法 best-practices

Headless 專案的成功不僅在於實作的技術，還在於良好的規劃和專案管理。以下是內容作者和開發人員在規劃專案時要謹記的一些最佳實務。

組織您的內容 organizing-content

製作內容 authoring

製作全域內容 localization

下一步 what-is-next

您已完成此部分的 AEM Headless 開發人員歷程，您應該：

我們希望您以此基本知識為基礎，充分了解 AEM Headless 的強大功能和靈活性，以便利用在自己的專案上。為此，您有多種選擇。

選擇你自己的冒險 choose-your-path

無論您的學習方式為何，Adobe 都希望您能順利開始您的 AEM Headless 專案。

其他資源 additional-resources

雖然建議您查閱文件如何為您的內容建立 AEM 內容模型來繼續 Headless 開發歷程的下個部分，以下也有一些其他選擇性資源，在深入探究本文件提到的一些概念，但不是繼續 Headless 歷程的必要條件。