انتقل إلى المحتوى الرئيسي

تثبيت Qiskit SDK من المصدر

عندما تثبّت Qiskit SDK من المصدر، يمكنك الوصول إلى نسخة التطوير الحالية، بدلاً من استخدام النسخة المتاحة في مستودع Python Package Index (PyPI). يمكنك بذلك فحص أحدث إصدار من كود Qiskit وتوسيعه بكفاءة أكبر.

إنشاء بيئة افتراضية جديدة وتفعيلها

  1. انتقل إلى مجلد مشروعك وأنشئ بيئة بسيطة تحتوي على Python فقط.

    python3 -m venv .venv
  2. فعّل البيئة الجديدة.

    source .venv/bin/activate

تثبيت مترجم Rust

يجب أن يكون مترجم Rust مثبّتاً على نظامك لتجميع Qiskit. لتثبيت مترجم Rust، استخدم أداة التثبيت متعددة المنصات rustup أو طريقة تثبيت أخرى.

تثبيت Qiskit

اتبع هذه الخطوات لتثبيت Qiskit:

  1. استنسخ مستودع Qiskit.
git clone https://github.com/Qiskit/qiskit.git
  1. انتقل إلى مجلد qiskit.
cd qiskit
  1. (اختياري) إذا كنت تريد تشغيل الاختبارات أو فحوصات linting، ثبّت متطلبات المطوّر.
pip install -r requirements-dev.txt
  1. ثبّت qiskit.
  • التثبيت العادي:

    pip install .
  • وضع التعديل المباشر (Editable mode): في هذا الوضع لا تحتاج إلى إعادة تثبيت Qiskit عند إجراء تغييرات على كود المشروع.

    pip install -e .

    في وضع التعديل المباشر، تُبنى الامتدادات المُجمَّعة في وضع التصحيح (debug mode) بدون تحسينات. هذا يؤثر على أداء وقت التشغيل للكود المُجمَّع. لبناء الامتدادات المُجمَّعة مع تفعيل التحسينات، شغّل الأمر التالي لإعادة بناء الملف الثنائي في وضع الإصدار (release mode):

    python setup.py build_rust --release --inplace
    ملاحظة

    إذا كنت تعمل على كود Rust في Qiskit، فستحتاج إلى إعادة بناء كود الامتداد في كل مرة تُجري فيها تغييراً محلياً. في وضع التعديل المباشر، يُبنى امتداد Rust فقط عند تشغيل أمر التثبيت، لذا فإن التغييرات المحلية التي تجريها على كود Rust لن تنعكس في الحزمة المثبّتة ما لم تُعد بناء الامتداد بتشغيل build_rust من جديد (مع --release أو بدونها، حسب ما إذا كنت تريد البناء في وضع الإصدار أو وضع التصحيح).

الخطوات التالية

توصيات