ข้ามไปยังเนื้อหาหลัก

ติดตั้ง Qiskit SDK จากซอร์ส

เมื่อติดตั้ง Qiskit SDK จากซอร์ส สามารถเข้าถึงเวอร์ชัน development ปัจจุบันได้ แทนที่จะใช้เวอร์ชันจาก Python Package Index (PyPI) จึงสามารถตรวจสอบและขยายโค้ด Qiskit เวอร์ชันล่าสุดได้อย่างมีประสิทธิภาพมากขึ้น

สร้างและเปิดใช้งาน virtual environment ใหม่

  1. ไปยัง project directory และสร้าง environment เบื้องต้นที่มีแค่ Python ติดตั้งอยู่

    python3 -m venv .venv
  2. เปิดใช้งาน environment ใหม่

    source .venv/bin/activate

ติดตั้ง Rust compiler

ต้องติดตั้ง Rust compiler บนระบบเพื่อ compile Qiskit ใช้ rustup ซึ่งเป็น Rust installer ข้ามแพลตฟอร์ม หรือ วิธีติดตั้งอื่น

ติดตั้ง Qiskit

ทำตามขั้นตอนเหล่านี้เพื่อติดตั้ง Qiskit:

  1. Clone Qiskit repository
git clone https://github.com/Qiskit/qiskit.git
  1. เข้าไปยัง directory qiskit
cd qiskit
  1. (ไม่บังคับ) ถ้าต้องการรัน tests หรือ linting checks ให้ติดตั้ง developer requirements
pip install -r requirements-dev.txt
  1. ติดตั้ง qiskit
  • Standard install:

    pip install .
  • Editable mode: ในโหมดนี้ไม่จำเป็นต้องติดตั้ง Qiskit ใหม่เมื่อมีการเปลี่ยนแปลงโค้ดในโปรเจกต์

    pip install -e .

    ใน editable mode extension ที่ compile แล้วจะถูก build ใน debug mode โดยไม่มีการ optimize ซึ่งส่งผลต่อ runtime performance ของโค้ดที่ compile แล้ว เพื่อ build extension เหล่านั้นพร้อมการ optimize ให้รันคำสั่งต่อไปนี้เพื่อ rebuild binary ใน release mode:

    python setup.py build_rust --release --inplace
    หมายเหตุ

    ถ้ากำลังทำงานกับโค้ด Rust ใน Qiskit จะต้อง rebuild extension code ทุกครั้งที่แก้ไขโค้ดใน local ใน editable mode Rust extension จะถูก build เฉพาะตอนรันคำสั่งติดตั้งเท่านั้น ดังนั้นการเปลี่ยนแปลงโค้ด Rust ใน local จะไม่สะท้อนใน package ที่ติดตั้งจนกว่าจะ rebuild extension โดยรัน build_rust ใหม่อีกครั้ง (ใช้หรือไม่ใช้ --release ขึ้นอยู่กับว่าต้องการ build ใน release หรือ debug mode)

ขั้นตอนถัดไป

Recommendations