Aggiornare il Quantum Development Kit (QDK) alla versione più recente

Informazioni su come aggiornare Quantum Development Kit (QDK) alla versione più recente.

In questo articolo si presuppone che il QDK sia già installato. Se si tratta della prima installazione, vedere la guida all'installazione.

È consigliabile usare sempre la versione più recente del QDK. Seguire questa guida all'aggiornamento per eseguire l'aggiornamento alla versione più recente del QDK. Il processo è articolato in due parti:

  1. Aggiornamento dei file e dei progetti Q# esistenti per allineare il codice all'eventuale sintassi aggiornata.
  2. Aggiornamento del QDK stesso per l'ambiente di sviluppo scelto.

Aggiornare progetti Q#

Indipendentemente dal fatto che si usi C# o Python per ospitare le operazioni Q#, seguire queste istruzioni per aggiornare i progetti Q#.

  1. Prima di tutto, verificare di avere la versione più recente di .NET SDK 6.0. Eseguire il comando seguente al prompt dei comandi:

    dotnet --version
    

    Verificare che l'output sia un valore pari o superiore a 6.0.100. In caso contrario, installare la versione più recente e ripetere la verifica. Seguire quindi le istruzioni seguenti, a seconda della configurazione (Visual Studio, Visual Studio Code o direttamente da prompt dei comandi).

Aggiornare i progetti Q# in Visual Studio

  1. Aggiornare alla versione più recente di Visual Studio 2022, vedere qui per istruzioni.

  2. Aprire la soluzione in Visual Studio.

  3. Nel menu selezionare Compila ->Pulisci soluzione.

  4. In ognuno dei file con estensione csproj aggiornare il framework di destinazione a net6.0 o a netstandard2.1 se si tratta di un progetto di libreria. Questo significa modificare le righe nel formato:

    <TargetFramework>net6.0</TargetFramework>
    

    Per altre informazioni sulla specifica dei framework di destinazione, vedere qui.

  5. In ognuno dei file con estensione csproj impostare l'SDK su Microsoft.Quantum.Sdk, come indicato nella riga seguente. Si noti che il numero di versione deve essere l'ultimo disponibile. Per determinarlo, esaminare le note sulla versione.

    <Project Sdk="Microsoft.Quantum.Sdk/0.24.201332">
    
  6. Salvare e chiudere tutti i file della soluzione.

  7. Selezionare Strumenti ->Riga di comando ->Prompt dei comandi per gli sviluppatori. In alternativa, è possibile usare la console di gestione pacchetti in Visual Studio.

  8. Per ogni progetto nella soluzione eseguire il comando seguente per rimuovere questo pacchetto:

    dotnet remove [project_name].csproj package Microsoft.Quantum.Development.Kit
    

    Se i progetti usano qualsiasi altro pacchetto Microsoft.Quantum o Microsoft.Azure.Quantum, ad esempio Microsoft.Quantum.Numerics, eseguire il comando add per aggiornare la versione usata per tali pacchetti.

    dotnet add [project_name].csproj package [package_name]
    
  9. Chiudere il prompt dei comandi e selezionare Compila ->Compila soluzione (non selezionare Ricompila soluzione).

È ora possibile procedere con l'aggiornamento dell'estensione Visual Studio QDK.

Aggiornare i progetti Q# in Visual Studio Code

  1. In Visual Studio Code aprire la cartella contenente il progetto da aggiornare.
  2. Selezionare Terminale ->Nuovo terminale.
  3. Seguire le istruzioni per l'aggiornamento con il prompt dei comandi riportate di seguito.

