Dynamics365Commerce.InStore
1.0.0
| page_type | اللغات | منتجات | اسم | وصف | |||
|---|---|---|---|---|---|---|---|
عينة |
|
| قم بتوسيع نقاط البيع التجارية وHWS وواجهات برمجة التطبيقات التجارية بدون رأس ووقت التشغيل التجاري. | يحتوي هذا الريبو على نموذج التعليمات البرمجية حول كيفية توسيع Dynamics 365 Commerce POS ومحطة الأجهزة وواجهات برمجة تطبيقات التجارة بدون رأس ووقت تشغيل التجارة. |
يحتوي هذا الريبو على نموذج التعليمات البرمجية لكيفية تخصيص نقطة البيع ومحطة الأجهزة (HWS) ووقت التشغيل التجاري (CRT) وواجهات برمجة تطبيقات التجارة بدون رأس وقاعدة بيانات القناة. يرجى ملاحظة أن هذه مجرد عينات وليس من الضروري استنساخ هذا الريبو لتطوير ملحقات Dynamics 365 Commerce. ينطبق هذا الموضوع على إصدار تطبيق التجارة Dynamics 365 10.0.18 أو أحدث.
يشرح هذا الملف بنية مستودع عينات InStore ويشرح كيفية إعداد مستودع للإشارة إلى الحزم النووية لـ Commerce SDK من الموجز العام لتطوير ملحق Dynamics 365 Commerce. يرجى زيارة موقع المستندات الخاص بنا للحصول على موارد إضافية حول تطوير Dynamics 365 Commerce.
لا تتطلب هذه العملية بيئة محددة مسبقًا أو جهازًا افتراضيًا. يمكن إجراء التطوير والاختبار على أي جهاز مزود بإصدار حديث نسبيًا من Windows. إذا لم تكن بحاجة إلى تطوير نقطة بيع حديثة، فيمكنك الاستفادة من Windows 10 وWindows Server 2016/2019. إذا كنت بحاجة إلى تطوير Sealed Modern POS، فقم بتثبيت هذه المتطلبات الأساسية. لمزيد من التفاصيل حول المتطلبات الأساسية لبيئة التطوير، يرجى الرجوع إلى هذه المقالة
يحتوي نموذج InStore repo على nuget.config وrepo.props وCustomizationPackage.props والبرنامج النصي لخطوط الأنابيب التي توفر إرشادات حول كيفية إعداد الامتداد لملفات بيانات تعريف الريبو.
| مجلد | وصف |
|---|---|
| هاردويرستيشنسامبل | يحتوي هذا المشروع على نماذج حول كيفية إنشاء محطة الأجهزة وملحقات الدفع ومثبتات الإضافات. |
| عينات التجارة في المتجر | يحتوي هذا المجلد على نماذج توضح كيفية توسيع تطبيق Store Commerce لتحقيق سيناريوهات التخصيص المتنوعة. |
| عينات التغليف | يحتوي هذا المجلد على نماذج توضح كيفية هيكلة حل Commerce SDK الخاص بك لإنشاء حزم/مثبتات لمكونات التجارة المناسبة. |
| خط أنابيب | ملفات البرامج النصية YAML وPowerShell |
يحتوي مستودع Dynamics365Commerce.ScaleUnit على نماذج إضافية تركز على سيناريوهات تطوير ملحق Headless Commerce مثل Headless Commerce APIs وCommerce Runtime.
كل عينة في هذا الريبو تكون مصحوبة بملف readme.md بالمعلومات التالية:
وصف لوظيفتها
خطوات بناء العينة وتشغيلها
قائمة واجهات برمجة التطبيقات التجارية ونقاط الامتداد المستخدمة في العينة ووصفًا لما تفعله.
رابط للوثائق ذات الصلة بواجهات برمجة التطبيقات التجارية ومنطقة الميزات
صورة GIF أو لقطة شاشة للوظيفة، إن أمكن
قام فريق التجارة ببناء التشغيل الآلي الذي يتحقق من أن جميع العينات الموجودة في الريبو هذا تم إنشاؤها بنجاح، ولكن هذا لا يضمن أن هذه العينات سيتم إنشاؤها وتشغيلها دائمًا دون مشكلات شائعة أثناء تطوير البرامج. إذا واجهت مشكلة في عينات InStore أو Commerce SDK، فيرجى البحث في قسم المشكلات في مستودع Github هذا لمعرفة ما إذا كانت مشكلة معروفة. قد يكون هناك بالفعل إصلاح أو حل بديل متاح.
إذا لم تكن مشكلتك مدرجة في قسم المشكلات، فيرجى إنشاء مشكلة جديدة تحتوي على تفاصيل حول المشكلة التي تواجهها. سيساعد هذا على ضمان حصول كل شخص يستخدم Commerce SDK وهذه العينات على أفضل تجربة ممكنة، وأن جميع المشكلات المعروفة ستكون قابلة للبحث عبر الإنترنت. سوف نقوم بمراقبة هذه المشكلات وتقديم المساعدة في أقرب وقت ممكن.
ملاحظة: للحصول على أفضل تجربة، يرجى الحد من استخدام قسم المشكلات للإبلاغ عن مشكلات Commerce SDK وعينات InStore.
يتم تنظيم الفروع الموجودة في الريبو بواسطة إصدار تطبيق Dynamics 365 Commerce، ويشير كل فرع في الريبو إلى إصدار تطبيق Dynamics 365 Commerce، استخدم فرع الإصدار الصحيح بناءً على إصدار التشغيل المباشر الخاص بك.
| الافراج عن اسم الفرع | إصدار | إصدار إصدار التطبيق |
|---|---|---|
| الإصدار/9.49 | 9.49.* | 10.0.39 |
| الإصدار/9.50 | 9.50.* | 10.0.40 |
| الإصدار/9.51 | 9.51.* | 10.0.41 |
| الإصدار/9.52 | 9.52.* | 10.0.42 |
يتم نشر العقود التجارية والرسائل والكيانات وحزم الطلب في هذا الموجز العام لرمز ملحق التجارة لاستهلاك الوظائف الموجودة وتخصيصها أو إنشاء وظائف جديدة لمنتج Dynamics 365 Commerce.
استهلك حزم التجارة من هذا الموقع، ويمكن للامتداد إضافة موقع مصدر الحزمة في nuget.config لملف مشروع الامتداد الخاص بهم.
<مصادر الحزمة>
<add key="dynamics365-commerce" value="https://pkgs.dev.azure.com/commerce-partner/Registry/_packaging/dynamics365-commerce/nuget/v3/index.json" />
<add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
</packageSources>| اسم الحزمة | وصف |
|---|---|
| Microsoft.Dynamics.Commerce.Sdk.ChannelDatabase | هذه الحزمة مطلوبة لإنشاء حزم قاعدة البيانات باستخدام CSU. |
| Microsoft.Dynamics.Commerce.Sdk.Runtime | تحتوي هذه الحزمة على كافة مكتبات وقت تشغيل التجارة |
| Microsoft.Dynamics.Commerce.Sdk.ScaleUnit | هذه الحزمة مطلوبة لإنشاء حزمة CSU للنشر. |
| Microsoft.Dynamics.Commerce.Sdk.Installers.ScaleUnit | هذه الحزمة مطلوبة لإنشاء حزمة ScaleUnit للنشر |
| Microsoft.Dynamics.Commerce.Sdk.HardwareAndPeripherals | تحتوي هذه الحزمة على كافة مكتبات محطات الأجهزة التجارية والأجهزة الطرفية |
| Microsoft.Dynamics.Commerce.Sdk.Installers | تحتوي هذه الحزمة على كافة مكتبات المثبتات |
| Microsoft.Dynamics.Commerce.Sdk.Installers.HardwareStation | هذه الحزمة مطلوبة لإنشاء حزمة محطة الأجهزة للنشر |
| Microsoft.Dynamics.Commerce.Sdk.Installers.StoreCommerce | هذه الحزمة مطلوبة لإنشاء مثبت ملحقات Store Commerce. |
| Microsoft.Dynamics.Commerce.Sdk.Pos | تحتوي هذه الحزمة على كافة مكتبات نقاط البيع |
| Microsoft.Dynamics.Commerce.Sdk.Installers.ModernPos | هذه الحزمة مطلوبة لإنشاء مثبت ملحق نقطة البيع للنشر |
| Microsoft.Dynamics.Commerce.Diagnostics | تحتوي هذه الحزمة على كافة المكتبات التشخيصية |
| Microsoft.Dynamics.Commerce.Runtime.Data | تحتوي هذه الحزمة على كافة مكتبات عقود البيانات |
| Microsoft.Dynamics.Commerce.Runtime.DataServices.Messages | تحتوي هذه الحزمة على كافة مكتبات رسائل خدمات البيانات |
| Microsoft.Dynamics.Commerce.Runtime.Entities | تحتوي هذه الحزمة على كافة تعريفات الكيانات التجارية |
| Microsoft.Dynamics.Commerce.Runtime.Framework | تحتوي هذه الحزمة على كافة مكتبات إطار التجارة |
| Microsoft.Dynamics.Commerce.Runtime.Hosting.Contracts | تحتوي هذه الحزمة على كافة مكتبات وحدات التحكم التجارية |
| Microsoft.Dynamics.Commerce.Runtime.Messages | تحتوي هذه الحزمة على كافة مكتبات رسائل وقت تشغيل التجارة |
| Microsoft.Dynamics.Commerce.Runtime.RealtimeServices.Messages | تحتوي هذه الحزمة على كافة مكتبات التشغيل الحقيقية للتجارة |
| Microsoft.Dynamics.Commerce.Runtime.Services.Messages | تحتوي هذه الحزمة على كافة مكتبات رسائل الخدمات التجارية |
| Microsoft.Dynamics.Commerce.HardwareStation.Core | تحتوي هذه الحزمة على كافة مكتبات HWS |
| Microsoft.Dynamics.Commerce.HardwareStation.PeripheralRequests | تحتوي هذه الحزمة على كافة مكتبات طلبات الأجهزة الطرفية لـ HWS |
| Microsoft.Dynamics.Commerce.HardwareStation.Peripherals.Contracts | تحتوي هذه الحزمة على كافة مكتبات عقود الأجهزة الطرفية لـ HWS |
| Microsoft.Dynamics.Commerce.HardwareStation.Peripherals.Entities | تحتوي هذه الحزمة على كافة مكتبات كيانات الأجهزة الطرفية لـ HWS |
| Microsoft.Dynamics.Commerce.Installers.Framework | تحتوي هذه الحزمة على كافة مكتبات إطار عمل المثبتات |
| Microsoft.Dynamics.Commerce.KeyVault.Contracts | تحتوي هذه الحزمة على كافة مكتبات عقود الخزنة الرئيسية |
| Microsoft.Dynamics.Commerce.PaymentSDK.Extensions.Portable | تحتوي هذه الحزمة على كافة مكتبات تمديد الدفع |
| Microsoft.Dynamics.Commerce.PaymentSDK.Portable | تحتوي هذه الحزمة على كافة مكتبات الدفع |
| Microsoft.Dynamics.Commerce.Runtime.FIF.Connector.Messages | تحتوي هذه الحزمة على كافة مكتبات موصلات FIF |
| Microsoft.Dynamics.Commerce.Runtime.FIF.DocumentProvider.Messages | تحتوي هذه الحزمة على كافة مكتبات موفر المستندات FIF |
| Microsoft.Dynamics.Commerce.Installers.Framework.DatabaseExtensions | تحتوي هذه الحزمة على كافة مكتبات إطار عمل مثبت قاعدة البيانات |
| Microsoft.Dynamics.Commerce.Tools.DbUtilities | تحتوي هذه الحزمة على كافة مكتبات أدوات قاعدة البيانات المساعدة |
| Microsoft.Dynamics.Commerce.Tools.ExtensionsProxyGenerator.AspNetCore | تحتوي هذه الحزمة على كافة الأدوات المساعدة لمولد الوكيل للملحقات |
| Microsoft.Dynamics.Commerce.Proxy.ScaleUnit | تحتوي هذه الحزمة على جميع فئات الوكلاء لتطبيقات الامتداد لاستهلاك واجهات برمجة تطبيقات التجارة بدون رأس في الوضع عبر الإنترنت (متصل بـ Headless Commerce). |
| نسخة الحزمة | الافراج عن التطبيق |
|---|---|
| 9.49.xx-معاينة | 10.0.39 إصدار PEAP |
| 9.49.xx | 10.0.39 معاينة العميل |
| 9.49.xx | 10.0.39 ج |
| 9.50.xx-معاينة | إصدار 10.0.40 PEAP |
| 9.50.xx | 10.0.40 معاينة العميل |
| 9.50.xx | 10.0.40 جيجا |
| 9.51.xx-معاينة | 10.0.41 إصدار PEAP |
| 9.51.xx | 10.0.41 معاينة العميل |
| 9.51.xx | 10.0.41 ج |
| 9.52.xx-معاينة | 10.0.42 إصدار PEAP |
| 9.52.xx | 10.0.42 معاينة العميل |
| 9.52.xx | 10.0.42 ج |
يمكن أن يستهلك مشروع الامتداد الإصدار الصحيح عن طريق إضافة مرجع الحزمة إلى المشروع برقم الإصدار الكامل أو استخدام Wild Card للحصول دائمًا على أحدث إصدار، والخيار الموصى به هو استخدام رقم الإصدار الكامل وتحديث الإصدار بناءً على إصدار البث المباشر الخاص بك .
<PackageReference Include = "Microsoft.Dynamics.Commerce.Sdk.Pos " الإصدار = "9.52.xx" />
أو
<PackageReference Include = "Microsoft.Dynamics.Commerce.Sdk.Pos " الإصدار = "9.52.*" />
مع كل إصلاح عاجل وإصدار تطبيق جديد، سيتم نشر إصدار جديد من الحزمة في نفس الخلاصة العامة، واستهلك إصدار الحزمة الصحيح بناءً على الإصدار المطلوب لبدء البث المباشر. قد يؤدي استهلاك الإصدار الأعلى من الحزمة من إصدار تطبيق البث المباشر الخاص بك إلى فشل وقت التشغيل والنشر.
إعداد مسار Azure DevOps لأتمتة البناء وإنشاء الحزم:
قم بإعداد مسار إنشاء لـ Commerce SDK
أفضل الممارسات واستراتيجيات التفرع:
معلومات تفصيلية عن استراتيجية تفرع git راجع وثيقة استراتيجية تفرع Git.
تعتمد استراتيجيات التفرع التالية على الطريقة التي نستخدم بها Git هنا في Microsoft. لمزيد من المعلومات، راجع كيف نستخدم Git في Microsoft.
حافظ على استراتيجية فرعك بسيطة. قم ببناء استراتيجيتك من هذه المفاهيم الثلاثة:
استخدم فروع الميزات لجميع الميزات الجديدة وإصلاحات الأخطاء.
دمج فروع الميزات في الفرع الرئيسي باستخدام طلبات السحب.
حافظ على فرع رئيسي عالي الجودة ومحدث.
قم بإنشاء فرع ميزات جديد للتطوير وإصلاح الأخطاء:
أنشئ فرعًا رئيسيًا لميزة جديدة لامتدادنا، واتبع اصطلاح التسمية المناسب (راجع مستند Git Branching للحصول على نموذج لاصطلاح التسمية)
إنشاء فرع تطوير جديد:
إنشاء فرع خاص للتطوير:
بوابة الخروج -b خاص/{اسم المستخدم}/{feature/description}
إضافة وتنفيذ تغييرات جديدة على فرع التطوير باستخدام git -add . و git الالتزام -m "رسالة الالتزام."
بعد اكتمال التطوير واختباره والتحقق من صحته، ادفع التغييرات إلى الفرع الرئيسي عن طريق القيام بـ git Push <remote> <فرع>
git Push Origin {اسم الفرع الخاص}
إنشاء فرع الإصدار بعد التطوير:
بعد دفع تغييرات التطوير إلى الفرع الرئيسي، قم بإنشاء فرع إصدار جديد، وقم بإنشاء الحزم القابلة للنشر من فرع الإصدار.
بوابة الخروج -b الإصدار/xxx
قم بدمج التغييرات من فرع الإصدار مرة أخرى إلى الفرع الرئيسي في حالة إجراء أي تغييرات في فرع الإصدار.
- git checkout master git merge release/x.x.xفرع الإصلاح العاجل الملحق:
مثل فرع الإصدار، قم بإنشاء فرع الإصلاح العاجل للتمديد من الفرع الرئيسي ثم قم بتحرير الإصلاح ثم قم بدمج التغييرات لاحقًا مرة أخرى إلى الفرع الرئيسي.
دمج فرع الإصدار الجديد في الفرع الرئيسي والتطوير:
بعد إصدار نسخة جديدة من العينات، قم بدمج فرع التطوير الخاص بك مع الفرع الجديد إذا لزم الأمر. يحتوي الريبو على عينات فقط، لذلك ليس من الضروري الحصول دائمًا على التغييرات المحدثة من الفرع.
- git checkout master git merge release/x.x.x 
