hydrogen

مستندات | المناقشات | سجل التغيير

الهيدروجين هو مكدس Shopify للتجارة مقطوعة الرأس. فهو يوفر مجموعة من الأدوات والأدوات المساعدة والأمثلة الأفضل في فئتها لإنشاء تطبيقات تجارية ديناميكية وفعالة. تم تصميم Hydrogen ليتوافق مع Remix، إطار عمل الويب الكامل الخاص بـ Shopify، ولكنه يوفر أيضًا مكتبة React قابلة للنقل إلى أطر العمل الداعمة الأخرى.

تراث الهيدروجين v1

تم نقل الإصدار 1 من تراث الهيدروجين إلى مستودع منفصل ويمكن العثور على المستندات هنا.

البدء بالهيدروجين

متطلبات:

• إصدار Node.js 16.14.0 أو أعلى
• npm (أو مدير الحزم الذي تختاره، مثل yarn أو pnpm )

1. قم بتثبيت أحدث إصدار من الهيدروجين:

   npm create @shopify/hydrogen@latest

2. تشغيل خادم التطوير المحلي:

   npm install
   npm run dev

3. افتح تطبيق الهيدروجين الجديد الذي يعمل على http://localhost:3000.

راجع مستندات الهيدروجين الكاملة.

الحزم في هذا الريبو

يتم تنظيم الهيدروجين على شكل مونوريبو، والذي يتضمن عبوات متعددة يمكن استخدامها معًا.

طَرد	أحدث نسخة	وصف	الملف التمهيدي
@shopify/hydrogen		الأدوات والأدوات المساعدة وأفضل الأمثلة في فئتها لإنشاء تطبيق تجاري باستخدام Remix.	الملف التمهيدي
@shopify/hydrogen-react		مكتبة غير معتمدة وذات أداء عالي لمكونات التجارة والخطافات والأدوات المساعدة الخاصة بـ Shopify.	الملف التمهيدي
@shopify/cli-hydrogen		امتداد الهيدروجين لـ Shopify CLI.	الملف التمهيدي
@shopify/create-hydrogen		قم بإنشاء مشروع هيدروجين جديد من سطر الأوامر.	الملف التمهيدي
@shopify/hydrogen-codegen		قم بإنشاء أنواع لاستعلامات Storefront API تلقائيًا.	الملف التمهيدي
@shopify/remix-oxygen		محول ريمكس يمكّن الهيدروجين من العمل في وقت تشغيل الأكسجين.	الملف التمهيدي
@shopify/mini-oxygen		وقت تشغيل محلي لتطبيقات الهيدروجين الذي يحاكي بيئة إنتاج الأكسجين.	الملف التمهيدي

الإصدار

يرتبط الهيدروجين وتفاعل الهيدروجين بإصدارات محددة من واجهة برمجة تطبيقات Shopify Storefront API، والتي تتبع كالفر.

على سبيل المثال، إذا كنت تستخدم إصدار Storefront API 2023-01 ، فإن إصدارات Hydrogen وHydrogen-react 2022.1.x متوافقة تمامًا.

إذا كان تحديث إصدار Storefront API يتضمن تغييرات كسرية، فقد يتضمن تفاعل الهيدروجين والهيدروجين أيضًا تغييرات كسرية. ونظرًا لأنه يتم تحديث إصدار واجهة برمجة التطبيقات (API) كل ثلاثة أشهر، فمن الممكن أن تحدث تغييرات جذرية كل ثلاثة أشهر.

تعرف على المزيد حول جداول إصدار واجهة برمجة التطبيقات (API) في Shopify.

المساهمة في الهيدروجين

اقرأ دليل المساهمة الخاص بنا

روابط مفيدة أخرى

تعلم المزيد عن الهيدروجين.