Desenvolver com aplicações Q# num IDEDevelop with Q# applications in an IDE

Os programas Q# podem ser executados sozinhos, sem um controlador numa linguagem anfitriã, como C#, F# ou Python.Q# programs can run on their own, without a driver in a host language like C#, F#, or Python. Pode desenvolver aplicações Q# no Visual Studio Code (VS Code), Visual Studio, Visual Studio Codespaces ou em qualquer editor/IDE e executar aplicações a partir da consola .NET.You can develop Q# applications in Visual Studio Code (VS Code), Visual Studio, Visual Studio Codespaces, or with any editor/IDE and run applications from the .NET console.

Pré-requisitos para todos os ambientesPrerequisites for all environments

InstalaçãoInstallation

Embora possa criar aplicações Q# em qualquer IDE, recomendamos que utilize o Visual Studio Code (VS Code) ou o IDE do Visual Studio para desenvolver as suas aplicações Q# localmente.While you can build Q# applications in any IDE, we recommend using Visual Studio Code (VS Code) or Visual Studio IDE for developing your Q# applications locally. Para desenvolver na Cloud através do browser, recomendamos o Visual Studio Codespaces.For developing in the Cloud via the web browser, we recommend Visual Studio Codespaces. O desenvolvimento nestes ambientes tira partido da funcionalidade avançada da extensão QDK, que inclui avisos, realce de sintaxe, modelos de projeto e muito mais.Developing in these environments leverages the rich functionality of the QDK extension, which includes warnings, syntax highlighting, project templates, and more.

Para configurar para o VS Code:To configure for VS Code:

  1. Transfira e instale o VS Code (Windows, Linux e Mac).Download and install VS Code (Windows, Linux and Mac).
  2. Instale o Microsoft QDK for VS Code.Install the Microsoft QDK for VS Code.

Para configurar para o Visual Studio:To configure for Visual Studio:

  1. Transfira e instale o Visual Studio 16.3 ou superior com a carga de trabalho de desenvolvimento multiplataforma .NET Core ativada.Download and install Visual Studio 16.3 or greater, with the .NET Core cross-platform development workload enabled.
  2. Transfira e instale o Microsoft QDK.Download and install the Microsoft QDK.

Para configurar para outro ambiente:To configure for another environment:

  1. Introduza o seguinte na linha de comandosEnter the following at the command prompt
dotnet new -i Microsoft.Quantum.ProjectTemplates

Para configurar para o Visual Studio Codespaces:To configure for Visual Studio Codespaces:

  1. Crie uma conta do Azure.Create an Azure account.
  2. Crie um ambiente do Codespaces.Create a Codespaces environment. Siga o guia de início rápido.Please follow the quickstart guide. Ao criar o Codespace, recomendamos que introduza microsoft/Quantum no campo "Git Repository" (Repositório do Git) para carregar as definições específicas do QDK.When creating the Codespace, we recommend to enter microsoft/Quantum in the "Git Repository" field to load QDK-specific settings.
  3. Pode agora iniciar o seu novo ambiente e começar a desenvolver no browser através do IDE da Cloud do VS Codespaces.You can now launch your new environment and start developing in the browser via the VS Codespaces Cloud IDE. Pode, em alternativa, utilizar a instalação local do VS Code e utilizar o Codespaces como ambiente remoto.Alternatively, it is possible to use your local installation of VS Code and use Codespaces as a remote environment.

Programar com Q#Develop with Q#

Siga as instruções no separador correspondente ao seu ambiente de desenvolvimento.Follow the instructions on the tab corresponding to your development environment.

Para criar um novo projeto:To create a new project:

  1. Clique em View (Ver) -> Command Palette (Paleta de Comandos) e selecione Q#: Create New Project (Criar Novo Projeto).Click View -> Command Palette and select Q#: Create New Project.
  2. Clique em Standalone console application (Aplicação de consola autónoma).Click Standalone console application.
  3. Navegue até à localização para guardar o projeto.Navigate to the location to save the project. Introduza o nome do projeto e clique em Criar Projeto.Enter the project name and click Create Project.
  4. Após a criação do projeto, clique em Open new project... (Abrir novo projeto...) no canto inferior direito.When the project is successfully created, click Open new project... in the lower right.

Inspecione o projeto.Inspect the project. Deverá ver um ficheiro de origem com o nome Program.qs, que é um programa Q# que define uma operação simples para imprimir uma mensagem na consola.You should see a source file named Program.qs, which is a Q# program that defines a simple operation to print a message to the console.

Para executar a aplicação:To run the application:

  1. Clique em Terminal (Terminal) -> New Terminal (Novo Terminal).Click Terminal -> New Terminal.
  2. Na mensagem do terminal, introduza dotnet run.At the terminal prompt, enter dotnet run.
  3. Deverá ver o seguinte texto na janela de saída Hello quantum world!You should see the following text in the output window Hello quantum world!

Nota

As áreas de trabalho com várias pastas raiz não são atualmente suportadas pela extensão Q# do Visual Studio Code.Workspaces with multiple root folders are not currently supported by the VS Code Q# extension. Se tiver vários projetos numa área de trabalho do VS Code, todos os projetos terão de estar na mesma pasta raiz.If you have multiple projects within one VS Code workspace, all projects need to be contained within the same root folder.

Passos seguintesNext steps

Agora que instalou o Quantum Development Kit no ambiente pretendido, pode escrever e executar o primeiro programa quântico.Now that you have installed the Quantum Development Kit in your preferred environment, you can write and run your first quantum program.