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

Artigo
09/12/2024

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

Importante

Se você estiver atualizando de um ambiente Qiskit anterior, consulte Atualizar o pacote azure-quantum com suporte a Qiskit em um ambiente Python virtual (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 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:

Crie uma pasta local, por exemplo ~/qiskit10-env.
Executar venv com o caminho para a pasta
```
python3 -m venv ~/qiskit10-env
```
Ative o ambiente.
```
~/qiskit10-env/bin/activate
```
Execute pip list e você pode 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 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.

Nota

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

Nota

Você também pode abrir seu ambiente virtual no VS Code. No menu Exibir, selecione Command Palette>Python: Create Environment>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 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 de 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 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.

Abra uma linha de comandos do Windows.

No prompt de comando, execute

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

Partilhar via