Empleo de Visual Studio for Mac Tools for UnityUsing Visual Studio for Mac Tools for Unity

En esta sección aprenderá a usar las características de productividad e integración de Visual Studio for Mac Tools for Unity y el depurador de Visual Studio para Mac para el desarrollo de 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.

Apertura de scripts de Unity en Visual Studio para MacOpening Unity scripts in Visual Studio for Mac

Una vez que Visual Studio para Mac se ha establecido como editor de scripts externo para Unity, al abrir cualquier script desde el editor de Unity se inicia o se va automáticamente a Visual Studio para Mac, con el script abierto.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.

También se puede abrir Visual Studio para Mac sin ningún script abierto en el editor de código fuente si se selecciona Abrir proyecto de C# desde el menú Activos de 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 proyecto de C#

Acceso a la documentación de UnityUnity documentation access

Visual Studio for Mac Tools for Unity incluye un acceso directo para acceder a la documentación de la API de Unity.Visual Studio for Mac Tools for Unity includes a shortcut for accessing the Unity API documentation. Para acceder a la documentación de la API de Unity desde Visual Studio para Mac, coloque el cursor sobre la API de Unity sobre la que quiere aprender y presione 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 mensajes de UnityIntelliSense for Unity messages

El motor de Unity difunde mensajes a scripts de MonoBehaviour, lo que permite a los desarrolladores escribir código que responda a mensajes como OnMouseDown, OnTriggerEnter, etc. Dado que estos no son métodos virtuales de la clase base de MonoBehaviour, algunos IDE como MonoDevelop carecen de la funcionalidad de completado de código para mensajes de 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.

Pero Visual Studio for Mac Tools for Unity extiende su funcionalidad de IntelliSense a los mensajes de Unity.However, Visual Studio for Mac Tools for Unity extends its IntelliSense functionality to Unity messages. Esto facilita la implementación de mensajes de Unity en scripts de MonoBehaviour y ayuda con el aprendizaje de la API de Unity.This makes it easy to implement Unity messages in MonoBehaviour scripts, and assists with learning the Unity API. Para usar IntelliSense para mensajes de Unity:To use IntelliSense for Unity messages:

  1. Coloque el cursor en una nueva línea dentro del cuerpo de una clase que derive de MonoBehaviour.Place the cursor on a new line inside the body of a class that derives from MonoBehaviour.

  2. Comience a escribir el nombre de un mensaje de Unity, como OnTriggerEnter.Begin typing the name of a Unity message, such as OnTriggerEnter.

  3. Una vez que haya escrito las letras "ont", aparece una lista de sugerencias de IntelliSense.Once the letters "ont" have been typed, a list of IntelliSense suggestions appears.

    Using IntelliSense

  4. La selección de la lista se puede cambiar de tres maneras:The selection on the list can be changed in three ways:

    • Con las teclas de flecha arriba y abajo.With the Up and Down arrow keys.

    • Al hacer clic con el mouse en el elemento deseado.By clicking with the mouse on the desired item.

    • Al seguir escribiendo el nombre del elemento deseado.By continuing to type the name of the desired item.

  5. IntelliSense puede insertar el mensaje de Unity seleccionado, incluidos todos los parámetros necesarios:IntelliSense can insert the selected Unity message, including any necessary parameters:

    • Al presionar Tab.By pressing Tab.

    • Al presionar Entrar.By pressing Return.

    • Al hacer doble clic en el elemento seleccionado.By double-clicking the selected item.

    Inserción de mensaje de Unity desde IntelliSense

Adición de nuevos archivos y carpetas de UnityAdding new Unity files and folders

Aunque siempre puede agregar nuevos archivos a un proyecto de Unity en el editor de Unity, Visual Studio para Mac permite crear fácilmente nuevos scripts, sombreadores y carpetas de Unity desde 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.

Adición de un nuevo script de C# de MonoBehaviourAdd a new C# MonoBehaviour script

Para agregar un nuevo script de C# de MonoBehaviour, haga clic con el botón derecho en la carpeta Activos o uno de sus subdirectorios en el Panel de solución y seleccione Agregar > Nuevo 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.

Adición de nuevo MonoBehaviour

Adición de un nuevo sombreador de UnityAdd a new Unity shader

Para agregar un nuevo sombreador de Unity, haga clic con el botón derecho en la carpeta Activos o en un subdirectorio en el Panel de solución y seleccione Agregar -> Nuevo 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.

Adición de una nueva carpetaAdd a new folder

Para agregar una nueva carpeta, haga clic con el botón derecho en la carpeta Activos o en un subdirectorio en el Panel de solución y seleccione Agregar -> Nueva carpeta.To add a new folder, right-click on the Assets folder or a subdirectory in the Solution pad and select Add > New Folder.

Estas adiciones se reflejan en la ventana de proyecto del editor de Unity.These additions are reflected in the Project window of the Unity editor.

Para cambiar el nombre de un archivo o una carpetaTo rename a file or folder

Haga clic con el botón derecho en el elemento al que quiere cambiar el nombre en el Panel de solución y seleccione Cambiar nombre...right-click on the item to rename in the Solution pad and select Rename....

Nota

Si tiene un nuevo proyecto de Unity sin scripts y no aparece la carpeta Activos en el Panel de solución de Visual Studio para Mac, agregue un script inicial de C# desde el editor de 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.

Depuración de UnityUnity debugging

Se pueden depurar proyectos de Unity con Visual Studio para Mac.Unity projects can be debugged with Visual Studio for Mac.

Iniciar depuraciónStart debugging

Para iniciar la depuración:To start debugging:

  1. Conecte Visual Studio a Unity al hacer clic en el botón Reproducir o escriba Comando + Entrar o F5.Connect Visual Studio to Unity by clicking the Play button, or type Command + Return, or F5.

    Haga clic en Reproducir en Visual Studio

  2. Vaya a Unity y haga clic en el botón Reproducir para ejecutar el juego en el editor.Switch to Unity and click the Play button to run the game in the editor.

    Haga clic en Reproducir en Unity

  3. Cuando se ejecuta el juego en el editor de Unity mientras se está conectado a Visual Studio, cualquier punto de interrupción detectado detiene la ejecución del juego y muestra la línea de código donde el juego alcanza el punto de interrupción en 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.

Detener depuraciónStop debugging

Para detener la depuración:To stop debugging:

  1. Haga clic en el botón Detener de Visual Studio para Mac o presione Mayús + Comando + Entrar.Click the Stop button in Visual Studio for Mac, or press Shift + Command + Return.

    Haga clic en Detener en Visual Studio

Para más información sobre la depuración en Visual Studio para Mac, vea Empleo del depurador.To learn more about debugging in Visual Studio for Mac, see Using the debugger.