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

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

Pré-requisitos

• Este artigo pressupõe que você já tenha a extensão Azure QDK instalada no Visual Studio Code. Se estiver a instalar pela primeira vez, veja o guia de instalação.

Atualizar a extensão de código do Visual Studio

Por padrão, o Visual Studio Code atualiza as extensões automaticamente. Após quaisquer atualizações, você será solicitado a recarregar o VS Code. Se preferir desativar as atualizações automáticas e as extensões de atualização manualmente, consulte Atualização automática de extensões na documentação do VS Code.

Atualizar os pacotes do Azure Quantum Python

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

   pip install --upgrade qsharp>=1.0
   

   Para adicionar suporte para a análise, transformação, geração de código e simulação de circuitos Qiskit, instale os pacotes qiskit e widget também.

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

   pip install --upgrade azure-quantum
   

Atualizar o pacote azure-quantum com suporte a Qiskit em um ambiente Python virtual (recomendado)

O pacote azure-quantum Python inclui suporte opcional para criar e enviar circuitos Qiskit para o Azure Quantum. Quando você instala o pacote azure-quantum com suporte ao Qiskit, ele 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 criar um ambiente Python virtual e instalar o azure-quantum lá.

Para criar um ambiente Python virtual e instalar o azure-quantum com suporte ao 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 você 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 você usou em seu ambiente anterior, conforme necessário. Você pode executar pip list em cada ambiente para comparar pacotes e versões.

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

Você também pode atualizar o pacote azure-quantum com suporte ao Qiskit sem usar um ambiente virtual. No entanto, as atualizações dos pacotes qiskit em um ambiente existente podem causar conflitos de dependência com outros pacotes. Consulte Alterações de empacotamento do Qiskit 1.0 para obter mais informações sobre 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 usando o parâmetro opcional [qiskit]:

   pip install azure-quantum[qiskit]
   

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

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

1. Abra uma linha de comandos do Windows.

2. No prompt de comando, execute

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