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
{{ message }}
This repository was archived by the owner on Mar 27, 2025. It is now read-only.
Copy file name to clipboardExpand all lines: CONFIGDOC.md
+17-9Lines changed: 17 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,12 +1,20 @@
1
1
You can use the Jenkins™ plugin for MATLAB® in freestyle and multi-configuration projects. This guide demonstrates how to run MATLAB code on Jenkins, considering a Microsoft® Windows® platform.
-[Set Up Freestyle Project](#set-up-freestyle-project)
8
+
-[Set Up Multi-Configuration Project](#set-up-multi-configuration-project)
8
9
9
-
## Plugin Build Steps
10
+
## Use MATLAB for Build
11
+
Once you install the plugin on Jenkins, the **Use MATLAB version** checkbox is displayed in the **Build Environment** section of the project configuration window. Selecting the checkbox instructs Jenkins to use MATLAB for your build.
When you select the **Use MATLAB version** checkbox, you can specify the full path to the MATLAB installation folder that is used for the build. The specified directory in the **MATLAB root** box is prepended to the PATH environment variable, and the specified MATLAB version is used to perform the build. You must not leave the **MATLAB root** box blank if no MATLAB directory exists on the path. If you leave the box blank, then the system tries to use the MATLAB directory closest to the top of the system path.
16
+
17
+
## Specify Build Steps
10
18
When you set up the **Build** section of the project configuration window, the plugin provides you with the **Run MATLAB Tests** and **Run MATLAB Command** build steps.
11
19
12
20
### Run MATLAB Tests
@@ -33,18 +41,18 @@ If you need to specify several MATLAB commands, consider writing a MATLAB script
33
41
34
42
Test artifacts are not autogenerated if you choose to run tests using this build step. You can generate your desired test artifacts by configuring the test runner in the script or function that you invoke from the **Command** box.
35
43
36
-
## Freestyle Project Setup
44
+
## Set Up Freestyle Project
37
45
To configure the plugin for a freestyle project, specify the location where MATLAB is installed as well as the required build steps.
38
46
39
-
1) In the **Build Environment** section of the project configuration window, select **Use MATLAB Version**. Then, enter the value returned by the **matlabroot** function in the **MATLAB root** box.
47
+
1) In the **Build Environment** section of the project configuration window, select **Use MATLAB version**. Then, enter the value returned by the **matlabroot** function in the **MATLAB root** box.
2) Add the required build steps in the **Build** section:
44
52
* If you add the [**Run MATLAB Tests**](#run-matlab-tests) build step, select check boxes for the artifacts to be generated in the project workspace.
45
53
* If you add the [**Run MATLAB Command**](#run-matlab-command) build step, enter your commands in the **Command** box.
46
54
47
-
## Multi-Configuration Project Setup
55
+
## Set Up Multi-Configuration Project
48
56
In addition to freestyle projects, the plugin supports [multi-configuration (matrix) projects](https://wiki.jenkins.io/display/JENKINS/Building+a+matrix+project). Multi-configuration projects are useful when builds include similar steps. For example:
49
57
* The same test suite is run on different platforms (Windows, Linux, and Mac).
50
58
* The same test suite is run against different versions of MATLAB.
@@ -59,15 +67,15 @@ You can define several axes in the **Configuration Matrix** section. For example
2) In the **Build Environment** section, include the user-defined axis name in the **MATLAB root**box to specify the locations where MATLAB is installed. In this example, **$VERSION** will be replaced by one axis value per build iteration.
70
+
2) In the **Build Environment** section, select **Use MATLAB version**and then specify the locations where MATLAB is installed using the user-defined axis name. In this example, **$VERSION** in the **MATLAB root** will be replaced by one axis value per build iteration.
3) Add the required build steps in the **Build** section:
67
75
* If you add the [**Run MATLAB Tests**](#run-matlab-tests) build step, select check boxes for the artifacts to be generated in the project workspace.
68
76
* If you add the [**Run MATLAB Command**](#run-matlab-command) build step, enter your commands in the **Command** box. You can use the user-defined axes to create your commands. For example:
0 commit comments