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

Artigo
09/12/2024

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

Pré-requisitos

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

Atualizar a extensão do Visual Studio Code

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

Atualizar os pacotes do Python do Azure Quantum

Importante

Se você estiver atualizando de um ambiente Qiskit anterior, consulte Atualizar o pacote azure-quantum com suporte ao Qiskit em um ambiente virtual do Python (recomendado).

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
```
```
pip install --upgrade azure-quantum
```

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

O pacote Python azure-quantum 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 virtual do Python e instalar o azure-quantum lá.

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

Crie uma pasta local, por exemplo ~/qiskit10-env.
Execute venv com o caminho para a pasta
```
python3 -m venv ~/qiskit10-env
```
Ative o ambiente.
```
~/qiskit10-env/bin/activate
```
Execute pip list e você poderá ver que apenas os pacotes principais estão instalados no novo ambiente.
Para instalar o pacote azure-quantum, execute
```
pip install azure-quantum[qiskit]
```
Instale todos os 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.

Observação

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

Observação

Você também pode abrir seu ambiente virtual no VS Code. No menu Exibir, selecione Paleta de Comandos>Python: Criar Ambiente>venv. No canto inferior direito, selecione Abrir pasta... e selecione a pasta de ambiente que você criou anteriormente. Para obter mais informações sobre como usar ambientes no VS Code, consulte Ambientes do Python no VS Code.

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 no empacotamento do Qiskit 1.0 para obter mais informações sobre compatibilidade de pacotes.

Para atualizar o pacote azure-quantum:

Desinstale os pacotes azure-quantum e qiskit existentes:

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

Instale 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.

Abra um prompt de comando do Windows.

No prompt de comando, execute

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

Compartilhar via