aem core cif components
CI
يعمل مشروع مكونات AEM CIF Core كمسرع للبدء في المشاريع باستخدام AEM و CIF و Adobe Commerce. يحتوي المشروع على مكونات Commerce Core القابلة لإعادة الاستخدام تجمع بين مكونات AEM من جانب الخادم ومكونات التجارة من جانب العميل (MPA) للتجارب / البيانات الديناميكية.
يهدف هذا المشروع إلى استخدامها بالاقتران مع المكونات الأساسية لمواقع AEM. تستخدم مكونات AEM CIF Core المكونات الأساسية لمواقع AEM كأساس حيثما كان ذلك ممكنًا وتمديدها.
لبدء مشروع جديد ، يرجى إلقاء نظرة على مشروع النموذج الأصلي الخاص بنا. ألقِ نظرة أيضًا على مشروع عينة Venia الذي يستخدم مكونات WCM و CIF الأساسية لتقديم تجربة مذهلة في المتجر.
راجع وثائق المحتوى والتجارة AEM لتعليمات الاستخدام والتكوين لمكونات AEM CIF الأساسية ومقدمة لتطوير مكون AEM.
قد تتغير المكونات الموجودة في المعاينة الفنية بطريقة متوافقة مع عدم وجود متخلف في أي وقت. ويشمل ذلك جميع غيرها وخاصة بنية المحتوى ، API ، الترميز والتصميم إن أمكن. لا تستخدم هذه المكونات في الإنتاج.
أحدث إصدار من مكونات AEM CIF الأساسية ، يتطلب متطلبات النظام الأدنى أدناه:
| مكونات CIF الأساسية | AEM كخدمة سحابية | AEM 6.5 | AEM Commerce الوظيفة الإضافية | Adobe Commerce | جافا |
|---|---|---|---|---|---|
| 2.15.0 | مستمر | 6.5.18 | V2022.08.02.00 | 2.4.2 EE | 11 |
للحصول على قائمة بمتطلبات الإصدارات السابقة ، انظر متطلبات النظام التاريخي.
بالنسبة إلى AEM كعمليات نشر خدمة سحابية ، يتطلب هذا المشروع الإضافات CIF التي يتم توفيرها على كل AEM كبيئة خدمة سحابية. يتم تثبيت الوظيفة الإضافية CIF تلقائيًا ، ولا يلزم وجود نشر إضافي. تتوفر الإضافات CIF أيضًا للتطوير المحلي مع AEM SDK من بوابة توزيع البرامج.
بالنسبة للتركيبات المحلية AEM ، يتطلب هذا المشروع إضافة AEM Commerce الإضافية لـ AEM 6.5 لتحسين تجربة التأليف من خلال الاستفادة من ملتمي المنتجات ، وعرض أصول المنتج ، وأجهزة المنتجات التي توفرها حزمة الموصل. تتوفر أيضًا AMERCE Commerce Add-On لـ AEM 6.5 على بوابة توزيع البرامج. يجب تثبيته بشكل منفصل.
يعتمد هذا المشروع على المكونات الأساسية لمواقع AEM. يتم تثبيتها عادة كجزء من AEM. إذا قمت بتثبيت AEM بدون عينة من خيار المحتوى ، فيجب عليك نشرها يدويًا قبل استخدام مكونات AEM CIF الأساسية.
بدءًا من 2.3.2 ، تدعم Adobe Commerce طلبات GraphQL القابلة للتذاكر الذاتي وبدء الإصدار 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 الأساسية على مستودع Maven المركزي. لتضمين حزمة مكونات AEM CIF Core في مشروع Maven الخاص بك ، يمكنك إضافة التبعية
<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.
لتخصيص مكونات CIF الأساسية ، نقدم حالات الاستخدام والأمثلة في وثائقنا في تخصيص مكونات CIF الأساسية.
يتم تغطية رمز JavaScript من جانب العميل للمكونات باستخدام اختبارات وحدة Mocha التي تم تنفيذها مع Karma. يرجى التأكد من أنه لكل مساهمة رمز جديد من جانب العميل يتم تغطية الاختبارات وأن جميع الاختبارات تمر.
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 والإصدار الدلالي ، يمكن للمرء بسهولة تحديث إصدار POM الأصل وجميع POMs التي تشير إلى إصدار POM الأصل عن طريق تشغيل الأمر التالي في مجلد المشروع الأصل: mvn versions:set -DnewVersion=xyz-SNAPSHOT . هذا سيضمن أن جميع المشاريع لها نفس الإصدار.
المساهمات موضع ترحيب! اقرأ دليل المساهمة لمزيد من المعلومات.
تم ترخيص هذا المشروع بموجب ترخيص Apache V2. انظر الترخيص لمزيد من المعلومات.
