aem core cif components
CI
โครงการส่วนประกอบหลักของ AEM CIF ทำหน้าที่เป็นตัวเร่งความเร็วในการเริ่มต้นด้วยโครงการโดยใช้ AEM, CIF และ Adobe Commerce โครงการมีส่วนประกอบหลักของการค้าที่ใช้ซ้ำได้ซึ่งรวมส่วนประกอบ AEM ที่แสดงผลฝั่งเซิร์ฟเวอร์เข้ากับส่วนประกอบการค้าแบบไคลเอนต์ฝั่งไคลเอ็นต์ (MPA) สำหรับประสบการณ์ / ข้อมูลแบบไดนามิก
โครงการนี้มีวัตถุประสงค์เพื่อใช้ร่วมกับส่วนประกอบหลักของ AEM Sites ส่วนประกอบหลักของ AEM CIF ใช้ส่วนประกอบหลักของ AEM Sites เป็นรากฐานที่เป็นไปได้และขยายออกไป
สำหรับการเริ่มต้นโครงการใหม่โปรดดูที่โครงการต้นแบบของเรา นอกจากนี้ยังได้ดูโครงการตัวอย่าง Venia ของเราที่ใช้ส่วนประกอบ WCM และ CIF Core เพื่อมอบประสบการณ์ด้านหน้าร้านค้าที่น่าทึ่ง
ดูเอกสารประกอบเนื้อหาและการค้าของ AEM สำหรับคำแนะนำการใช้งานและการกำหนดค่าขององค์ประกอบหลักของ AEM CIF และการแนะนำการพัฒนาองค์ประกอบ AEM
ส่วนประกอบที่อยู่ในตัวอย่างทางเทคนิคอาจเปลี่ยนแปลงในวิธีที่เข้ากันได้กับย้อนหลังได้ตลอดเวลา ซึ่งรวมถึง asepects ทั้งหมดและโดยเฉพาะอย่างยิ่งโครงสร้างเนื้อหา API มาร์กอัปและสไตล์หากมี อย่าใช้ส่วนประกอบเหล่านี้ในการผลิต
รุ่นล่าสุดของส่วนประกอบ AEM CIF Core ต้องการข้อกำหนดขั้นต่ำของระบบต่ำกว่า:
| องค์ประกอบหลักของ CIF | AEM เป็นบริการคลาวด์ | AEM 6.5 | AEM Commerce Add-on | Adobe Commerce | ชวา |
|---|---|---|---|---|---|
| 2.15.0 | อย่างต่อเนื่อง | 6.5.18 | V2022.08.02.00 | 2.4.2 EE | 11 |
สำหรับรายการข้อกำหนดสำหรับเวอร์ชันก่อนหน้าดูข้อกำหนดของระบบในอดีต
สำหรับ AEM ในฐานะการปรับใช้บริการคลาวด์โครงการนี้ต้องใช้ส่วนเสริม CIF ที่จัดเตรียมไว้ในแต่ละ AEM เป็นสภาพแวดล้อมการให้บริการคลาวด์ Add-on CIF ถูกติดตั้งโดยอัตโนมัติไม่จำเป็นต้องมีการปรับใช้เพิ่มเติม CIF Add-on ยังมีให้สำหรับการพัฒนาในท้องถิ่นด้วย AEM SDK จากพอร์ทัลการกระจายซอฟต์แวร์
สำหรับการติดตั้ง AEM on-Prem โครงการนี้ต้องใช้ Add-on AEM Commerce สำหรับ AEM 6.5 เพื่อปรับปรุงประสบการณ์การเขียนโดยใช้ประโยชน์จากตัวเลือกผลิตภัณฑ์มุมมองสินทรัพย์ผลิตภัณฑ์และคอนโซลผลิตภัณฑ์ที่จัดทำโดยแพ็คเกจเชื่อมต่อ นอกจากนี้ยังมี AEM Commerce Add-on สำหรับ AEM 6.5 ในพอร์ทัลการกระจายซอฟต์แวร์ ต้องติดตั้งแยกต่างหาก
โครงการนี้ขึ้นอยู่กับส่วนประกอบหลักของไซต์ AEM โดยทั่วไปแล้วจะถูกติดตั้งเป็นส่วนหนึ่งของ AEM หากคุณติดตั้ง AEM โดยไม่มีตัวเลือกเนื้อหาตัวอย่างคุณต้องปรับใช้ด้วยตนเองก่อนที่จะใช้ส่วนประกอบ AEM CIF Core
เริ่มต้นด้วย 2.3.2, Adobe Commerce รองรับคำขอ graphql cache-able และเริ่มต้นด้วยเวอร์ชัน 0.2.1 ส่วนประกอบ CIF Core จะใช้ตามค่าเริ่มต้น เพื่อให้ส่วนประกอบทำงานกับ Adobe Commerce 2.3.1 คุณสามารถปิดการใช้งานคุณสมบัตินี้ได้ในสถานที่ต่อไปนี้:
mvn clean install ในโฟลเดอร์รูทเพื่อติดตั้งสิ่งประดิษฐ์ไปยังที่เก็บ Maven ในพื้นที่ของคุณall และเรียกใช้ mvn clean install content-package:installนี่คือวิดีโอเต็มรูปแบบของกระบวนการตั้งค่า
หากคุณต้องการสร้างโมดูลทั้งหมดด้วยตัวเองและรับการเปลี่ยนแปลงล่าสุด (ยัง) ที่ยังไม่เผยแพร่ เพียงแค่สร้างและติดตั้งโมดูลทั้งหมดด้วยคำสั่งต่อไปนี้ที่รูทของที่เก็บ:
mvn clean install -PautoInstallAll
สิ่งนี้ติดตั้งทุกอย่างโดยค่าเริ่มต้นไปยัง localhost:4502 โดยไม่มีเส้นทางบริบทใด ๆ คุณยังสามารถกำหนดค่าตำแหน่งการติดตั้งด้วยคุณสมบัติ Maven ต่อไปนี้:
aem.host : ชื่อของอินสแตนซ์ AEMaem.port : หมายเลขพอร์ตของอินสแตนซ์ AEMaem.contextPath : เส้นทางบริบทของอินสแตนซ์ AEM ของคุณ (ถ้าไม่ใช่ / ) โครงการนี้อาศัย AEM 6.5.7 cq-quickstart Uberjar นี้มีให้บริการในที่สาธารณะใน https://repo.adobe.com
สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับ Uberjar โปรดตรงไปที่วิธีการสร้างโครงการ AEM โดยใช้หน้าเอกสาร Apache Maven
ส่วนประกอบหลักของ AEM CIF COR มีอยู่ในที่เก็บ Maven Central ในการรวมแพ็คเกจส่วนประกอบ AEM CIF Core ลงในโครงการ Maven Build ของคุณเองคุณสามารถเพิ่มการพึ่งพาได้
<dependency>
<groupId>com.adobe.commerce.cif</groupId>
<artifactId>core-cif-components-all</artifactId>
<type>zip</type>
<version>x.y.z</version>
</dependency>
และส่วนแพ็คเกจย่อย
<subPackage>
<groupId>com.adobe.commerce.cif</groupId>
<artifactId>core-cif-components-all</artifactId>
<filter>true</filter>
</subPackage>
ไปยัง content-package-maven-plugin
ในการเชื่อมต่อส่วนประกอบหลักของ AEM CIF กับสภาพแวดล้อม Adobe Commerce ของคุณหรือการปรับใช้การค้าของบุคคลที่สามทำตามขั้นตอนการกำหนดค่า สำหรับการตั้งค่าหลายร้านค้า / ไซต์ขั้นตอนเพิ่มเติมจำเป็นต้องเชื่อมโยงไซต์ AEM กับการกำหนดค่ามุมมอง Adobe Commerce Store View
สำหรับการปรับแต่งส่วนประกอบหลักของ CIF เราให้บริการกรณีและตัวอย่างในเอกสารของเราในการปรับแต่งส่วนประกอบหลักของ CIF
รหัส JavaScript ฝั่งไคลเอ็นต์ของส่วนประกอบนั้นครอบคลุมโดยใช้การทดสอบหน่วย MOCHA ที่ดำเนินการกับกรรม โปรดตรวจสอบให้แน่ใจว่าสำหรับการบริจาครหัสฝั่งไคลเอ็นต์ใหม่ทุกครั้งจะครอบคลุมโดยการทดสอบและการทดสอบทั้งหมดผ่าน
cd ui.apps
npm install
npm testกรรมจะทดสอบกับ Chrome และ Firefox ตรวจสอบให้แน่ใจว่าคุณติดตั้งเบราว์เซอร์ทั้งสองแล้ว
คุณสามารถค้นหากฎการจัดรูปแบบรหัสในไฟล์ eclipse-formatter.xml การจัดรูปแบบรหัสจะถูกตรวจสอบโดยอัตโนมัติสำหรับแต่ละบิลด์ หากต้องการจัดรูปแบบรหัสของคุณโดยอัตโนมัติโปรดเรียกใช้:
mvn clean install -Pformat-code สำหรับการจัดรูปแบบ JavaScript และ CSS เราใช้สวยกว่า การจัดรูปแบบจะถูกตรวจสอบโดยอัตโนมัติเมื่อเรียกใช้ npm test ในโครงการ ui.apps หากต้องการจัดรูปแบบรหัสของคุณโดยอัตโนมัติโปรดเรียกใช้คำสั่งต่อไปนี้ใน ui.apps :
npm run prettier:fix การเปิดตัวของโครงการนี้จะถูกกระตุ้นโดย mvn release:prepare release:clean บนสาขา master บนโฟลเดอร์รูทของที่เก็บนี้ เมื่อคุณเลือกรุ่นและสแนปชอตถัดไปสิ่งนี้จะทำการเปลี่ยนแปลงพร้อมกับแท็ก GIT รุ่นที่ปล่อยออกมาเช่น core-cif-components-reactor-xyz โปรดทราบว่าการกระทำจะไม่ถูกส่งไปยังที่เก็บ GIT โดยอัตโนมัติดังนั้นคุณจึงมีเวลาตรวจสอบการเปลี่ยนแปลงของคุณจากนั้นผลักดันพวกเขาด้วยตนเอง การผลักดันจากนั้นจะกระตุ้นการสร้าง CircleCI เฉพาะที่ดำเนินการปรับใช้สิ่งประดิษฐ์ที่ติดแท็กไปยัง Maven Central
สิ่งสำคัญ : โครงการนี้มีการเปิดตัวเครื่องปฏิกรณ์ Maven อย่า เปิดตัวจากโมดูลย่อย!
หมายเหตุ: ในกรณีที่จำเป็นต้องอัปเดตเวอร์ชันของชุด Java เนื่องจากการเปลี่ยนแปลงของ API และการกำหนดเวอร์ชันความหมายหนึ่งสามารถอัปเดตเวอร์ชัน PARY POM ได้อย่างง่ายดายและ POMs ทั้งหมดที่อ้างอิงเวอร์ชัน PARY POM โดยการเรียกใช้คำสั่ง mvn versions:set -DnewVersion=xyz-SNAPSHOT ไปนี้ในโฟลเดอร์ PREANTS สิ่งนี้จะทำให้มั่นใจได้ว่าโครงการทั้งหมดมีรุ่นเดียวกัน
ยินดีต้อนรับผลงาน! อ่านคู่มือการสนับสนุนสำหรับข้อมูลเพิ่มเติม
โครงการนี้ได้รับใบอนุญาตภายใต้ใบอนุญาต Apache V2 ดูใบอนุญาตสำหรับข้อมูลเพิ่มเติม
