TFS Version Control Integration

TFS Version Control Integration in MATLAB and Simulink.
Updated 30 May 2017

View License


This project provides TFS Version Control integration in MATLAB and Simulink.

This project is built on top of the TFS JAVA SDK, which is part of the Team Explorer Everywhere project:

Installing and using the app

Open MATLAB and double click the "TFS Version Control Integration.mlappinstall" file. Follow the prompts to install the app. See appReadMe.txt for more details on setup and usage.

Building the source code with Ant

  1. Install MATLAB, at least version R2016b.

  2. Install the Java 8 Development Kit and the Java 7 Runtime. The MATLAB SDK uses Java 1.7 as its target, so in theory JDK 1.7 should be sufficient, but only the JDK 8 + JRE 7 configuration has been validated.

  3. Install Apache Ant(TM) version 1.9.7.

  4. Set the JAVA_HOME environment variable. ex:

    • (Windows) SET JAVA_HOME=C:\Program Files\Java\jdk1.8.0_65
    • (Mac) JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_65/Contents/Home
    • (Linux) JAVA_HOME=~/java/jdk1.8.0_65
  5. Ensure that the JAVA_HOME bin directory and the Ant bin directory are on the PATH. ex:

    • (Windows) SET PATH=C:\Program Files\apache-ant-1.9.7\bin;%JAVA_HOME%\bin;%PATH%
    • (Mac) PATH=~/apache-ant-1.9.7/bin:$JAVA_HOME/bin:$PATH
    • (Linux) PATH=~/apache-ant-1.9.7/bin:$JAVA_HOME/bin:$PATH
  6. Download junit-4.12.jar, hamcrest-all-1.3.jar, and hamcrest-core-1.3.jar. The MathWorks test framework has a dependency on them.

    By default, it's expected that junit-4.12.jar, hamcrest-all-1.3.jar, and hamcrest-core-1.3.jar are saved in the test folder, but a custom folder can be used (see next step).

  7. Navigate to the src directory and run:

    • ant compile

    Note that the build.xml file needs the path to your MATLAB installation, the Java 7 runtime directory containing rt.jar, and the test dependency jar files. Default Windows values are provided in the file, but you can overwrite them on the command line:

    • ant compile "-Dmatlab.root.dir=D:/MATLAB/R2017a" "-Djre7.lib.dir=D:/jre7/lib" "-Dtest.dependency.dir=D:/java/test"
  8. To delete all build output, run:

    • ant clean


This directory contains the distributables consumed by MATLAB to integrate with TFS Version Control. While build outputs aren't typically checked into a GitHub repository, the MATLAB File Exchange's GitHub integration appears to only pull from sources for now. (MATLAB .m files don't need to be compiled)

The dist/integration directory contains the .jar built following the steps in the "Building with Ant" section above.

The dist/TFS-SDK directory contains the TFS Java SDK redistributable. The contents of this directory were compiled from the releases/14.0.3 branch of the Team Explorer Everywhere GitHub repository:


The automated test cases are written in two different classes:

  • src/com/mathworks/cmlink/sdk/tests/

    This class is included in the MATLAB SDK

    Some of the test cases have been modified to account for TFS-specific behaviors, primarily around how directories are handled. These test changes are indicated by the comment "CHANGE FROM ORIGINAL TEST".

    The test rule in src/com/mathworks/cmlink/sdk/tests/util/ has also been modified to add some custom post-test cleanup of TFS Workspaces.

  • src/com/microsoft/tfs/mathworksintegration/tests/cmlink/

    This class contains additional tests for the TfsAdapter and its unique features.

Before running these tests, the following pre-requisite setup must be performed:

  • Open MATLAB and navigate to your local copy of this repository.
  • Run the storeTfsSettings.m script.
  • Supply a TFS server that uses Windows authentication. Windows authentication is used to avoid credential prompts during the execution of the tests.
  • On the TFS server, create a WorkItem to associate test commits with. Set the KnownWorkItemId value in src/com/microsoft/tfs/mathworksintegration/tests/cmlink/ to this value. The default is 1.
  • On the TFS server, create a project where test checkins can be made. Set the TestCheckinPath value in src/com/microsoft/tfs/mathworksintegration/tests/cmlink/ to a path under this new project where test checkins will be made. The default value is $/Test/CmlinkTests.

To launch the tests, navigate to the src directory and run:

  • ant compile
  • ant runTests

For manual testing, open MATLAB and navigate to your local copy of this repository. Run the installTFS.m script and restart MATLAB. You can now execute TFS operations from the MATLAB UI. Run the uninstallTFS.m script when complete. See appReadMe.html for some more details on usage.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact with any additional questions or comments.

Cite As

Jasper Schneider (2024). TFS Version Control Integration (, MATLAB Central File Exchange. Retrieved .

MATLAB Release Compatibility
Created with R2017a
Compatible with any release
Platform Compatibility
Windows macOS Linux
Find more on Source Control Integration in Help Center and MATLAB Answers

Community Treasure Hunt

Find the treasures in MATLAB Central and discover how the community can help you!

Start Hunting!

Versions that use the GitHub default branch cannot be downloaded

Version Published Release Notes

Update to the R2016b source control adapter SDK.

Update app instructions