Usando as Ferramentas do Visual Studio para Mac para UnityUsing Visual Studio for Mac Tools for Unity

Nesta seção, você aprenderá como usar os recursos de integração e produtividade das Ferramentas do Visual Studio para Mac para Unity e como usar o depurador do Visual Studio para Mac para desenvolvimento no Unity.In this section, you'll learn how to use Visual Studio for Mac Tools for Unity's integration and productivity features, and how to use the Visual Studio for Mac debugger for Unity development.

Abrir scripts do Unity com o Visual Studio para MacOpening Unity scripts in Visual Studio for Mac

Depois que o Visual Studio para Mac é definido como o editor de script externo para Unity, abrir qualquer script do editor do Unity iniciará ou trocará automaticamente para o Visual Studio para Mac com o script escolhido aberto.Once Visual Studio for Mac is set as the external script editor for Unity, opening any script from the Unity editor will automatically launch or switch to Visual Studio for Mac, with the chosen script open.

Outra opção é abrir o Visual Studio para Mac sem nenhum script no editor de código-fonte selecionando Abrir projeto C# no menu Ativos no Unity.Alternatively, Visual Studio for Mac can be opened with no script open in the source editor by selecting Open C# Project from the Assets menu in Unity.

Abrir um projeto C#

Acesso de documentação do UnityUnity documentation access

As Ferramentas do Visual Studio para Mac para Unity inclui um atalho para acessar a documentação da API do Unity.Visual Studio for Mac Tools for Unity includes a shortcut for accessing the Unity API documentation. Para acessar a documentação da API do Unity no Visual Studio para Mac, posicione o cursor sobre a API do Unity você deseja conhecer e pressione o comando ⌘ + ‘.To access Unity API documentation from Visual Studio for Mac, place the cursor over the Unity API you want to learn about and press ⌘ command + ‘.

IntelliSense para mensagens do UnityIntelliSense for Unity messages

O mecanismo Unity transmite mensagens para scripts MonoBehaviour, permitindo que os desenvolvedores escrevam código que reage a mensagens como OnMouseDown, OnTriggerEnter, etc. Como eles não são métodos virtuais na classe base MonoBehaviour, alguns IDEs como MonoDevelop não têm a funcionalidade de preenchimento de código para mensagens Unity.The Unity engine broadcasts messages to MonoBehaviour scripts, allowing developers to write code that reacts to messages such as OnMouseDown, OnTriggerEnter, etc. Because these are not virtual methods in the base MonoBehaviour class, some IDEs such as MonoDevelop lack code completion functionality for Unity messages.

No entanto, as Ferramentas do Visual Studio para Mac para Unity estende sua funcionalidade do IntelliSense para as mensagens do Unity.However, Visual Studio for Mac Tools for Unity extends its IntelliSense functionality to Unity messages. Isso torna mais fácil implementar mensagens Unity em scripts MonoBehaviour e auxilia no aprendizado da API do Unity.This makes it easy to implement Unity messages in MonoBehaviour scripts, and assists with learning the Unity API. Para usar o IntelliSense para mensagens Unity:To use IntelliSense for Unity messages:

  1. Posicione o cursor em uma nova linha dentro do corpo de uma classe derivada de MonoBehaviour.Place the cursor on a new line inside the body of a class that derives from MonoBehaviour.

  2. Comece a digitar o nome de uma mensagem do Unity, como OnTriggerEnter.Begin typing the name of a Unity message, such as OnTriggerEnter.

  3. Depois que as letras “ont” forem digitadas, será exibida uma lista de sugestões do IntelliSense.Once the letters "ont" have been typed, a list of IntelliSense suggestions appears.

    Usando IntelliSense

  4. A seleção na lista pode ser alterada de três maneiras:The selection on the list can be changed in three ways:

    • Com as teclas de direção Para cima e Para baixo.With the Up and Down arrow keys.

    • Clicando com o mouse no item desejado.By clicking with the mouse on the desired item.

    • Continuando a digitar o nome do item desejado.By continuing to type the name of the desired item.

  5. O IntelliSense pode inserir a mensagem Unity selecionada, incluindo todos os parâmetros necessários:IntelliSense can insert the selected Unity message, including any necessary parameters:

    • Pressionando Tab.By pressing Tab.

    • Pressionando Enter.By pressing Return.

    • Clicando duas vezes no item selecionado.By double-clicking the selected item.

    Inserir mensagem Unity do IntelliSense

