<track id="5sipw"><track id="5sipw"><span id="5sipw"></span></track></track><delect id="5sipw"></delect>

<meter id="5sipw"></meter>

  • <meter id="5sipw"><ins id="5sipw"><strike id="5sipw"></strike></ins></meter><nobr id="5sipw"><input id="5sipw"><ruby id="5sipw"></ruby></input></nobr>

      1. <cite id="5sipw"></cite>

          UnrealVS Extension

          Guide for installing, setting up, and using the UnrealVS extension for Visual Studio.


          Use the UnrealVS extension for Visual Studio for easy access to common actions when developing with Unreal Engine 4. This document will explain how to install the extension, as well as how to use it with your project.

          Features include:

          • Setting the Startup Project

          • Bindable command for building the Startup Project

          • Setting the command line arguments

          • Batch building projects

          • Quick Build project menu

          The UnrealVS extension does not work with Visual Studio Express. It is only compatible with Visual Studio Community and Professional editions.

          Installation and Setup

          To install the UnrealVS extension:

          1. Find the extension for your version of Visual Studio located at:


          2. Run the UnrealVS.vsix file by double-clicking it to begin the installation.

          3. UnrealVS extensions target specific Visual Studio versions. Check that the installer is targeting your version and that the box is ticked then click the Install button to proceed.


          4. Click the Close button once the installation is complete.

            Install Complete

          5. Run Visual Studio and in Tools > Extensions and Updates... you should see the extension.

            Extension Manager

            If Visual Studio is already running, you will need to restart before the extension will be loaded and displayed. The extension is also shown in the Installed Products list in the Help > About Microsoft Visual Studio dialog.

          6. Go to View > Toolbars or Right-click the Visual Studio toolbar area and select UnrealVS to display the extension's toolbar.

            UnrealVS Toolbar

          7. By default, the toolbar appears as above but its contents can be customized via the Tools > Customize... by choosing the UnrealVS toolbar in the Commands tab.

            UnrealVS Customize Toolbar

          8. In the Customize dialog, choose Add Command... and select UnrealVS from the Categories list to see a list of UnrealVS commands that can be added to the toolbar. When you've finished adding commands, click OK.

            UnrealVS Customize Commands

          Setting the Startup Project

          The Startup Project dropdown is a means of quickly setting or switching between startup projects. It automatically lists all available projects that build executables in the solution. Selecting a project from the list sets that as the current startup project.


          You can change which projects are listed in the UnrealVS options. To show only Game projects, go to Tools > Options... and select UnrealVS. Click the dropdown next to Hide Non-Game Startup Projects and select True. Then click OK.

          Set Startup Project

          Building the Startup Project

          The extension also contains a command for building the current startup project which can be bound to a hotkey or other means of running custom commands.

          Binding the Command to a Hotkey

          1. Go to Tools > Options... and select Keyboard under the Environment tree. Under Apply the following additional keyboard mapping scheme click the dropdown and select Visual C++ 6. Filtered Keyboard Mapping List

          2. Select the UnrealVS.BuildStartupProject command in the commands list.

            Filtered Command List

            Type "Unreal" in the search box to filter the list.

          3. With the command selected, click in the Press Shortcut Keys box and then press the combination of keys you want to use to perform the command (for example, Ctrl + Alt + Shift + B is shown in the example below).

            Shortcut Keys

            You should choose a combination of keys not already assigned to another command. The Shortcut currently used by box will alert you to the fact that the chosen combination is already in use.

          4. Press the Assign button to bind the keys to the command. The key combination is displayed under Shortcuts for selected command.

            Assigned Keys

          5. Press the OK button to save the changes. Now, when you use the shortcut, the project set as the startup project will automatically build.

          Iterating on a Single Source File

          If you're used to iterating on updates to a single source (.cpp) file using Ctrl+F7 in Visual Studio, you can bind Ctrl+F7 to the UnrealVS.CompileSingleFile command, which builds your active project with the current solution configuration, platform, and the -singlefile=<Path to currently open file> argument.

          Command Line Arguments

          The Command-Line control is used to set the Command Arguments for the current project when running a debugging session. This is a shortcut, rather than setting them through the project Properties. In fact, changes made here will be reflected automatically in the Properties.

          Enter the arguments in the text box, or choose from a list of recent arguments using the dropdown list. These arguments will be passed to the executable when a debugging session is started.

          Command Arguments

          Project configurations for game projects that build Unreal Editor add the project name to the command line automatically, to tell the editor executable which project you are using. For example, if you build QAGame using the build config 'Debug Editor', the command line will have QAGame.uproject added to the command arguments without the need to type it in the box. To launch the editor for QAGame, you can leave the Command-Line control empty and the editor will still know which project you are running.

          See Command-Line Arguments for a listing of all available arguments.

          Refresh Projects

          Project files can be generated inside of Visual Studio using the Automatic Project File Generation . This makes it much quicker to sync and update all the project files, since you do not have to navigate to the .bat file and run it manually.

          To refresh project files:

          1. Press the Refresh Projects button on the UnrealVS toolbar.


          2. The project generation process will be displayed in the Output window as it occurs.

            Project Generator Output

          3. Reload any projects that require it, as you are prompted.

          Batch Builder

          Create and run custom sets of build jobs with UnrealVS Batch Builder. It is more versatile than the Build > Batch Build... option in Visual Studio.

          To open the Batch Builder window:

          1. Press the Batch Builder button on the UnrealVS toolbar or use a keyboard shortcut that you have assigned to the command UnrealVS.BatchBuilder (see Build Startup Project above for instructions on setting up keyboard shortcuts with UnrealVS commands).

            Batch Builder

          2. The UnrealVS Batch Builder window appears.

            Batch Builder Window

            • Create a Build Job by selecting from the Project, Config, Platform, and then clicking the radio button for the job type.

            • Add/remove jobs with the > and < buttons.

            • In the Build Jobs list, move selected jobs up or down the list with the arrow buttons on the right.

            • Select the Job Set you want to edit in the dropdown under the Build Jobs list.

            • To create a new Job Set, type a new name into the field.

            • The Delete button deletes the selected Job Set from the list.

            • Start or Stop the batch build task on the current Job Set with the Start button.

            • Job Sets are stored for next time in the .suo file for the loaded solution.

          3. When you click Start, the Output tab displays, showing the progress of the batch build.

            Batch Builder Window running

            The Build Jobs in the running set are shown in the output list. The current executing build job is shown in bold.

            • Queued Build Job = Queued job

            • Succeeded Build Job = Job complete, succeeded

            • Failed Build Job = Failed job

            • Cancelled Build Job = Cancelled job

            A busy animation, and the Stop button, are shown when a batch build is running.

          4. You can view the output from individual Build Jobs by double-clicking an item in the Output tab, or by right-clicking and selecting Show Output from the context menu.

            BatchBuild Output Pane

            Batch Builder output for individual items is shown in the Visual Studio Output window, in a pane named UnrealVS - BatchBuild. This is not to be confused with the Build pane that shows the output of the current/last build job.

          Quick Build Menu

          Use the Quick Build menu to build a project using any config and platform combination, without having to change the main solution build config.

          Quick Build Menu

          1. Right-click a Project node in the Solution Explorer.

          2. The UnrealVS Quick Build menu contains sub-menus for the available platforms, and build configs, in the Unreal Engine solution.

          3. Select an item to build the selected project, platform, and config. This method is much quicker than changing the Solution Configuration and Solution Platform in the IDE, starting a build, then switching the config and platform back again.

          Working with the UnrealVS Source Code

          UnrealVS source code is located in the [UE4RootLocation]/Engine/Source/Programs/UnrealVS/ folder.

          In order to load the UnrealVS project files with Visual Studio, you will need to have the Visual Studio SDK installed for the appropriate version of Visual Studio that UnrealVS is to be compiled with. For example, when supporting up to Visual Studio 2015, you will need to install the Visual Studio 2015 SDK , then load UnrealVS project files into Visual Studio 2015.

          Select Skin

          Welcome to the new Unreal Engine 4 Documentation site!

          We're working on lots of new features including a feedback system so you can tell us how we are doing. It's not quite ready for use in the wild yet, so head over to the Documentation Feedback forum to tell us about this page or call out any issues you are encountering in the meantime.

          We'll be sure to let you know when the new system is up and running.

          Post Feedback