Instal C API

Prasyarat

Sebelum mulai, pastikan kamu sudah menginstal Rust toolchain serta compiler clang.

Sekarang, clone repositori qiskit-fermions.

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

Selanjutnya, kamu juga harus mengompilasi Qiskit C API. Kamu bisa melakukannya di lokasi mana pun, tapi supaya cepat mulai, ikuti langkah-langkah berikut:

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

Petunjuk

Khusus di Windows, kamu perlu menyalin file pustaka tambahan:

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

Sekarang kamu bisa mengikuti langkah-langkah di bagian berikutnya untuk mengompilasi C API qiskit-fermions.

Kompilasi dari sumber

Untuk memulai, konfigurasikan environment shell-mu dengan lokasi pustaka Qiskit C API hasil kompilasi dan direktori include-nya.

Penting

C API ini ditautkan ke pustaka C Qiskit, jadi QISKIT_LIB dan QISKIT_INCLUDE harus mengarah ke sana. Kalau tidak diatur, build akan mencoba menyimpulkannya dari paket Python qiskit terinstal yang menyertakan artefak C-nya (qiskit.capi.get_lib()/get_include()); atur keduanya secara eksplisit, seperti di bawah, untuk membangun terhadap Qiskit C API yang dikompilasi terpisah seperti clone build/qiskit di atas.

Petunjuk

Kode ini memakai path build/qiskit dari kode di bagian atas halaman ini. Sesuaikan path-nya dengan setup-mu.

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

Sekarang, kompilasi C API qiskit-fermions:

make cext

Kalau mau menguji instalasimu, sekarang kamu juga harus menginstal CMake. Setelah itu kamu bisa menguji hasil kompilasi dengan menjalankan unit test C:

make testc

Terakhir, pastikan file-file relevan berikut muncul:

• dist/c/lib/libqiskit_fermions.so (Sufiksnya bisa berbeda tergantung sistem operasimu)

• dist/c/include/qiskit_fermions.h