התקנת ה-C API

דרישות מוקדמות

לפני שמתחילים, וודאו שהתקנתם את Rust toolchain וגם את מהדר clang.

עכשיו, שכפלו (clone) את המאגר qiskit-fermions.

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

בשלב הבא, צריך גם להדר את ה-C API של Qiskit. אפשר לעשות זאת בכל מיקום, אבל כדי להתחיל מהר, עקבו אחרי השלבים הבאים:

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

עכשיו אפשר לעקוב אחרי השלבים בסעיף הבא כדי להדר את ה-C API של qiskit-fermions.

הידור מקוד המקור

כדי להתחיל, הגדירו בסביבת ה-shell שלכם את המיקומים של ספריית ה-C API של Qiskit שהידרתם ושל תיקיית ה-include שלה.

חשוב

ה-C API מקושר מול ספריית ה-C של Qiskit, ולכן QISKIT_LIB ו-QISKIT_INCLUDE חייבים להצביע אליה. אם הם לא מוגדרים, הבנייה מנסה להסיק אותם מכל חבילת Python בשם qiskit מותקנת שכוללת את ארטיפקטי ה-C שלה (qiskit.capi.get_lib()/get_include()); הגדירו אותם במפורש, כמו בהמשך, כדי לבנות מול C API של Qiskit שהודר בנפרד, כמו השכפול 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

עכשיו, הדרו את ה-C API של qiskit-fermions:

make cext

אם אתם רוצים לבדוק את ההתקנה, צריך עכשיו להתקין גם את CMake. אחר כך אפשר לבדוק את ההידור על ידי הרצת בדיקות היחידה של C:

make testc

לבסוף, וודאו שאתם רואים את הקבצים הרלוונטיים הבאים:

• dist/c/lib/libqiskit_fermions.so (הסיומת עשויה להשתנות בהתאם למערכת ההפעלה שלכם)

• dist/c/include/qiskit_fermions.h