نحن نقوم بتحديث تجربة كاتاس الكم. يرجى زيارة https://quantum.microsoft.com/experience/quantum-katas لتجربة تجربة Quantum katas الجديدة عبر الإنترنت ، بمساعدة متكاملة من Copilot في Azure Quantum.
لمستودع QDK الحديث ، يرجى زيارة Microsoft/QSHARP.
لمزيد من المعلومات حول QDK Modern و Azure Quantum ، تفضل بزيارة https://aka.ms/aq/documentation.
Quantum katas هي مجموعة من البرامج التعليمية والبرمجة ذاتية الخطى لمساعدتك على تعلم الحوسبة الكمومية والبرمجة Q#.
كل كاتا هي مجموعة منفصلة من التمارين تتضمن:
تتضمن Quantum Katas أيضًا دروسًا تعرّف المتعلم للمفاهيم والخوارزميات الأساسية المستخدمة في الحوسبة الكمومية ، بدءًا من الرياضيات الضرورية (الأرقام المعقدة والجبر الخطي). يتبعون نفس نمط تكملة النظرية مع Q# التجريبي وتمارين البرمجة العملية.
فيما يلي مسار التعلم الذي نقترح عليك اتباعه إذا كنت تبدأ في تعلم الحوسبة الكمومية والبرمجة الكمومية. بمجرد أن تشعر بالراحة مع الأساسيات ، فأنت مرحبًا بك في القفز إلى المواضيع التي تثير اهتمامك!
للحصول على ورقة مرجعية سريعة لبرمجة Q# ، راجع مرجع Q# Language Quick.
تتوفر الآن Quantum Katas كـ Jupyter Notebooks Online! راجع index.ipynb للحصول على قائمة جميع الكاتاس والبرامج التعليمية ، والتعليمات لتشغيلها عبر الإنترنت.
لاحظ أن MyBinder.org يعمل بسعة مخفضة ، وبالتالي فإن الحصول على جهاز افتراضي وإطلاق دفاتر الملاحظات قد يستغرق عدة محاولات. أثناء تشغيل Katas Online هو الخيار الأسهل للبدء ، إذا كنت ترغب في توفير تقدمك والاستمتاع بأداء أفضل ، فإننا نوصيك باختيار خيار الإعداد المحلي.
لاستخدام Quantum Katas محليًا ، ستحتاج إلى مجموعة تطوير الكم ، المتاحة لنظام التشغيل Windows 10 و MacOS و Linux. إذا لم يكن لديك بالفعل مجموعة تطوير الكم ، راجع دليل التثبيت لمجموعة تطوير الكم.
إذا كنت ترغب في تشغيل الكاتاس والدروس التعليمية محليًا كـ Jupyter Notebooks :
pytest .matplotlib .matplotlib و numpy .الرجوع إلى تحديث kernel iq# لتحديث kernel iq# إلى إصدار جديد مع إصدارات QDK شهرية.
إذا كنت ترغب في تشغيل Katas ودروس التعليمية محليًا كمشاريع Q# :
اتبع الخطوات في دليل تثبيت QDK لاستوديو Visual أو رمز Visual Studio أو محررين آخرين.
يتطلب تشغيل مشاريع Q# من Katas محليًا تنزيل وتثبيت .NET 6.0 SDK. يمكنك القيام بذلك حتى لو كان لديك إصدار .NET آخر ، حيث يتم دعم إصدارات متعددة جنبًا إلى جنب.
نظرًا لأن Visual Studio 2019 لا يدعم مشاريع .NET 6.0 ، ستحتاج إلى الترقية إلى Visual Studio 2022 وتثبيت ملحق Microsoft Quantum Development.
إذا قمت بتثبيت GIT ، استنسخ مستودع Microsoft/QuantumKatas:
$ git clone https://github.com/Microsoft/QuantumKatas.gitنصيحة
يجعل كل من Visual Studio 2022 و Visual Studio Code من السهل استنساخ المستودعات من داخل بيئة التطوير الخاصة بك. للحصول على التفاصيل ، راجع وثائق Visual Studio و Visual Studio Code.
إذا لم يكن لديك GIT مثبت ، قم بتنزيل Katas من https://github.com/microsoft/quantumkatas/archive/main.zip.
أفضل طريقة لتشغيل katas كـ Jupyter Notebooks هي الانتقال إلى المجلد الجذري للمستودع وفتح index.ipynb باستخدام jupyter:
$ cd QuantumKatas/
$ jupyter notebook index.ipynbسيؤدي ذلك إلى فتح دفتر الملاحظات الذي يحتوي على قائمة بجميع كاتا والبرامج التعليمية ، وستتمكن من الانتقال إلى تلك التي تريدها باستخدام الروابط.
ملاحظة: سيبدأ هذا خادم Notebooks Jupyter في نافذة سطر الأوامر نفسه الذي استخدمته لتشغيل الأمر. إذا كنت ترغب في الاستمرار في استخدام هذه النافذة للتنقل ، فيمكنك تشغيل خادم Jupyter Notebooks في نافذة جديدة باستخدام الأوامر التالية:
لنظام التشغيل Windows:
$ cd QuantumKatas/ $ start jupyter notebook index.ipynbلأوبونتو:
$ cd QuantumKatas/ $ gnome-terminal -- start jupyter notebook index.ipynb
يمكنك أيضًا فتح دفتر ملاحظات فردي مباشرة ، ولكن هذا قد يجعل الروابط الداخلية غير صالحة:
$ cd QuantumKatas/tutorials/ComplexArithmetic
$ jupyter notebook ComplexArithmetic.ipynbكل kata في دليلها الخاص كمشروع Q# المستقل ذاتيا ، والحل و jupyter Notebook Triplet. على سبيل المثال ، هيكل دليل BasicGates هو:
QuantumKatas/
BasicGates/
README.md # Instructions specific to this kata.
.vscode/ # Metadata used by Visual Studio Code.
BasicGates.sln # Visual Studio solution file.
BasicGates.csproj # Project file used to build both classical and quantum code.
BasicGates.ipynb # Jupyter Notebook front-end for this kata.
Workbook_BasicGates.ipynb # Jupyter Notebook workbook for this kata.
Tasks.qs # Q# source code that you will fill as you solve each task.
Tests.qs # Q# tests that verify your solutions.
ReferenceImplementation.qs # Q# source code containing solutions to the tasks.لفتح BasicGates Kata في Visual Studio 2022 ، افتح ملف حل الكمية/BasicGates/BasicGates.sln .
لفتح Basicgates Kata في Visual Studio Code ، افتح CustomKatas/ BasicGates/ Folder. اضغط على Ctrl + Shift + P (أو ⌘ + Shift + P على MacOS) لفتح لوحة الأوامر . اكتب مجلد مفتوح على Windows 10 أو Linux أو فتح على MacOS.
نصيحة
تقع جميع الأوامر المتوفرة تقريبًا في Visual Studio Code في لوحة الأوامر. إذا تعثرت ، اضغط على Ctrl + Shift + P (أو ⌘ + Shift + P على MacOS) وابدأ الكتابة للبحث من خلال جميع الأوامر المتاحة.يمكنك أيضًا تشغيل رمز Visual Studio من سطر الأوامر:
$ code QuantumKatas/BasicGates/
بمجرد فتح Kata ، حان الوقت لتشغيل الاختبارات باستخدام التعليمات التالية. في البداية ستفشل جميع الاختبارات. لا تُصب بالذعر! افتح المهام. كل مهمة مغطاة باختبار الوحدة. بمجرد ملء الكود الصحيح لمهمة ما ، إعادة بناء المشروع وإعادة تشغيل الاختبارات ، وسيمر اختبار الوحدة المقابلة.
cd .dotnet test في المحطة المتكاملة. هذا يجب أن يبني مشروع KATA وتشغيل جميع اختبارات الوحدة. يجب أن تفشل جميع اختبارات الوحدة.dotnet test المدمج مرة أخرى.للراحة ، يوجد ملف تكوين المهام. يسمح لبرنامج Visual Studio بتشغيل خطوات الإنشاء واختبارها من لوحة الأوامر. اضغط على Ctrl + Shift + P (أو ⌘ + shift + p على macOS) لفتح Palette و type Run Build Task أو تشغيل مهمة الاختبار واضغط على Enter .
يمكنك استخدام DockerFile المضمّن لإنشاء صورة Docker مع جميع الأدوات اللازمة لتشغيل Katas من سطر الأوامر أو Jupyter.
katas : docker build -t katas .katas-container مع سطر أوامر تفاعلي ومنفذ الحاوية إعادة توجيه 8888 إلى المنفذ المحلي 8888 (مطلوب لتشغيل jupyter): docker run -it --name katas-container -p 8888:8888 katas /bin/bash cd ~ /BasicGates/
dotnet test cd ~ /BasicGates/ && jupyter notebook --ip=0.0.0.0 --no-browser http://localhost:8888/notebooks/BasicGates.ipynb
للخروج من حاوية Docker دون قتلها (وضع Daemon) ، اضغط على Ctrl+P ، Ctrl+Q
لإعادة إدخال katas-container الحالي (في وضع الخفي):
docker attach katas-container بمجرد الانتهاء ، قم بإزالة katas-container :
docker rm --force katas-containerيرحب هذا المشروع بالمساهمات والاقتراحات. انظر كيف يمكنني المساهمة؟ لمزيد من التفاصيل.
اعتمد هذا المشروع رمز سلوك المصدر المفتوح Microsoft. لمزيد من المعلومات ، راجع مدونة الشهادة الأسئلة الشائعة أو الاتصال بـ [email protected] مع أي أسئلة أو تعليقات إضافية.