Adicionar novos arquivos e pastas UnityAdding new Unity files and folders

Embora sempre seja possível adicionar novos arquivos a um projeto do Unity no editor do Unity, o Visual Studio para Mac permite criar facilmente novos scripts, sombreadores e pastas do Unity no Visual Studio.While you can always add new files to a Unity project in the Unity editor, Visual Studio for Mac allows for easily creating new Unity scripts, shaders, and folders from within Visual Studio.

Adicionar um novo script MonoBehaviour C#Add a new C# MonoBehaviour script

Para adicionar um novo script MonoBehaviour C#, clique com o botão direito do mouse na pasta Ativos ou em um de seus subdiretórios no Painel de Soluções e selecione Adicionar > Novo MonoBehaviour.To add a new C# MonoBehaviour script, right-click on the Assets folder or one of its subdirectories in the Solution pad and select Add > New MonoBehaviour.

Adicionar novo MonoBehaviour

Adicionar um novo sombreador do UnityAdd a new Unity shader

Para adicionar um novo sombreador do Unity, clique com o botão direito do mouse na pasta Ativos ou em um subdiretório no painel Solução e selecione Adicionar > Novo Sombreador.To add a new Unity shader, right-click on the Assets folder or a subdirectory in the Solution pad and select Add > New Shader.

Adicionar uma nova pastaAdd a new folder

Para adicionar uma nova pasta, clique com o botão direito do mouse na pasta Ativos ou em um subdiretório no Painel de Soluções e selecione Adicionar > Nova Pasta.To add a new folder, right-click on the Assets folder or a subdirectory in the Solution pad and select Add > New Folder.

Essas adições são refletidas na janela Projeto do editor do Unity.These additions are reflected in the Project window of the Unity editor.

Renomear um arquivo ou pastaTo rename a file or folder

Clique com botão direito do mouse no item a ser renomeado no Painel de Soluções e selecione Renomear....right-click on the item to rename in the Solution pad and select Rename....

Note

Se você tiver um novo projeto do Unity sem nenhum script e a pasta Ativos não for mostrada no Painel de Soluções no Visual Studio para Mac, adicione um script C# inicial de dentro do editor do Unity.If you have a new Unity project with no scripts and the Assets folder does not show up in the Solution pad in Visual Studio for Mac, add an initial C# script from within the Unity editor.

Depuração do UnityUnity debugging

Projetos do Unity podem ser depurados com o Visual Studio para Mac.Unity projects can be debugged with Visual Studio for Mac.

Iniciar a depuraçãoStart debugging

Para iniciar a depuração:To start debugging:

  1. Conecte-se ao Visual Studio para Unity clicando no botão Executar ou pressione Comando + Enter ou F5.Connect Visual Studio to Unity by clicking the Play button, or type Command + Return, or F5.

    Clique em Executar no Visual Studio

  2. Alterne para o Unity e clique no botão Reproduzir para executar o jogo no editor.Switch to Unity and click the Play button to run the game in the editor.

    Clique em Executar no Unity

  3. Quando o jogo estiver em execução no editor do Unity e ao mesmo conectado ao Visual Studio, qualquer ponto de interrupção encontrado pausará a execução do jogo e mostrará a linha de código em que o jogo atingiu o ponto de interrupção no Visual Studio para Mac.When the game is running in the Unity editor while connected to Visual Studio, any breakpoints encountered will pause execution of the game and bring up the line of code where the game hit the breakpoint in Visual Studio for Mac.

Parar a depuraçãoStop debugging

Para interromper a depuração:To stop debugging:

  1. Clique no botão Parar no Visual Studio para Mac ou pressione Shift + Comando + Enter.Click the Stop button in Visual Studio for Mac, or press Shift + Command + Return.

    Clique em Parar no Visual Studio

Para saber mais sobre a depuração no Visual Studio para Mac, consulte Usando o depurador.To learn more about debugging in Visual Studio for Mac, see Using the debugger.