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

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

يتيح لك تثبيت 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 أو بدونها، حسب ما إذا كنت تريد البناء في وضع الإصدار أو وضع التصحيح).

تثبيت Qiskit Runtime​

اتبع هذه الخطوات إذا كنت تريد تثبيت Qiskit Runtime:

  1. استنسخ مستودع Qiskit Runtime.
git clone https://github.com/Qiskit/qiskit-ibm-runtime.git
  1. انتقل إلى مجلد qiskit-ibm-runtime.
cd qiskit-ibm-runtime
  1. ثبّت qiskit-runtime. نوصي باستخدام بيئة افتراضية لتجنّب التأثير على تثبيت Python العام.

  • التثبيت العادي:

    pip install .

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

    pip install -e .

    في وضع التعديل المباشر، تُبنى الامتدادات المُجمَّعة في وضع التصحيح (debug mode) بدون تحسينات.

  1. (اختياري) إذا كنت تريد تشغيل الاختبارات أو فحوصات linting، ثبّت متطلبات المطوّر. نوصي باستخدام بيئة افتراضية لتجنّب التأثير على تثبيت Python العام.
pip install -e ".[dev]"

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

توصيات