通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

将 Azure Quantum Development Kit （QDK） 更新到最新版本

  • 项目

了解如何将 Azure QDK 更新到最新版本。

先决条件

  • 本文假定已在 Visual Studio Code 上安装 Azure QDK 扩展。 如果是首次安装，请参阅安装指南。

更新 Visual Studio Code 扩展

默认情况下，Visual Studio Code 会自动更新扩展。 进行任何更新后，系统会提示重新加载 VS Code。 如果想要手动禁用自动更新和更新扩展，请参阅 VS Code 文档中的扩展自动更新 。

更新 Azure Quantum Python 包

重要

如果要从以前的 Qiskit 环境进行更新，请参阅在虚拟 Python 环境中使用 Qiskit 支持更新 azure-quantum 包（建议）。

  1. 使用 Python 包安装程序更新到最新 qsharp 包和 azure-quantum Python 包（pip）。

    pip install --upgrade qsharp>=1.0

    若要添加对 Qiskit 线路的分析、转换、代码生成和模拟的支持，请安装 qiskit 和 widget 包。

    pip install --upgrade qsharp[qiskit,widgets]>=1.0

    pip install --upgrade azure-quantum

azure-quantum Python 包包括用于创建 Qiskit 线路并将其提交到 Azure Quantum 的可选支持。 使用 Qiskit 支持安装 azure-quantum 包时，它会安装最新版本的 Qiskit，这可能会导致现有 Qiskit 环境出现问题。 为了确保稳定的开发环境，我们建议创建虚拟 Python 环境并在其中安装 azure-quantum。

若要创建虚拟 Python 环境并使用 Qiskit 支持安装 azure-quantum，请执行以下操作：

  1. 创建本地文件夹，例如 ~/qiskit10-env。

  2. 使用文件夹的路径运行venv

    python3 -m venv ~/qiskit10-env

  3. 激活该环境。

    ~/qiskit10-env/bin/activate

  4. 运行 pip list 并可以看到，在新环境中仅安装核心包。

  5. 若要安装 azure-quantum 包，请运行

    pip install azure-quantum[qiskit]

  6. 根据需要安装之前环境中使用的任何其他包。 可以在每个环境中运行 pip list 以比较包和版本。

注意

有关包兼容性的详细信息，请参阅 Qiskit 1.0 打包更改 。

注意

还可以在 VS Code 中打开虚拟环境。 在“视图”菜单中，选择“命令面板>>venv”。 在右下角，选择“ 打开文件夹...” ，然后选择之前创建的环境文件夹。 有关在 VS Code 中使用环境的详细信息，请参阅 VS Code 中的 Python 环境。

在当前环境中使用 Qiskit 支持更新 azure-quantum 包

还可以使用 Qiskit 支持更新 azure-quantum 包，而无需使用虚拟环境。 但是，对现有环境中的 qiskit 包的更新可能会导致与其他包发生依赖关系冲突。 有关包兼容性的详细信息，请参阅 Qiskit 1.0 打包更改 。

更新 azure-quantum 包：

  1. 卸载现有的 azure-quantum 和 qiskit 包：

    pip uninstall -y azure-quantum qiskit qiskit-terra qiskit-qir

  2. 使用可选的 [qiskit] 参数安装 azure-quantum：

    pip install azure-quantum[qiskit]

更新 Azure CLI 量子扩展

更新或安装最新的 Azure CLI quantum 扩展。

  1. 打开 Windows 命令提示符。

  2. 从命令提示符处运行

    az extension add \
    --upgrade \
    --name quantum