eShop

تطبيق مرجع eShop - "AdventureWorks"

تطبيق .NET Application تطبيق موقع ويب للتجارة الإلكترونية باستخدام بنية قائمة على الخدمات باستخدام .NET Aspire.

ابدء

يعتمد هذا الإصدار من ESHOP على .NET 9.

إصدارات eShop السابقة:

• .NET 8

المتطلبات الأساسية

• استنساخ مستودع eShop: https://github.com/dotnet/eshop
• تثبيت وبدء سطح المكتب Docker

Windows مع Visual Studio

• تثبيت Visual Studio 2022 الإصدار 17.10 أو الأحدث.
  • حدد أعباء العمل التالية:
    • ASP.NET and web development .
    • .NET Aspire SDK مكون في Individual components .
    • اختياري: .NET Multi-platform App UI development لتشغيل تطبيقات العميل

أو

• قم بتشغيل الأوامر التالية في PowerShell & Terminal تعمل Administrator لتكوين بيئتك تلقائيًا مع الأدوات المطلوبة لإنشاء هذا التطبيق وتشغيله. (ملاحظة: مطلوب إعادة تشغيل وإدراج في البرنامج النصي أدناه.)

 install-Module - Name Microsoft.WinGet.Configuration - AllowPrerelease - AcceptLicense - Force
$ env: Path = [ System.Environment ]::GetEnvironmentVariable( " Path " , " Machine " ) + " ; " + [ System.Environment ]::GetEnvironmentVariable( " Path " , " User " )
get-WinGetConfiguration - file ..configurationsvside.dsc.yaml | Invoke-WinGetConfiguration - AcceptConfigurationAgreements

أو

• من Dev Home انتقل إلى Machine Configuration -> Clone repositories . أدخل عنوان URL لهذا المستودع. في شاشة التأكيد ، ابحث عن Configuration File Detected وانقر فوق Run File .

Mac و Linux و Windows بدون Visual Studio

• تثبيت أحدث .NET 9 SDK

أو

• قم بتشغيل الأوامر التالية في PowerShell & Terminal تعمل Administrator لتكوين بيئتك تلقائيًا مع الأدوات المطلوبة لإنشاء هذا التطبيق وتشغيله. (ملاحظة: مطلوب إعادة تشغيل بعد تشغيل البرنامج النصي أدناه.)

تثبيت رمز الاستوديو المرئي والملحقات ذات الصلة

 install-Module - Name Microsoft.WinGet.Configuration - AllowPrerelease - AcceptLicense  - Force
$ env: Path = [ System.Environment ]::GetEnvironmentVariable( " Path " , " Machine " ) + " ; " + [ System.Environment ]::GetEnvironmentVariable( " Path " , " User " )
get-WinGetConfiguration - file ..configurationsvscode.dsc.yaml | Invoke-WinGetConfiguration - AcceptConfigurationAgreements

ملاحظة: قد تتطلب هذه الأوامر sudo

• اختياري: قم بتثبيت رمز Visual Studio باستخدام C# Dev Kit
• اختياري: تثبيت .NET MAUI عبء العمل

ملاحظة: عند تشغيل Mac باستخدام Apple Silicon (معالج سلسلة M) ، Rosetta 2 لأدوات GRPC.

تشغيل الحل

تحذير

تذكر التأكد من بدء Docker

• (Windows فقط) قم بتشغيل التطبيق من Visual Studio:

• افتح ملف eShop.Web.slnf في Visual Studio
• تأكد من أن eShop.AppHost.csproj هو مشروع بدء التشغيل الخاص بك
• اضغط على CTRL-F5 لإطلاق Aspire

• أو قم بتشغيل التطبيق من المحطة الخاصة بك:

dotnet run -- project src / eShop.AppHost / eShop.AppHost.csproj

ثم ابحث عن خطوط مثل هذه في إخراج وحدة التحكم من أجل العثور على عنوان URL لفتح لوحة معلومات Aspire:

Login to the dashboard at: http://localhost:19888/login ? t=uniquelogincodeforyou

قد تحتاج إلى تثبيت شهادات تطوير HTTPS ASP.NET Core أولاً ، ثم إغلاق جميع علامات التبويب المتصفح. تعرف على المزيد في https://aka.ms/aspnet/https-trust-dev-cert

Azure فتح الذكاء الاصطناعي

عند استخدام Azure Openai ، Inside eshop.apphost/appsettings.json ، أضف القسم التالي:

  "ConnectionStrings" : {
    "OpenAi" : " Endpoint=xxx;Key=xxx; "
  }

استبدل القيم بمنطقك. ثم ، في برنامج eShop.apphost.cs ، قم بتعيين هذه القيمة على True

 bool useOpenAI = false ;

فيما يلي إرشادات إضافية على مكون .NET Aspire Openai.

استخدم مطور Azure CLI

يمكنك استخدام مطور Azure CLI لتشغيل هذا المشروع على Azure مع عدد قليل من الأوامر. اتبع التعليمات التالية:

• قم بتثبيت أحدث أو تحديث لأحدث مطور Azure CLI (AZD).
• قم بتسجيل الدخول إلى azd (إذا لم تكن قد فعلت ذلك من قبل) إلى حساب Azure الخاص بك:

azd auth login

• تهيئة azd من جذر الريبو.

azd init

• خلال init:

  • حدد Use code in the current directory . سوف AZD الكشف تلقائيا مشروع .NET Aspire.
  • تأكيد .NET (Aspire) واستمر.
  • حدد الخدمات التي يجب تعريضها للإنترنت (تعريض webapp كافٍ لاختبار العينة).
  • وضع اللمسات الأخيرة على التهيئة عن طريق إعطاء اسم لبيئتك.

• إنشاء موارد Azure ونشر العينة عن طريق التشغيل:

azd up

ملحوظات:

• تستغرق العملية بضع دقائق في المرة الأولى التي يتم فيها تشغيلها للبيئة.
• في نهاية العملية ، ستعرض azd url لـ WebApp. اتبع هذا الرابط لاختبار العينة.
• يمكنك تشغيل azd up بعد حفظ التغييرات على العينة لإعادة النشر وتحديث العينة.
• الإبلاغ عن أي قضايا إلى Azure-dev repo.
• الأسئلة الشائعة واستكشاف الأخطاء وإصلاحها ل AZD.

المساهمة

لمزيد من المعلومات حول المساهمة في هذا الريبو ، اقرأ وثائق المساهمة وقواعد السلوك.

عينة البيانات

يتم تعريف بيانات Catalog عينة في Catalog.json. هذه أسماء المنتجات والأوصاف والأسماء التجارية خيالية وتم إنشاؤها باستخدام GPT-35-Turbo ، وتم إنشاء صور المنتج المقابلة باستخدام Dall · E 3.

eShop على أزور

للحصول على إصدار من هذا التطبيق الذي تم تكوينه للنشر على Azure ، يرجى عرض eShop على Azure Repo.