Die C-API installieren

Voraussetzungen

Bevor du beginnst, musst du sicherstellen, dass du die Rust-Toolchain sowie den clang-Compiler installiert hast.

Klone nun das Repository qiskit-fermions.

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

Als Nächstes musst du auch die Qiskit-C-API kompilieren. Das kannst du an einem beliebigen Ort tun, aber für einen schnellen Start folge diesen Schritten:

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

Hinweis

Nur unter Windows musst du zusätzliche Bibliotheksdateien kopieren:

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

Jetzt kannst du den Schritten im nächsten Abschnitt folgen, um die C-API von qiskit-fermions zu kompilieren.

Aus dem Quellcode kompilieren

Konfiguriere zunächst deine Shell-Umgebung mit den Speicherorten deiner kompilierten Qiskit-C-API-Bibliothek und des Include-Verzeichnisses.

Wichtig

Die C-API linkt gegen die Qiskit-C-Bibliothek, daher müssen QISKIT_LIB und QISKIT_INCLUDE darauf verweisen. Wenn sie nicht gesetzt sind, versucht der Build, sie aus einem installierten Python-Paket qiskit abzuleiten, das seine C-Artefakte mitliefert (qiskit.capi.get_lib()/get_include()); setze sie explizit wie unten gezeigt, um gegen eine separat kompilierte Qiskit-C-API wie den Klon build/qiskit oben zu bauen.

Hinweis

Dieser Code verwendet den Pfad build/qiskit aus dem Code am Anfang dieser Seite. Passe die Pfade an dein Setup an.

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

Kompiliere nun die C-API von qiskit-fermions:

make cext

Wenn du deine Installation testen möchtest, musst du jetzt auch CMake installieren. Anschließend kannst du deine Kompilierung testen, indem du die C-Unit-Tests ausführst:

make testc

Prüfe abschließend, ob du diese relevanten Dateien siehst:

• dist/c/lib/libqiskit_fermions.so (Die Endung kann je nach Betriebssystem variieren)

• dist/c/include/qiskit_fermions.h