Aggiornare i progetti Q# con il prompt dei comandi

  1. Passare alla cartella contenente il file di progetto principale.

  2. Eseguire il comando seguente:

    dotnet clean [project_name].csproj
    
  3. Determinare la versione corrente del QDK. Per trovarla, è possibile esaminare le note sulla versione. La versione è indicata in un formato simile a 0.24.201332.

  4. In ognuno dei file .csproj seguire questa procedura:

    • Aggiornare il framework di destinazione a net6.0 o a netstandard2.1 se si tratta di un progetto di libreria. Questo significa modificare le righe nel formato:

      <TargetFramework>net6.0</TargetFramework>
      

      Per altre informazioni sulla specifica dei framework di destinazione, vedere qui.

    • Sostituire il riferimento all'SDK nella definizione del progetto. Assicurarsi che il numero di versione corrisponda al valore determinato nel passaggio 3.

      <Project Sdk="Microsoft.Quantum.Sdk/0.24.201332">
      
    • Rimuovere il riferimento al pacchetto Microsoft.Quantum.Development.Kit, se presente, che verrà specificato nella voce seguente:

      <PackageReference Include="Microsoft.Quantum.Development.Kit" Version="0.24.201332" />
      
    • Aggiornare la versione di tutti i pacchetti Microsoft Quantum alla versione rilasciata più di recente del QDK (determinata nel passaggio 3). I nomi dei pacchetti sono conformi ai criteri seguenti:

      Microsoft.Quantum.*
      Microsoft.Azure.Quantum.*
      

      I riferimenti ai pacchetti hanno il formato seguente:

      <PackageReference Include="Microsoft.Quantum.Compiler" Version="0.24.201332" />
      
    • Salvare il file aggiornato.

    • Ripristinare le dipendenze del progetto eseguendo le operazioni seguenti:

      dotnet restore [project_name].csproj
      

    Nota

    Per le versioni 0.24.201332 e versioni precedenti, il framework di destinazione è stato aggiornato da netcoreapp3.1 a net6.0 (ad eccezione delle librerie). Se si usa un QDK precedente, è consigliabile mantenere questo valore come è.

  5. Tornare alla cartella contenente il progetto principale ed eseguire:

    dotnet build [project_name].csproj
    

Dopo aver completato l'aggiornamento dei progetti Q#, attenersi alle istruzioni seguenti per aggiornare il QDK stesso.

Aggiornare QDK

Il processo per aggiornare il QDK varia a seconda del linguaggio di sviluppo e dell'ambiente usati. Selezionare l'ambiente di sviluppo di seguito.

Aggiornare il pacchetto Python qsharp

La procedura di aggiornamento varia a seconda che l'installazione originale sia stata eseguita con conda o con l'interfaccia della riga di comando .NET e pip.

  1. Attivare l'ambiente conda in cui è stato installato il pacchetto qsharp e quindi eseguire questo comando per aggiornarlo:

    conda update -c microsoft qsharp
    
  2. Eseguire il comando seguente dal percorso dei file .qs:

    python -c "import qsharp; qsharp.reload()"
    

È ora possibile usare il pacchetto Python aggiornato per eseguire i programmi quantistici qsharp Python esistenti.

Aggiornare li kernel IQ# per Jupyter

La procedura di aggiornamento varia a seconda che l'installazione originale sia stata eseguita con conda o con l'interfaccia della riga di comando .NET e pip.

  1. Attivare l'ambiente conda in cui è stato installato il pacchetto qsharp e quindi eseguire questo comando per aggiornarlo:

    conda update -c microsoft qsharp
    
  2. Eseguire il comando seguente da una cella in ogni notebook di Jupyter Q# esistente:

    %workspace reload
    

È ora possibile usare il kernel IQ# aggiornato per eseguire i notebook di Jupyter Q# esistenti.

Aggiornare l'estensione QDK per Visual Studio

  1. Aggiornare l'estensione QDK per Visual Studio

    Nota

    I modelli di progetto vengono aggiornati con l'estensione. I modelli aggiornati si applicano solo ai progetti appena creati. Il codice per i progetti esistenti non viene aggiornato quando si aggiorna l'estensione.

Aggiornare l'estensione QDK per VS Code

  1. Aggiornare l'estensione QDK per VS Code

    • Riavviare VS Code
    • Passare alla scheda Estensioni
    • Selezionare l'estensione Microsoft Quantum Development Kit for Visual Studio Code
    • Ricaricare l'estensione

C# con lo strumento da riga di comando dotnet

  1. Aggiornare i modelli di progetto QDK per .NET

    Dal prompt dei comandi:

    dotnet new -i Microsoft.Quantum.ProjectTemplates
    

    In alternativa, se si intende usare i modelli della riga di comando e si dispone già dell'estensione QDK per VS Code installata, è possibile aggiornare i modelli di progetto dall'estensione stessa:

    • Aggiornare l'estensione QDK per VS Code
    • In VS Code passare a Visualizza ->Riquadro comandi
    • Selezionare Q#: Installare i modelli di progetto della riga di comando
    • Dopo alcuni secondi dovrebbe essere visualizzata una finestra popup che conferma la corretta installazione dei modelli di progetto

Aggiornare il pacchetto Python azure-quantum

  1. Eseguire l'aggiornamento al pacchetto Python più recente azure-quantum usando il programma di installazione del pacchetto per Python (pip)

    pip install --upgrade azure-quantum
    
  2. Se si verificano problemi, assicurarsi che Python e pip siano aggiornati. Per informazioni sui requisiti di versione più recenti, installare il pacchetto Python azure-quantum