C API 설치

사전 요구 사항

시작하기 전에 Rust 툴체인과 clang 컴파일러가 설치되어 있는지 확인해야 합니다.

이제 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

이제 다음 섹션의 단계를 따라 qiskit-fermions C API를 컴파일할 수 있습니다.

소스에서 컴파일

시작하려면, 컴파일한 Qiskit C API 라이브러리와 include 디렉터리의 위치로 셸 환경을 구성하세요.

중요

C API는 Qiskit C 라이브러리에 링크되므로 QISKIT_LIB와 QISKIT_INCLUDE가 이를 가리켜야 합니다. 설정하지 않으면 빌드는 C 아티팩트를 함께 제공하는 설치된 qiskit Python 패키지에서 이를 추론하려고 시도합니다(qiskit.capi.get_lib()/get_include()). 위의 build/qiskit 클론처럼 별도로 컴파일한 Qiskit C API에 대해 빌드하려면 아래와 같이 명시적으로 설정하세요.

힌트

이 코드는 이 페이지 맨 위의 코드에 나온 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

이제 qiskit-fermions C API를 컴파일합니다.

make cext

설치를 테스트하려면 이제 CMake도 설치해야 합니다. 그런 다음 C 단위 테스트를 실행하여 컴파일을 테스트할 수 있습니다.

make testc

마지막으로, 다음 관련 파일이 보이는지 확인하세요.

• dist/c/lib/libqiskit_fermions.so (확장자는 운영 체제에 따라 다를 수 있습니다)

• dist/c/include/qiskit_fermions.h