Configuración de un entorno de Q# independiente

Aprenda a configurar un entorno de desarrollo de Q# independiente con Jupyter Notebook, Visual Studio Code (VS Code), Visual Studio o cualquier otro editor o IDE. Los programas de Q# se pueden ejecutar por sí mismos o pueden usar un programa de controlador en un lenguaje host como C# o F#.

Q# y Jupyter Notebook

Jupyter Notebook permite la ejecución de código en contexto junto con instrucciones, notas y otro contenido. Este entorno es idóneo para escribir código de Q# con explicaciones insertadas o tutoriales interactivos sobre computación cuántica. Todos los componentes necesarios se pueden configurar con una sola instalación de Conda.

Nota

Si desea usar Jupyter Notebook pero prefiere no instalar Conda, puede configurar Jupyter Notebook con la CLI de .NET.

  1. Instale Miniconda o Anaconda. Consulte la guía de instalación si no está seguro de los pasos. Nota: Se necesita una instalación de 64 bits.

  2. Inicialice conda para el shell que prefiera con el comando conda init. Los pasos siguientes están adaptados a su sistema operativo:

    (Windows) Abra un símbolo del sistema de Anaconda; para ello, búsquelo en el menú Inicio. A continuación, ejecute el comando de inicialización para el shell; por ejemplo, conda init powershell cmd.exe configurará Windows PowerShell y el símbolo del sistema. A continuación, puede cerrar este símbolo del sistema.

    Importante

    Para trabajar con PowerShell, Conda configurará un script de inicio para que se ejecute cada vez que inicie una instancia de PowerShell. De manera predeterminada, la ejecución del script se bloqueará en Windows y requiere modificar la directiva de ejecución de PowerShell con el siguiente comando (ejecutado desde PowerShell):

    Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
    

    (Linux) Si no lo ha hecho durante la instalación, puede inicializar Conda ahora. Abra un terminal y vaya al directorio bin dentro de la ubicación de instalación seleccionada (por ejemplo, /home/ubuntu/miniconda3/bin). A continuación, ejecute el comando adecuado para el shell; por ejemplo, ./conda init bash. Cierre el terminal para que los cambios surtan efecto.

  3. Desde un nuevo terminal, cree y active un nuevo entorno de Conda llamado qsharp-env con los paquetes necesarios (incluidos Jupyter Notebook e IQ#) mediante la ejecución de los siguientes comandos:

    conda create -n qsharp-env -c microsoft qsharp notebook
    
    conda activate qsharp-env
    
  4. Finalmente, ejecute python -c "import qsharp" para comprobar la instalación y rellenar la memoria caché del paquete local con todos los componentes necesarios del QDK.

Q# y otros IDE

Aunque puede crear aplicaciones de Q# en cualquier IDE, se recomienda usar Visual Studio Code (VS Code) o el IDE de Visual Studio para desarrollar aplicaciones de Q# si las ejecuta en una consola de .NET. Estos entornos de desarrollo aprovechan la funcionalidad enriquecida de la extensión del kit de desarrollo de Quantum (QDK), como las advertencias, el resaltado de sintaxis o las plantillas de proyecto, entre otras.

Importante

Si trabaja con Linux, puede encontrar una dependencia que falta en función del método de instalación y distribución determinado (por ejemplo, algunas imágenes de Docker). Asegúrese de que la biblioteca libgomp está instalada en el sistema, ya que la biblioteca de compatibilidad con OpenMP de GNU es necesaria para el simulador cuántico de QDK. En Ubuntu, puede hacerlo si ejecuta sudo apt install libgomp1, o bien yum install libgomp en CentOS. Para otras distribuciones, consulte con el administrador de paquetes específico.

Requisito previo

Configure el QDK para su entorno preferido desde una de las siguientes opciones:

Código de VS

  1. Descargue e instale VS Code 1.52.0 o versiones posteriores (Windows, Linux y Mac).
  2. Instale el QDK para VS Code.

Visual Studio (solo Windows)

  1. Descargue e instale Visual Studio 16.3 o versiones posteriores con la carga de trabajo de desarrollo multiplataforma de .NET Core habilitada.
  2. Descargue e instale el QDK.

Nota

Aunque hay una versión de Visual Studio para Mac, la extensión QDK solo es compatible con Visual Studio para Windows.

Jupyter Notebook (mediante la CLI de .NET)

Si desea ejecutar sus programas en Jupyter Notebook, pero no quiere instalar Conda, puede configurar los componentes necesarios con .NET.

  1. Requisitos previos:

  2. Instale IQ# mediante el paquete de .NET Microsoft.Quantum.IQSharp.

    dotnet tool install -g Microsoft.Quantum.IQSharp
    dotnet iqsharp install
    

    Nota

    Si se produce un error de permisos en Linux, instale el kernel de IQ# en modo de usuario con dotnet iqsharp install --user.

    Nota

    Si se produce un error y acaba de instalar .NET, no podrá ejecutar el comando dotnet iqsharp install inmediatamente. En su lugar, en Windows, abra una nueva ventana de terminal e inténtelo de nuevo. En Linux, cierre la sesión y vuelva a iniciarla para intentarlo de nuevo. Si aún así no funciona, intente buscar la herramienta dotnet-iqsharp instalada (en Windows, dotnet-iqsharp.exe) y ejecute:

    /path/to/dotnet-iqsharp install --user --path-to-tool="/path/to/dotnet-iqsharp"
    

    donde /path/to/dotnet-iqsharp debe reemplazarse por la ruta de acceso absoluta a la herramienta dotnet-iqsharp en el sistema de archivos. Normalmente, estará en .dotnet/tools, en la carpeta de perfil de usuario.

CLI de .NET

  1. En el símbolo del sistema, escriba lo siguiente:
dotnet new -i Microsoft.Quantum.ProjectTemplates

CLI de Azure (no se requiere el SDK de .NET Core 3.1)

  • Instale la CLI de Azure.

  • Instalación de la extensión quantum de la CLI de Azure. Abra un símbolo del sistema y ejecute el comando siguiente:

    az extension add -n quantum
    

Pasos siguientes

Ahora que ha configurado el entorno de Q# independiente, puede escribir y ejecutar programas cuánticos en simuladores cuánticos locales, simuladores hospedados en la nube o hardware cuántico remoto.