Instalacja C API

Wymagania wstępne

Zanim zaczniesz, upewnij się, że masz zainstalowany zestaw narzędzi Rust oraz kompilator clang.

Teraz sklonuj repozytorium qiskit-fermions.

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

Następnie musisz również skompilować C API Qiskit. Możesz to zrobić w dowolnym miejscu, ale aby szybko zacząć, wykonaj poniższe kroki:

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

Wskazówka

Tylko w systemie Windows musisz skopiować dodatkowe pliki bibliotek:

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

Teraz możesz wykonać kroki z następnej sekcji, aby skompilować C API qiskit-fermions.

Kompilacja ze źródeł

Na początek skonfiguruj środowisko powłoki, podając lokalizacje skompilowanej biblioteki C API Qiskit oraz katalogu include.

Ważne

C API linkuje się z biblioteką C Qiskit, więc QISKIT_LIB i QISKIT_INCLUDE muszą na nią wskazywać. Jeśli nie są ustawione, kompilacja próbuje wywnioskować je z dowolnego zainstalowanego pakietu Pythona qiskit, który zawiera swoje artefakty C (qiskit.capi.get_lib()/get_include()); ustaw je jawnie, jak poniżej, aby kompilować względem osobno skompilowanego C API Qiskit, takiego jak klon build/qiskit powyżej.

Wskazówka

Ten kod używa ścieżki build/qiskit z kodu na początku tej strony. Dostosuj ścieżki do swojej konfiguracji.

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

Teraz skompiluj C API qiskit-fermions:

make cext

Jeśli chcesz przetestować instalację, musisz teraz zainstalować także CMake. Następnie możesz przetestować kompilację, uruchamiając testy jednostkowe w C:

make testc

Na koniec sprawdź, czy widzisz te istotne pliki:

• dist/c/lib/libqiskit_fermions.so (Sufiks może się różnić w zależności od systemu operacyjnego)

• dist/c/include/qiskit_fermions.h