Skip to content

Repo sync for protected CLA branch #3846

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
colin-home merged 2 commits into from
Apr 21, 2022
Merged

Repo sync for protected CLA branch #3846

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
7ec7758
4/21/2022 AM Publish (#4237)
Taojunshen Apr 21, 2022
f037ac9
Merging changes synced from https://github.com/MicrosoftDocs/cpp-docs…
opbld17 Apr 21, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 20 additions & 8 deletions docs/build/creating-and-managing-visual-cpp-projects.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,31 +1,37 @@
---
description: "Learn more about: creating and configuring Visual Studio C++ projects"
title: "Visual Studio Projects - C++"
ms.date: 04/19/2022
ms.date: 04/20/2022
helpviewer_keywords: ["Visual Studio C++ projects, creating", "projects [C++], creating", "Visual Studio C++ projects"]
---
# Visual Studio projects - C++

A *Visual Studio project* is a collection of code files and assets such as icons, images, and so on, that are built together using the MSBuild build system. MSBuild is the native build system for Visual Studio and is generally the best build system to use for Windows-specific programs. MSBuild is tightly integrated with Visual Studio, but you can also use it from the command line.

For cross-platform projects, or projects that use open-source libraries, we recommend using [CMake projects in Visual Studio](cmake-projects-in-visual-studio.md) in Visual Studio 2017 and later. For information about upgrading MSBuild projects from older versions of Visual Studio, see the [Microsoft C++ Porting and Upgrading Guide](../porting/visual-cpp-porting-and-upgrading-guide.md).

For information about upgrading MSBuild projects from older versions of Visual Studio, see the [Microsoft C++ Porting and Upgrading Guide](../porting/visual-cpp-porting-and-upgrading-guide.md).

For cross-platform projects, or projects that use open-source libraries, we recommend using [CMake projects in Visual Studio](cmake-projects-in-visual-studio.md) in Visual Studio 2017 and later.


## Create a Visual Studio C++ project

::: moniker range=">=msvc-160"

1. Create a C++ project by choosing **File** > **New** > **Project**.
1. Set the **Language** to C++.
1. In the results list, you'll see a list of project templates. Filter the templates them by setting the **Platform** or **Project Type** and then by typing keywords into the search box.
1. In the **Create a new project** dialog, set the **Language** dropdown to **C++**. This filters the list of project templates to C++ projects. You can filter the templates by setting the **Platform**, **Project Type**, or by entering keywords in the search box.

![Screenshot of the Create a new project wizard. The Console App project template is selected.](../build/media/vs2019-choose-console-app.png)

1. Select a project template, then choose **Next**.
1. On the **Configure your new project page**, enter project-specific settings such as the project name or location and then choose **Create** to create your project.

::: moniker-end

::: moniker range="msvc-150"

1. Create a C++ project by choosing **File** > **New** > **Project**.
1. Choose **Visual C++** in the left pane. In the center pane, a list of project templates will appear:
1. Choose **Visual C++** in the left pane. In the center pane, a list of project templates appears:

![Screenshot of the New Project dialog, showing available project templates for C++ such as Windows Console Application.](../overview/media/vs2017-new-project.png "Visual Studio 2017 New Project Dialog")

Expand All @@ -47,9 +53,13 @@ The solution file coordinates build dependencies when you have multiple related

Add source code files, icons, or any other items to your project by right-clicking on the project in **Solution Explorer** and choosing **Add > New** or **Add > Existing**.

## Add third party libraries to a project

To add third-party libraries, use the [vcpkg](https://vcpkg.io/) package manager. Run the Visual Studio integration step to set up the paths to that library when you reference it from any Visual Studio project.
## Add third-party libraries to a project

Over 900 C++ open source libraries are available via the [vcpkg](https://vcpkg.io/) package manager. Run the Visual Studio integration step to set up the paths to that library when you reference it from any Visual Studio project.


There are also commercial third-party libraries that you can install. Follow their installation instructions.

## Set compiler options and build properties

Expand All @@ -59,7 +69,9 @@ To configure build settings for a project, right-click on the project in **Solut

To compile and run the new project, press **F5** or click the *debug dropdown* with the green arrow on the main toolbar. The *configuration dropdown* is where you choose whether to perform a *Debug* or *Release* build (or some other custom configuration).

A new project compiles without errors. When adding your own code, you may occasionally introduce an error or trigger a warning. An error prevents the build from completing; a warning doesn't. All errors and warnings will appear both in the Output Window and in the Error List when you build the project.

A new project compiles without errors. When adding your own code, you may occasionally introduce an error or trigger a warning. An error prevents the build from completing; a warning doesn't. All errors and warnings appear both in the Output Window and in the Error List when you build the project.


![Screenshot of the Output window and Error list.](../overview/media/vs2017-output-error-list.png)

Expand Down
40 changes: 23 additions & 17 deletions docs/overview/visual-cpp-in-visual-studio.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "C and C++ in Visual Studio"
description: "Learn how to use the Microsoft C/C++ compiler, code editor, and related tools in Visual Studio to develop programs for Windows, Linux, Android and iOS."
ms.date: 09/20/2021
description: "Learn how to use the Microsoft C/C++ compiler and related tools to develop C++ and assembly programs for Windows, Linux, Android, and iOS."
ms.date: 04/20/2022
ms.technology: "cpp-ide"
helpviewer_keywords: ["Visual C++, home page"]
---
Expand Down Expand Up @@ -45,9 +45,9 @@ helpviewer_keywords: ["Visual C++, home page"]

Microsoft Visual C++ (MSVC) refers to the C++, C, and assembly language development tools and libraries available as part of Visual Studio on Windows. These tools and libraries let you create Universal Windows Platform (UWP) apps, native Windows desktop and server applications, cross-platform libraries and apps that run on Windows, Linux, Android, and iOS, as well as managed apps and libraries that use the .NET Framework. You can use MSVC to write anything from simple console apps to the most sophisticated and complex apps for Windows desktop, from device drivers and operating system components to cross-platform games for mobile devices, and from the smallest IoT devices to multi-server high performance computing in the Azure cloud.

Visual Studio 2015, 2017 and 2019 can be installed side-by-side. You can use Visual Studio 2019 (compiler toolset v142) or Visual Studio 2017 (v141) to edit and build programs using the toolset from Visual Studio 2017 (v141) and Visual Studio 2015 (v140).
Visual Studio 2015, 2017, 2019, and 2022 can be installed side-by-side. You can use Visual Studio 2019 (compiler toolset v142) or Visual Studio 2017 (v141) to edit and build programs using the toolset from Visual Studio 2017 (v141) and Visual Studio 2015 (v140).

## What's New and Conformance History
## What's new for C++ in Visual Studio

[What's New for C++ in Visual Studio](what-s-new-for-visual-cpp-in-visual-studio.md)\
Find out what's new in Visual Studio.
Expand All @@ -64,7 +64,7 @@ Find feature-level language conformance status in the MSVC compiler by Visual St
[Microsoft C/C++ change history 2003 - 2015](../porting/visual-cpp-change-history-2003-2015.md)\
Learn about the breaking changes in previous versions.

## Install Visual Studio and upgrade from earlier versions
## Install Visual Studio C++ and upgrade from earlier versions

[Install C++ support in Visual Studio](../build/vscpp-step-0-installation.md)\
Download Visual Studio and install the Microsoft C/C++ toolset.
Expand All @@ -78,7 +78,7 @@ Find out about different Visual Studio editions.
[Supported platforms](supported-platforms-visual-cpp.md)\
Find out which platforms the Microsoft C/C++ compiler supports.

## Learn C++
## Learn C++ using Visual Studio

[Welcome back to C++](../cpp/welcome-back-to-cpp-modern-cpp.md)\
Learn more about modern C++ programming techniques based on C++11 and later that enable you to write fast, safe code and avoid many of the pitfalls of C-style programming.
Expand All @@ -92,7 +92,7 @@ Start learning how to write C++ in Visual Studio.
[Visual Studio C++ samples](visual-cpp-samples.md)\
Information about the C++ code samples provided by Microsoft.

## C++ development tools
## Visual Studio C/C++ development tools

[Overview of C++ development in Visual Studio](overview-of-cpp-development.md)\
How to use the Visual Studio IDE to create projects, edit code, link to libraries, compile, debug, create unit tests, do static analysis, deploy, and more.
Expand All @@ -112,17 +112,17 @@ Use SAL annotations or the C++ Core Guidelines checkers to perform static analys
[Write unit tests for C/C++ in Visual Studio](/visualstudio/test/writing-unit-tests-for-c-cpp)\
Create unit tests using the Microsoft Unit Testing Framework for C++, Google Test, Boost.Test, or CTest.

## Write applications in C++

[Universal Windows Apps (C++)](../cppcx/universal-windows-apps-cpp.md)\
Find guides and reference content on the Windows Developer Center. For information about developing UWP apps, see [Intro to the Universal Windows Platform](/windows/uwp/get-started/universal-application-platform-guide) and [Create your first UWP app using C++](/windows/uwp/get-started/create-a-basic-windows-10-app-in-cpp).
## Write C/C++ applications using Visual Studio

[Desktop applications (C++)](../windows/desktop-applications-visual-cpp.md)\
Learn how to create traditional native C++ desktop applications for Windows.

[.NET programming with C++/CLI](../dotnet/dotnet-programming-with-cpp-cli-visual-cpp.md)\
Learn how to create DLLs that enable interoperability between native C++ and .NET programs written in languages such as C# or Visual Basic.

[Universal Windows Apps (C++)](../cppcx/universal-windows-apps-cpp.md)\
Find guides and reference content on the Windows Developer Center. For information about developing UWP apps, see [Intro to the Universal Windows Platform](/windows/uwp/get-started/universal-application-platform-guide) and [Create your first UWP app using C++](/windows/uwp/get-started/create-a-basic-windows-10-app-in-cpp).

[Linux programming](../linux/index.yml)\
Use the Visual Studio IDE to code and deploy to a remote Linux machine for compilation with GCC.

Expand All @@ -144,21 +144,27 @@ Connect to databases using ODBC and OLE DB.
[Text and strings](../text/text-and-strings-in-visual-cpp.md)\
Learn about working with different text and string formats and encodings for local and international development.

## Languages reference
## C/C++ language reference

[C++ language reference](../cpp/cpp-language-reference.md)\
The reference guide to the Microsoft implementation of the C++ programming language.

[C language reference](../c-language/c-language-reference.md)\
The reference guide to the Microsoft implementation of the C programming language.

[C/C++ preprocessor reference](../preprocessor/c-cpp-preprocessor-reference.md)\
A common reference to the shared C and C++ language preprocessor.

[C language reference](../c-language/c-language-reference.md)\
The reference guide to the Microsoft implementation of the C programming language.
[C++/CX language reference](/cpp/cppcx/visual-c-language-reference-c-cx)\
The reference guide to the Microsoft extensions to the C++ language for creating C++ Universal Windows Platform apps, C++ Windows runtime components that can be consumed by JavaScript-based Windows apps, and Windows DirectX games and graphics-intensive apps.

[C++/CLI language reference](https://www.ecma-international.org/wp-content/uploads/ECMA-372_1st_edition_december_2005.pdf)\
The ECMA standard for the C++/CLI programming language.

[Compiler intrinsics and assembly language](../intrinsics/compiler-intrinsics-and-assembly-language.md)\
Guides to the compiler intrinsics supported or implemented by the Microsoft C/C++ compilers on each platform.

## C++ Libraries in Visual Studio
## C/C++ libraries available in Visual Studio

The following sections provide information about the different C and C++ libraries that are included in Visual Studio.

Expand Down Expand Up @@ -186,11 +192,11 @@ Universal Windows Platform (UWP) apps and components.
[.NET programming with C++/CLI](../dotnet/dotnet-programming-with-cpp-cli-visual-cpp.md)\
Programming for the common language runtime (CLR).

## Third-party open source C++ libraries
## Third-party open source C++ libraries in Visual Studio

The cross-platform **vcpkg** command-line tool greatly simplifies the discovery and installation of over 900 C++ open source libraries. For more information, see [vcpkg](https://vcpkg.io/).

## Feedback and community
## Visual Studio C++ feedback and community

[Microsoft Docs Q&A](/answers/topics/c%2B%2B.html)\
Microsoft Docs hosts searchable forums for questions and answers. Add a `C++` tag to your post for community assistance on C++-related issues.
Expand Down