You can create IBM Engineering Workflow
Management build
definitions that are based on various build templates, such as Ant, command line, or Maven. This
topic describes how to create and configure a IBM Engineering Workflow
Management client
for Microsoft Visual Studio IDE build definition to run the MSbuild build command for MSTest unit
tests. You can also configure a build definition to run the devenv.exe build
command and use NUnit tests (only NUnit 2.x is supported).
Procedure
- In the Eclipse client, in the Team Artifacts view,
expand the project folder.
- Right-click Builds; then click New
Build Definition.
- In the New Build Definition wizard,
on the New Build Definition page, accept the
defaults and click Next.
- On the General Information page, in
the Available build templates pane, select Jazz
Build for Microsoft Visual Studio Solution – Jazz Build Engine and
click Next.
- Optional: If you use Jazz source
control, on the Pre-build page, select Jazz
Source Control and click Next.
- On the Post-Build page, select MSTest
Configuration and click Next.
- On the Additional Configuration page,
select the appropriate options and click Finish.
- In the Build Definition editor, click
the Microsoft Build tab and complete the following
steps:
Note: The MSBuild definition supports building multiple
solutions and projects. To configure multiple solutions or projects,
you can complete the fields below in table format.
- Click the MSbuild radio button.
- In the Path to build command field,
type the location of the build command. For example, c:\WINDOWS\Microsoft.NET\Framework\v3.5.
- In the Solution file name field,
type the name (including file extension) of the solution file to build.
For example, Bank.sln.
- In the Build Configuration field,
type the configuration to build. For example, Debug.
- Complete any remaining options.
- Click the MSTest Configuration tab
and complete the following steps:
- In the Path field, type the path
to MSTest.exe. For example, C:\Program
Files\Microsoft Visual Studio 9.0\Common7\IDE\MSTest.exe.
- In the MSTest specification file field,
type the name of the MSTest specification file to use. For example, AutoTests.trx.
- In the Additional arguments field,
type any additional arguments to the MSTest command.
- In the Working directory field,
type the directory to be used by the MSTest process.
- Optional: To schedule builds, complete the
following steps:
- Click the Schedule tab.
- To enable build scheduling, under Schedule,
select Enable.
- Click Add.
- In the Build Time pane, specify
either continuous build intervals in minutes, or a specific build
time.
- In the Build Days pane, select
the days of the week that the build runs.
- Optional: If you selected Jazz Source Control
in Step 5, complete the
following steps:
Note: It is highly recommended for the
build definition to refer to a dedicated build workspace, rather than
the team's stream, so that builds are isolated from ongoing changes
in the stream.
- Click the Jazz Source Control tab.
- To specify a repository workspace, in the Build
workspace pane, click Create.
- In the New Repository Workspace Wizard,
on the Select a stream page, select Flow
with a stream and in the lower pane, select the repository
stream that you want to build from. This selection enables the repository
workspace to accept changes from the stream.
- Click Next.
- On the New Repository Workspace page,
in the Repository Workspace Name field, rename
the repository workspace and click Next.
- On the Components to Add page,
ensure that your component is selected.
- Ensure that the Load repository workspace
after creation check box is cleared and click Finish.
- To specify a build user for the build workspace, in
the Workspace Owner dialog box, to open the workspace,
click Open Workspace.
- In the Repository Workspace editor,
in the Owned by field, browse to the location
of your special-purpose build user.
- Click Save.
- In the Build Definition editor,
in the Load Options pane, in the Load
directory field, type the path to the directory on the
build machine where workspace files load.
- Optional:
To define a subset of component files and folders for the build to load, select
Load components by using a load rule file and select a load rule file. When a
load rule file is specified, only those components that have load rules specified are loaded, and
they are loaded according to those rules.
- Click Save.
What to do next
In the IBM Engineering Workflow
Management client
for Microsoft Visual Studio IDE, in the Team Artifacts window, you can navigate to the
Builds folder (under the project folder) and request builds or view build
results. You can also use a context menu action to move a build definition folder (or build
definition). For information about creating build definition folders, see Organizing build definitions into folders.