You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
:alt:The project type selector of the WPILib New Project Creator
119
119
120
-
The elements of the New Project Creator Window are explained below:
120
+
The **Project Type** chooses between an empty template project of one of the base classes, or a :doc:`WPILib example project </docs/software/examples-tutorials/wpilib-examples>`. Additionally, a template exists for :ref:`Command-based <docs/software/commandbased/commands-v2/what-is-command-based:What is "command-based" programming?>` projects, which are built on the :code:`TimedRobot` base class but include a number of additional features - this type of robot program is highly recommended for new teams.
121
121
122
-
1. **Project Type**: The kind of project we wish to create. This can be an example project, or one of the project templates provided by WPILib. Templates exist for each of the robot base classes. Additionally, a template exists for :ref:`Command-based <docs/software/commandbased/commands-v2/what-is-command-based:What is "command-based" programming?>` projects, which are built on the :code:`TimedRobot` base class but include a number of additional features - this type of robot program is highly recommended for new teams.
123
-
2. **Language**: This is the language (C++ or Java) that will be used for this project.
124
-
3. **Base Folder**: If this is a template project, this specifies the type of template that will be used.
125
-
4. **Project Location**: This determines the folder in which the robot project will be located.
126
-
5. **Project Name**: The name of the robot project. This also specifies the name that the project folder will be given if the Create New Folder box is checked.
127
-
6. **Create a New Folder**: If this is checked, a new folder will be created to hold the project within the previously-specified folder. If it is *not* checked, the project will be located directly in the previously-specified folder. An error will be thrown if the folder is not empty and this is not checked.
128
-
7. **Team Number**: The team number for the project, which will be used for package names within the project and to locate the robot when deploying code.
129
-
8. **Enable Desktop Support**: Enables unit test and simulation support (see :doc:`/docs/software/wpilib-tools/robot-simulation/introduction`).
122
+
After making the selections, click :guilabel:`Next`.
130
123
131
-
- **Java**: This option has no effect and can be left checked or unchecked
132
-
- **C++**: Checking this option enables desktop compilation, which is required for simulation and unit tests
133
-
- **Romi/XRP**: This option has no effect for Romi and XRP templates and can be left checked or unchecked
124
+
This will bring up the language and base selection window.
134
125
135
-
.. note:: While WPILib fully supports desktop builds, some third-party vendor libraries may not. If a library doesn't support desktop compilation, your C++ code may not compile or may crash when running simulation.
:alt:The project and configuration page of the WPILib New Project Creator
138
+
139
+
1. **Base Folder**: This determines the folder in which the robot project will be located.
140
+
2. **Project Name**: The name of the robot project. This also specifies the name that the project folder will be given if the Create New Folder box is checked.
141
+
3. **Create a New Folder**: If this is checked, a new folder will be created to hold the project within the previously-specified folder. If it is *not* checked, the project will be located directly in the previously-specified folder. An error will be thrown if the folder is not empty and this is not checked.
142
+
4. **Team Number**: The team number for the project, which will be used for package names within the project and to locate the robot when deploying code.
143
+
5. **Enable Desktop Support**: Enables unit test and simulation support (see :doc:`/docs/software/wpilib-tools/robot-simulation/introduction`).
140
144
141
145
.. warning:: Creating projects on OneDrive is not supported as OneDrive's caching interferes with the build system. Some Windows installations put the Documents and Desktop folders on OneDrive by default.
142
146
143
-
An example after all options are selected is shown below.
147
+
Once all the above have been configured, click :guilabel:`Next`.
:alt:The review and create page of the WPILib New Project Creator
153
+
154
+
Double check all the settings and click :guilabel:`Create Project`. If anything is not correct, click :guilabel:`Back` and make the necessary corrections.
155
+
156
+
.. note:: Any errors in project generation will appear in the bottom right-hand corner of the screen.
:alt:The different parts of the new project creation window.
22
+
:alt:The project type selector of the WPILib New Project Creator
23
23
24
-
The elements of the New Project Creator Window are explained below:
24
+
The **Project Type** chooses between an empty template project, or a :doc:`WPILib example project </docs/software/examples-tutorials/wpilib-examples>`. For this example, select :guilabel:`Example` and then choose :guilabel:`Next`.
25
25
26
-
1. **Project Type**: The kind of project we wish to create. For this example, select **Example**
27
-
2. **Language**: This is the language (C++ or Java) that will be used for this project.
28
-
3. **Project Base**: This box is used to select the base class or example to generate the project from. For this example, select **Getting Started**
29
-
4. **Base Folder**: This determines the folder in which the robot project will be located.
30
-
5. **Project Name**: The name of the robot project. This also specifies the name that the project folder will be given if the Create New Folder box is checked.
31
-
6. **Create a New Folder**: If this is checked, a new folder will be created to hold the project within the previously-specified folder. If it is *not* checked, the project will be located directly in the previously-specified folder. An error will be thrown if the folder is not empty and this is not checked. project folder will be given if the Create New Folder box is checked.
32
-
7. **Team Number**: The team number for the project, which will be used for package names within the project and to locate the robot when deploying code.
33
-
8. **Enable Desktop Support**: Enables unit test and simulation. While WPILib supports this, third party software libraries may not. If libraries do not support desktop, then your code may not compile or may crash. It should be left unchecked unless unit testing or simulation is needed and all libraries support it. For this example, do not check this box.
26
+
This will bring up the language and base selection window.
34
27
35
-
Once all the above have been configured, click "Generate Project" and the robot project will be created.
:alt:The project and configuration page of the WPILib New Project Creator
40
+
41
+
1. **Base Folder**: This determines the folder in which the robot project will be located.
42
+
2. **Project Name**: The name of the robot project. This also specifies the name that the project folder will be given if the Create New Folder box is checked.
43
+
3. **Create a New Folder**: If this is checked, a new folder will be created to hold the project within the previously-specified folder. If it is *not* checked, the project will be located directly in the previously-specified folder. An error will be thrown if the folder is not empty and this is not checked.
44
+
4. **Team Number**: The team number for the project, which will be used for package names within the project and to locate the robot when deploying code.
45
+
5. **Enable Desktop Support**: Enables unit test and simulation support (see :doc:`/docs/software/wpilib-tools/robot-simulation/introduction`). While WPILib supports this, third party software libraries may not. If libraries do not support desktop, then your code may not compile or may crash. It should be left unchecked unless unit testing or simulation is needed and all libraries support it. For this example, do not check this box.
38
46
39
47
.. warning:: Creating projects on OneDrive is not supported as OneDrive's caching interferes with the build system. Some Windows installations put the Documents and Desktop folders on OneDrive by default.
40
48
49
+
Once all the above have been configured, click :guilabel:`Next`.
:alt:The review and create page of the WPILib New Project Creator
55
+
56
+
Double check all the settings and click :guilabel:`Create Project`. If anything is not correct, click :guilabel:`Back` and make the necessary corrections.
57
+
58
+
.. note:: Any errors in project generation will appear in the bottom right-hand corner of the screen.
0 commit comments