此存储库使您可以轻松地在一些最常见的CI平台上运行MATLAB测试.zip

| **Azure^&reg;&nbsp;DevOps** | **CircleCI^&reg;** | **GitHub^&reg;&nbsp;Actions** | **Travis&nbsp;CI&trade;** | |:---------------------------|:-----------------:|:----------------------------:|:--------------------------:| | [](https://dev.azure.com/iat-ci/ci-configuration-examples/_build) <br>  | [](https://circleci.com/gh/mathworks/ci-configuration-examples) <br><br> | [](https://github.com/mathworks/ci-configuration-examples/actions/workflows/ci.yml) <br><br> | [](https://app.travis-ci.com/mathworks/ci-configuration-examples) <br><br> | # Continuous Integration (CI) configuration examples for MATLAB^&reg; Are you interested in automating your testing with CI? Not sure how to connect MATLAB with CI systems? We've got you covered! This repository makes it easy to run your MATLAB tests on some of the most common CI platforms. The configuration files take care of setting up MATLAB to work with the CI system and automatically executing your MATLAB tests. <br> ## Getting started ### <u>Quick start guide</u> Here's how to quickly get this repository running on a CI system: 1. Fork the repository to your own GitHub account 2. Go to one of the supported CI platforms and install the available MATLAB CI plugin ***Note:*** GitHub Actions does not require this step 3. Create a new CI job using your forked repository 4. Enjoy using CI with MATLAB! That's really it! To use your MATLAB code or Simulink^&reg; models with this repository, simply replace the existing code and tests in "code" and "tests" with your own code and tests. There's no need to modify any of the CI configuration files because they are all completely agnostic of the MATLAB code being used. ***Notes:*** * In most cases, the configuration files will automatically get picked up by the CI platform during step 3, but some platforms may require you to specify which file to use * The default branch for this repository is "main" <br> ### <u>Step-by-step getting started guide for GitHub Actions</u> Our Continuous Integration with MATLAB and GitHub Actions Workshop provides a step-by-step guide for getting started with GitHub Actions. * https://github.com/mathworks/ci-with-matlab-and-github-actions-workshop <br> ## Badges Badges look really great, but they're not always easy to set up. Take a look at the badges, badge code, and reference links below to get started with badges for your repository. <br> | **Azure&nbsp;DevOps** | | |:---------------------------|:-| | Badges | [](https://dev.azure.com/iat-ci/ci-configuration-examples/_build) <br>  | | Badge Code | \[\!\[Build Status](https[]()://dev.azure.com/***AZURE_DEVOPS_ORG***/***AZURE_DEVOPS_PROJECT_NAME***/_apis/build/status/***GITHUB_USERNAME***.***GITHUB_REPO_NAME***)](https[]()://dev.azure.com/***AZURE_DEVOPS_ORG***/***AZURE_DEVOPS_PROJECT_NAME***/_build) <br><br> \!\[Azure DevOps Coverage](https[]()://img.shields.io/azure-devops/coverage/***AZURE_DEVOPS_ORG***/***AZURE_DEVOPS_PROJECT_NAME***/***AZURE_DEVOPS_DEFINITION_ID***) | | Badge Help | [Blog with helpful information for setting up Azure DevOps badges](https://gregorsuttie.com/2019/03/20/azure-devops-add-your-build-status-badges-to-your-wiki/) | <br> | **CircleCI** | | |:------------------|:-| | Badge | [](https://circleci.com/gh/mathworks/ci-configuration-examples) | | Badge Code | \[\!\[CircleCI](https[]()://circleci.com/***SOURCE_CONTROL_SYSTEM***/***GITHUB_USERNAME***/***GITHUB_REPO_NAME***.svg?style=svg)](https[]()://circleci.com/***SOURCE_CONTROL_SYSTEM***/***GITHUB_USERNAME***/***GITHUB_REPO_NAME***) | | Badge Help | [CircleCI documentation for setting up badges](https://circleci.com/docs/2.0/status-badges "CircleCI documentation for setting up badges") | <br> | **GitHub&nbsp;Actions** | | |:-----------------------------|:-| | Badge | [](https://github.com/mathworks/ci-configuration-examples/actions/workflows/ci.yml) | | Badge Code | \[\!\[MATLAB](https[]()://github.com/***GITHUB_USERNAME***/***GITHUB_REPO_NAME***/actions/workflows/ci.yml/badge.svg)](https[]()://github.com/***GITHUB_USERNAME***/***GITHUB_REPO_NAME***/actions/workflows/ci.yml) | | Badge Help | [GitHub Actions documentation for setting up badges](https://docs.github.com/en/actions/managing-workflow-runs/adding-a-workflow-status-badge) | <br> | **Travis&nbsp;CI** | | |:--------------------------|:-| | Badge | [](https://app.travis-ci.com/mathworks/ci-configuration-examples) | | Badge Code | \[\!\[Build Status](https[]()://app.travis-ci.com/***GITHUB_USERNAME***/***GITHUB_REPO_NAME***.svg)](https[]()://app.travis-ci.com/***GITHUB_USERNAME***/***GITHUB_REPO_NAME***) | | Badge Help | [Travis CI documentation for setting up badges](https://docs.travis-ci.com/user/status-images/ "Travis CI documentation for setting up badges") | <br> | **GitLab&nbsp;CI/CD** | | |:--------------------------|:-| | Badge Code | \[\!\[Pipeline Status](https[]()://gitlab.com/***GITLAB_PROJECT_PATH***/badges/***DEFAULT_BRANCH_NAME***/pipeline.svg)](https[]()://gitlab.com/***GITLAB_PROJECT_PATH***) | | Badge Help | [GitLab CI/CD documentation for setting up badges](https://docs.gitlab.com/ee/user/project/badges.html "GitLab CI/CD documentation for setting up badges") | <br> **How to use the Badge Code:** 1. Copy-paste the badge code into your README.md file * The badge code you copy should start with "`[!`" and not "`\[\!`" 2. Replace all ***BOLD+ITALIC*** names with your specific credentials/names * Replace ***GITHUB_ORG*** with your GitHub organization name (usually your GitHub username) * Replace ***GITHUB_REPO_NAME*** with the name of your GitHub repository * Replace ***SOURCE_CONTROL_SYSTEM*** with the name of the source control system you are pointing to (gh = GitHub, bb = BitBucket) * Replace ***AZURE_DEVOPS_ORG*** with the name of your Azure DevOps organization name (usually your Azure DevOps username) * Replace ***AZURE_DEVOPS_PROJECT_NAME*** with the name of the Azure DevOps project that will run the CI job * Replace ***AZURE_DEVOPS_DEFINITION_ID*** with the definition ID for your Azure DevOps pipeline * To find the definition ID for your Azure DevOps pipeline, you must: * go to your Azure DevOps project * select "Pipelines" from the left-side navigation menu * select the pipeline you want to get coverage for * look at the end of the resulting URL for the number in "definitionId=###" * Replace ***GITLAB_PROJECT_PATH*** with the path of your GitLab project * Replace ***DEFAULT_BRANCH_NAME*** with the repository branch name you want to get the pipeline status from <br> <br> ## Supported CI platforms * Azure DevOps * CircleCI * GitHub Actions * Jenkins&trade; * Travis CI * GitLab CI/CD <br> ## About the code The primary goal of this repository is to provide a set of configuration files as templates that illustrate how to run MATLAB on various CI platforms (e.g., Azure DevOps, CircleCI, GitHub Ac