تثبيت واجهة C البرمجية

المتطلبات المسبقة

قبل البدء، يجب أن تتأكد من تثبيت سلسلة أدوات Rust وكذلك مترجم clang.

الآن، انسخ مستودع qiskit-fermions.

git clone git@github.com:Qiskit/qiskit-fermions.git
cd qiskit-fermions

بعد ذلك، يجب أيضًا أن تُصرِّف واجهة Qiskit C البرمجية. يمكنك فعل ذلك في أي مكان، لكن للبدء بسرعة اتبع هذه الخطوات:

git clone git@github.com:Qiskit/qiskit.git build/qiskit
cd build/qiskit
## git-checkout the latest stable tag
make c

تلميح

على Windows فقط، تحتاج إلى نسخ ملفات مكتبات إضافية:

Windows

cp target/release/qiskit_cext.dll dist/c/lib/qiskit_cext.dll
cp target/release/qiskit_cext.dll.lib dist/c/lib/qiskit_cext.dll.lib
cp target/release/qiskit_cext.dll.lib dist/c/lib/qiskit.dll.lib

الآن يمكنك اتباع الخطوات في القسم التالي لتصريف واجهة qiskit-fermions C البرمجية.

التصريف من المصدر

للبدء، اضبط بيئة الصدفة لديك بمواقع مكتبة Qiskit C API المُصرَّفة ودليل ملفات الترويسة (include).

مهم

ترتبط واجهة C البرمجية بمكتبة Qiskit C، لذا يجب أن يشير QISKIT_LIB وQISKIT_INCLUDE إليها. وإن لم يُضبطا، تحاول عملية البناء استنتاجهما من أي حزمة qiskit لـ Python مثبّتة تضم ملفاتها الخاصة بـ C (qiskit.capi.get_lib()/get_include())؛ اضبطهما صراحةً، كما في الأسفل، للبناء مقابل Qiskit C API مُصرَّفة بشكل منفصل مثل نسخة build/qiskit أعلاه.

تلميح

تستخدم هذه الشيفرة المسار build/qiskit من الشيفرة في أعلى هذه الصفحة. عدّل المسارات بما يناسب إعدادك.

UNIX

export QISKIT_LIB=$(find $(pwd)/build/qiskit/dist/c/lib -name "libqiskit.*")
export QISKIT_INCLUDE=$(pwd)/build/qiskit/dist/c/include

Windows

export QISKIT_LIB=$(find $(pwd)/build/qiskit/dist/c/lib -name "qiskit_cext.dll.lib")
export QISKIT_INCLUDE=$(pwd)/build/qiskit/dist/c/include

الآن، صرِّف واجهة qiskit-fermions C البرمجية:

make cext

إذا أردت اختبار تثبيتك، فعليك الآن أيضًا تثبيت CMake. ويمكنك بعدها اختبار التصريف بتشغيل اختبارات الوحدات بلغة C:

make testc

وأخيرًا، تحقق من ظهور هذه الملفات المهمة:

• dist/c/lib/libqiskit_fermions.so (قد يختلف اللاحق بحسب نظام التشغيل لديك)

• dist/c/include/qiskit_fermions.h