mirror of
https://github.com/eclipse-cdt/cdt
synced 2025-04-29 19:45:01 +02:00
Add "Creating a CMake Project" help page
Some checks failed
License vetting status check / call-license-check (push) Failing after 0s
Build and Test / build (push) Has been cancelled
Code Cleanliness Checks / build (push) Has been cancelled
Some checks failed
License vetting status check / call-license-check (push) Failing after 0s
Build and Test / build (push) Has been cancelled
Code Cleanliness Checks / build (push) Has been cancelled
This commit is contained in:
parent
fb20d6cc9a
commit
9b6bb0711f
3 changed files with 69 additions and 0 deletions
BIN
doc/org.eclipse.cdt.doc.user/images/c_cpp_project_wizard.png
Normal file
BIN
doc/org.eclipse.cdt.doc.user/images/c_cpp_project_wizard.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 127 KiB |
|
@ -0,0 +1,68 @@
|
|||
////
|
||||
Copyright (c) 2000-2024 QNX Software Systems and others
|
||||
This program and the accompanying materials
|
||||
are made available under the terms of the Eclipse Public License 2.0
|
||||
which accompanies this distribution, and is available at
|
||||
https://www.eclipse.org/legal/epl-2.0/
|
||||
|
||||
SPDX-License-Identifier: EPL-2.0
|
||||
|
||||
Contributors:
|
||||
QNX Software Systems - original makefile project content
|
||||
John Dallaway - initial CMake project content (#935)
|
||||
////
|
||||
|
||||
// support image rendering and table of contents within GitHub
|
||||
ifdef::env-github[]
|
||||
:imagesdir: ../../images
|
||||
:toc:
|
||||
:toc-placement!:
|
||||
endif::[]
|
||||
|
||||
// enable support for button, menu and keyboard macros
|
||||
:experimental:
|
||||
|
||||
= Creating a CMake project
|
||||
|
||||
This tutorial describes the process of creating a new C/C++ project that includes a CMakeLists.txt file.
|
||||
|
||||
You need to create a project to contain your source code and related files.
|
||||
A project has an associated builder that can incrementally compile source files as they are changed.
|
||||
|
||||
To create a project:
|
||||
|
||||
. Select menu:File[New > Project].
|
||||
|
||||
+
|
||||
When you create a new project, you are required to specify the project type.
|
||||
This project type will determine the toolchain, data, and tabs that the CDT uses/displays.
|
||||
|
||||
. Select the type of project to create. For this tutorial, expand the *C/{cpp}* folder and select *C/C++ Project*.
|
||||
. Click btn:[Next].
|
||||
|
||||
+
|
||||
The *C/C++ Project* wizard opens:
|
||||
|
||||
+
|
||||
image:c_cpp_project_wizard.png[width=515]
|
||||
|
||||
+
|
||||
By default, the CDT presents all *C/C++ Project* templates.
|
||||
|
||||
. Select the *CMake* template filter and choose from the following *CMake* project templates:
|
||||
|
||||
+
|
||||
- *CMake Project* - provides a simple C++ Hello World executable application project with main() and a supporting CMakeLists.txt file.
|
||||
- *Empty or Existing CMake Project* - provides an empty executable application project suitable for importing existing source and CMakeLists.txt files.
|
||||
|
||||
. Click btn:[Next].
|
||||
. In the *Project name* field, provide a name for the new project.
|
||||
. Leave the *Use Default Location* option selected.
|
||||
. Click btn:[Finish].
|
||||
. If a message box prompts you to change perspectives, click btn:[Yes].
|
||||
|
||||
Your new project displays in the Project Explorer view.
|
||||
Your project may be empty because you have not yet created files for your project.
|
||||
You can now start writing the code for your application or importing code from elsewhere.
|
||||
|
||||
icon:arrow-circle-right[] link:pass:[../getting_started/cdt_w_newcpp.htm][Next: Creating your C++ file]
|
|
@ -4,6 +4,7 @@
|
|||
<topic label="Preparing the Workbench" href="getting_started/cdt_w_prepare_workbench.htm"/>
|
||||
<topic label="Creating a simple application" href="getting_started/cdt_w_basic.htm"/>
|
||||
<topic label="Creating a Makefile project" href="getting_started/cdt_w_newproj.htm"/>
|
||||
<topic label="Creating a CMake project" href="html/new_cmake_proj.html"/>
|
||||
<topic label="Importing an existing project" href="getting_started/cdt_w_import.htm"/>
|
||||
<topic href="getting_started/cdt_w_newcpp.htm" label="Creating a C++ file"/>
|
||||
<topic href="getting_started/cdt_w_newmake.htm" label="Creating a makefile"/>
|
||||
|
|
Loading…
Add table
Reference in a new issue