建立您的第一個OSGi套件

OSGi套件組合是Java™封存檔案,其中包含Java程式碼、資源,以及說明套件組合及其相依性的資訊清單。 組合是應用程式的部署單位。 本文適用於想使用AEM Forms 6.4或6.5建立OSGi服務或servlet的開發人員。若要建置您的第一個OSGi套件,請遵循下列步驟:

安裝JDK

安裝支援的JDK版本。 我已使用JDK1.8。確定已在您的環境變數中新增​ JAVA_HOME,並指向JDK安裝的根資料夾。
將%JAVA_HOME%/bin新增至路徑

資料來源

NOTE
請勿使用JDK 15。 AEM不支援此功能。

測試您的JDK版本

開啟新的命令提示字元視窗並輸入: java -version。 您應該取回JAVA_HOME變數所識別的JDK版本

資料來源

安裝Maven

Maven是主要用於Java專案的組建自動化工具。 請依照下列步驟在本機系統上安裝maven。

  • 在您的C磁碟機中建立名為maven的資料夾
  • 下載二進位zip封存
  • 將zip封存的內容解壓縮至c:\maven
  • 使用值C:\maven\apache-maven-3.6.0建立名為M2_HOME的環境變數。 以我為例,mvn ​版本是3.6.0。在撰寫本文時,最新的maven版本是3.6.3
  • %M2_HOME%\bin新增至您的路徑
  • 儲存您的變更
  • 開啟新的命令提示字元並輸入mvn -version。 您應該會看到​ mvn ​版本已列出,如下列熒幕擷圖所示

資料來源

安裝Eclipse

安裝最新版的eclipse

建立您的第一個專案

Archetype是一種Maven專案範本工具組。 原型被定義為原始陣列或模型,其他同類物件的製作都來自此原始陣列或模型。 此名稱適合我們努力提供的系統,此系統可提供產生Maven專案的一致方法。 Archetype可協助作者為使用者建立Maven專案範本,並為使用者提供產生這些專案範本引數化版本的方法。
若要建立您的第一個maven專案,請遵循下列步驟:

  • 在您的C磁碟機中建立名為aemformsbundles的新資料夾
  • 開啟命令提示字元並瀏覽至c:\aemformsbundles
  • 在命令提示字元中執行以下命令
mvn -B org.apache.maven.plugins:maven-archetype-plugin:3.2.1:generate -D archetypeGroupId=com.adobe.aem -D archetypeArtifactId=aem-project-archetype -D archetypeVersion=36 -D appTitle="My Site" -D appId="mysite" -D groupId="com.mysite" -D aemVersion=6.5.13

成功完成後,您應該會在命令視窗中看到建置成功訊息

從您的Maven專案建立Eclipse專案

  • 將工作目錄變更為mysite
  • 從命令列執行mvn eclipse:eclipse。 該命令會讀取您的pom檔案,並使用正確的中繼資料建立Eclipse專案,以便Eclipse瞭解專案型別、關係、類別路徑等。

將專案匯入eclipse

啟動​ Eclipse

移至​ 檔案 — >匯入 ​並選取​ 現有Maven專案,如下所示

資料來源

按「下一步」

按一下​ 瀏覽 ​按鈕,選取c:\aemformsbundles\mysite

資料來源

NOTE
您可以視需要選擇匯入適當的模組。 如果您只打算在專案中建立Java程式碼,請僅選取並匯入核心模組。

按一下​ 完成 ​以開始匯入程式

專案已匯入至Eclipse,而您看到許多mysite.xxxx資料夾

展開mysite.core資料夾下的src/main/java。 這是您撰寫大部分程式碼的資料夾。

資料來源

包含AEMFD使用者端SDK

您必須在專案中加入AEMFD使用者端SDK,才能運用AEM Forms隨附的各種服務。 請參考AEMFD使用者端SDK,在您的Maven專案中包含適當的使用者端SDK。 您必須在核心專案的pom.xml的相依性區段中包含AEM FD使用者端SDK,如下所示。

<dependency>
    <groupId>com.adobe.aemfd</groupId>
    <artifactId>aemfd-client-sdk</artifactId>
    <version>6.0.122</version>
</dependency>

若要建置專案,請遵循下列步驟:

  • 開啟​ 命令提示字元視窗
  • 瀏覽至c:\aemformsbundles\mysite\core
  • 執行命令mvn clean install -PautoInstallBundle
    上述命令會在http://localhost:4502上執行的AEM伺服器中建置並安裝套件。 檔案系統上也提供該套件,位於
    C:\AEMFormsBundles\mysite\core\target並可使用Felix Web主控台部署

後續步驟

建立OSGi服務

recommendation-more-help
8de24117-1378-413c-a581-01e660b7163e