ติดตั้ง C API

สิ่งที่ต้องมีก่อน

ก่อนเริ่มต้น คุณต้องติดตั้ง Rust toolchain และ คอมไพเลอร์ clang ให้เรียบร้อย

จากนั้นโคลน repository qiskit-fermions

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

ถัดไป คุณต้องคอมไพล์ Qiskit C API ด้วย จะทำที่ตำแหน่งไหนก็ได้ แต่หากต้องการเริ่มอย่างรวดเร็ว ให้ทำตามขั้นตอนเหล่านี้:

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 environment ของคุณให้ชี้ไปยังตำแหน่งของไลบรารี Qiskit C API ที่คอมไพล์แล้วและไดเรกทอรี include

สำคัญ

C API ลิงก์กับไลบรารี C ของ Qiskit ดังนั้น QISKIT_LIB และ QISKIT_INCLUDE ต้องชี้ไปที่ไลบรารีนั้น หากไม่ได้ตั้งค่า ระบบ build จะพยายามอนุมานจากแพ็กเกจ Python qiskit ที่ติดตั้งอยู่ซึ่งรวม C artifact ไว้ (qiskit.capi.get_lib()/get_include()) ให้ตั้งค่าอย่างชัดเจนตามด้านล่างเพื่อ build กับ 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

จากนั้นคอมไพล์ C API ของ qiskit-fermions:

make cext

หากต้องการทดสอบการติดตั้ง คุณต้องติดตั้ง CMake ด้วย จากนั้นทดสอบการคอมไพล์ได้โดยรัน C unit test:

make testc

สุดท้าย ตรวจสอบว่าคุณเห็นไฟล์สำคัญเหล่านี้:

• dist/c/lib/libqiskit_fermions.so (นามสกุลอาจแตกต่างกันไปตามระบบปฏิบัติการของคุณ)

• dist/c/include/qiskit_fermions.h