Atualizar o Azure Quantum Development Kit (QDK Moderno) para a versão mais recente

  • Artigo

Saiba como atualizar o QDK Moderno para a versão mais recente.

Pré-requisitos

  • Este artigo pressupõe que já tem o QDK Moderno instalado. Se estiver a instalar pela primeira vez, veja o guia de instalação.

  • Se estiver a trabalhar com programas que requerem o Microsoft Quantum Development Kit (QDK Clássico), como a computação híbrida integrada, veja Continuar a trabalhar com o QDK Clássico.

Atualizar a extensão do Visual Studio Code

Por predefinição, o Visual Studio Code atualiza as extensões automaticamente. Após quaisquer atualizações, ser-lhe-á pedido para recarregar o VS Code. Se preferir desativar as atualizações automáticas e atualizar as extensões manualmente, veja Atualização automática da extensão na documentação do VS Code.

Atualizar os pacotes do Azure Quantum Python

Importante

Se estiver a atualizar a partir de um ambiente do Qiskit anterior, veja Atualizar o pacote azure-quantum com suporte do Qiskit num ambiente python virtual (recomendado).

  1. Atualize para os pacotes Python mais recentes qsharp e azure-quantum com o instalador de pacotes para Python (pip).

    pip install --upgrade qsharp>=1.0

    pip install --upgrade azure-quantum

O pacote Python azure-quantum inclui suporte opcional para criar e submeter circuitos qiskit para o Azure Quantum. Quando instala o pacote azure-quantum com suporte do Qiskit, este instala a versão mais recente do Qiskit, o que pode causar problemas com um ambiente qiskit existente. Para garantir um ambiente de desenvolvimento estável, recomendamos a criação de um ambiente Python virtual e a instalação do azure-quantum.

Para criar um ambiente python virtual e instalar o azure-quantum com suporte do Qiskit:

  1. Crie uma pasta local, por exemplo ~/qiskit10-env.

  2. Executar venv com o caminho para a pasta

    python3 -m venv ~/qiskit10-env

  3. Ative o ambiente.

    ~/qiskit10-env/bin/activate

  4. Execute pip list e pode ver que apenas os pacotes principais estão instalados no novo ambiente.

  5. Para instalar o pacote azure-quantum, execute

    pip install azure-quantum[qiskit]

  6. Instale quaisquer outros pacotes que tenha utilizado no seu ambiente anterior, conforme necessário. Pode executar pip list em cada ambiente para comparar pacotes e versões.

Nota

Veja Alterações de empacotamento do Qiskit 1.0 para obter mais informações sobre a compatibilidade de pacotes.

Nota

Também pode abrir o ambiente virtual no VS Code. No menu Ver, selecione Paleta > de ComandosPython: Criar Venv de Ambiente>. No canto inferior direito, selecione Abrir Pasta... e selecione a pasta de ambiente que criou anteriormente. Para obter mais informações sobre como utilizar ambientes no VS Code, veja Ambientes python no VS Code.

Atualizar o pacote azure-quantum com suporte do Qiskit no ambiente atual

Também pode atualizar o pacote azure-quantum com suporte do Qiskit sem utilizar um ambiente virtual. No entanto, as atualizações aos pacotes qiskit num ambiente existente podem causar conflitos de dependência com outros pacotes. Veja Alterações de empacotamento do Qiskit 1.0 para obter mais informações sobre a compatibilidade de pacotes.

Para atualizar o pacote azure-quantum:

  1. Desinstale os pacotes azure-quantum e qiskit existentes:

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

  2. Instale o azure-quantum com o parâmetro opcional [qiskit]:

    pip install azure-quantum[qiskit]

Atualizar a extensão quântica da CLI do Azure

  1. Atualize ou instale a extensão mais recente da CLI quantum do Azure.

    az extension add --upgrade --name quantum