Semantic Versioning using GitVersion YAML file for your .NET, Java, and Kotlin projects’ CI/CD

0377

Main article at GitHub

What is Semantic Versioning?

Semantic Versioning (SemVer) is a versioning scheme that uses a three-part version number: MAJOR.MINOR.PATCH. It helps to convey meaning about the underlying changes in a new release:

  • MAJOR version changes indicate incompatible API changes.
  • MINOR version changes add functionality in a backward-compatible manner.
  • PATCH version changes are for backward-compatible bug fixes.

What is GitVersion?

GitVersion is a tool that automatically generates a semantic version number based on your Git history. It analyzes your repository’s commit history and branch structure to determine the appropriate version number.

All you need to do is:

  1. Prepare your desired GitVersion.yml file.
  2. Add it to the root path of your project/Module directory, where your .git directory exists.
  3. Prepare the build:
    • If you are using .NET:
    • If you are using Java/Kotlin:
      • Add the necessary tasks to create the gitversion.json file by GitVersion CLI to parse the right version for your projects.
  4. Boom! Build your solution (in .NET) / main module (in Java/Kotlin)

Preparing GitVersion.yml

You can find a detailed explanation for configuring your GitVersion.yml file on gitversion.net. Alternatively, you can use the sample I prepared based on GitFlow (GitFlow/v1) available in my GitHub: 

<span># This configuration uses GitFlow branching model which always has a main and a develop branch. see: https://nvie.com/posts/a-successful-git-branching-model/</span>
<span># This configuration follows Semantic Versioning. see: https://semver.org/</span>
<span># A good explanation on semantic versioning: https://semantic-versioning.org/</span>
<span>workflow</span><span>:</span> <span>GitFlow/v1</span>
<span>assembly-versioning-scheme</span><span>:</span> <span>MajorMinorPatchTag</span>
<span>assembly-file-versioning-scheme</span><span>:</span> <span>MajorMinorPatchTag</span>
<span>assembly-informational-format</span><span>:</span> <span>"</span><span>{FullSemVer}"</span>
<span>tag-prefix</span><span>:</span> <span>"</span><span>[vV]?"</span>
<span>version-in-branch-pattern</span><span>:</span> <span>(?<version>[vV]?\d+(\.\d+)?(\.\d+)?).*</span>
<span>major-version-bump-message</span><span>:</span> <span>'</span><span>\+semver:\s?(breaking|major)'</span>
<span>minor-version-bump-message</span><span>:</span> <span>'</span><span>\+semver:\s?(feature|minor)'</span>
<span>patch-version-bump-message</span><span>:</span> <span>'</span><span>\+semver:\s?(fix|patch)'</span>
<span>no-bump-message</span><span>:</span> <span>'</span><span>\+semver:\s?(none|skip)'</span>
<span>tag-pre-release-weight</span><span>:</span> <span>60000</span>
<span>commit-date-format</span><span>:</span> <span>"</span><span>yyyy-MM-dd"</span>
<span>merge-message-formats</span><span>:</span> <span>{}</span>
<span>update-build-number</span><span>:</span> <span>true</span>
<span>semantic-version-format</span><span>:</span> <span>Strict</span> <span>#ensure that versions are consistently formatted and that the versioning process remains predictable and reliable. This can be particularly important for projects with strict dependency management and release policies.</span>
<span>strategies</span><span>:</span>
  <span>-</span> <span>Fallback</span> <span>#This strategy is used when no other versioning strategy applies. It ensures that a version is always generated, even if no tags or commits indicate a version change.</span>
  <span>#ConfiguredNextVersion: #This strategy allows you to manually specify the next version number. It's useful for scenarios where you want to control the versioning process directly.</span>
  <span>-</span> <span>MergeMessage</span> <span>#This strategy increments the version based on the merge commit message. If the message contains specific keywords (e.g., "version bump"), the version number is incremented accordingly.</span>
  <span>#- TaggedCommit #This strategy uses the commit tagged with a version number to determine the next version. It's useful for projects that follow a strict versioning policy based on tags.</span>
  <span>-</span> <span>TrackReleaseBranches</span> <span>#This strategy tracks branches that are used for releases. It ensures that the version number is incremented based on the commits made to these branches.</span>
  <span>-</span> <span>VersionInBranchName</span> <span>#This strategy extracts the version number from the branch name itself. It's useful for projects that use branch names to indicate version information.</span>
<span>branches</span><span>:</span>
<span>......</span>
<span># This configuration uses GitFlow branching model which always has a main and a develop branch. see: https://nvie.com/posts/a-successful-git-branching-model/</span>
<span># This configuration follows Semantic Versioning. see: https://semver.org/</span>
<span># A good explanation on semantic versioning: https://semantic-versioning.org/</span>
<span>workflow</span><span>:</span> <span>GitFlow/v1</span>
<span>assembly-versioning-scheme</span><span>:</span> <span>MajorMinorPatchTag</span>
<span>assembly-file-versioning-scheme</span><span>:</span> <span>MajorMinorPatchTag</span>
<span>assembly-informational-format</span><span>:</span> <span>"</span><span>{FullSemVer}"</span>
<span>tag-prefix</span><span>:</span> <span>"</span><span>[vV]?"</span>
<span>version-in-branch-pattern</span><span>:</span> <span>(?<version>[vV]?\d+(\.\d+)?(\.\d+)?).*</span>
<span>major-version-bump-message</span><span>:</span> <span>'</span><span>\+semver:\s?(breaking|major)'</span>
<span>minor-version-bump-message</span><span>:</span> <span>'</span><span>\+semver:\s?(feature|minor)'</span>
<span>patch-version-bump-message</span><span>:</span> <span>'</span><span>\+semver:\s?(fix|patch)'</span>
<span>no-bump-message</span><span>:</span> <span>'</span><span>\+semver:\s?(none|skip)'</span>
<span>tag-pre-release-weight</span><span>:</span> <span>60000</span>
<span>commit-date-format</span><span>:</span> <span>"</span><span>yyyy-MM-dd"</span>
<span>merge-message-formats</span><span>:</span> <span>{}</span>
<span>update-build-number</span><span>:</span> <span>true</span>
<span>semantic-version-format</span><span>:</span> <span>Strict</span> <span>#ensure that versions are consistently formatted and that the versioning process remains predictable and reliable. This can be particularly important for projects with strict dependency management and release policies.</span>
<span>strategies</span><span>:</span>
  <span>-</span> <span>Fallback</span> <span>#This strategy is used when no other versioning strategy applies. It ensures that a version is always generated, even if no tags or commits indicate a version change.</span>
  <span>#ConfiguredNextVersion: #This strategy allows you to manually specify the next version number. It's useful for scenarios where you want to control the versioning process directly.</span>
  <span>-</span> <span>MergeMessage</span> <span>#This strategy increments the version based on the merge commit message. If the message contains specific keywords (e.g., "version bump"), the version number is incremented accordingly.</span>
  <span>#- TaggedCommit #This strategy uses the commit tagged with a version number to determine the next version. It's useful for projects that follow a strict versioning policy based on tags.</span>
  <span>-</span> <span>TrackReleaseBranches</span> <span>#This strategy tracks branches that are used for releases. It ensures that the version number is incremented based on the commits made to these branches.</span>
  <span>-</span> <span>VersionInBranchName</span> <span>#This strategy extracts the version number from the branch name itself. It's useful for projects that use branch names to indicate version information.</span>
<span>branches</span><span>:</span>
<span>......</span>
# This configuration uses GitFlow branching model which always has a main and a develop branch. see: https://nvie.com/posts/a-successful-git-branching-model/
# This configuration follows Semantic Versioning. see: https://semver.org/
# A good explanation on semantic versioning: https://semantic-versioning.org/
workflow: GitFlow/v1
assembly-versioning-scheme: MajorMinorPatchTag
assembly-file-versioning-scheme: MajorMinorPatchTag
assembly-informational-format: "{FullSemVer}"
tag-prefix: "[vV]?"
version-in-branch-pattern: (?<version>[vV]?\d+(\.\d+)?(\.\d+)?).*
major-version-bump-message: '\+semver:\s?(breaking|major)'
minor-version-bump-message: '\+semver:\s?(feature|minor)'
patch-version-bump-message: '\+semver:\s?(fix|patch)'
no-bump-message: '\+semver:\s?(none|skip)'
tag-pre-release-weight: 60000
commit-date-format: "yyyy-MM-dd"
merge-message-formats: {}
update-build-number: true
semantic-version-format: Strict #ensure that versions are consistently formatted and that the versioning process remains predictable and reliable. This can be particularly important for projects with strict dependency management and release policies.
strategies:
  - Fallback #This strategy is used when no other versioning strategy applies. It ensures that a version is always generated, even if no tags or commits indicate a version change.
  #ConfiguredNextVersion: #This strategy allows you to manually specify the next version number. It's useful for scenarios where you want to control the versioning process directly.
  - MergeMessage #This strategy increments the version based on the merge commit message. If the message contains specific keywords (e.g., "version bump"), the version number is incremented accordingly.
  #- TaggedCommit #This strategy uses the commit tagged with a version number to determine the next version. It's useful for projects that follow a strict versioning policy based on tags.
  - TrackReleaseBranches #This strategy tracks branches that are used for releases. It ensures that the version number is incremented based on the commits made to these branches.
  - VersionInBranchName #This strategy extracts the version number from the branch name itself. It's useful for projects that use branch names to indicate version information.
branches:
......

Enter fullscreen mode Exit fullscreen mode

Add GitVersion.yml to the root path of your project

By placing the GitVersion.yml file in the root of your solution (in .NET) or main module (in Java/Kotlin), the gitversion CLI will use it for all sub-projects or sub-modules.

In Java/Kotlin:

You can find the sample projects in my repo at GitHub:

Java project:

Kotlin project:

CSharp project:

Prepare Java/Kotlin project to generate gitversion.json file

Note: This guide is intended to use with build.gradle.kts. You can modify it to suit your needs.

  1. Open build.gradle.kts file for every single project and inject this code block into it: 
<span>//Setting this version ensures that if any issues occur during versioning, it will use the default version.</span>
<span>version</span> <span>=</span> <span>"0.1.0-SNAPSHOT"</span>
<span>//----------------------------------- Semantic Versioning / Continues Integration -------------------------------------</span>
<span>val</span> <span>gitVersionJsonFilePath</span> <span>=</span> <span>"../gitversion.json"</span> <span>// make a const for the 'gitversion.json' file path.</span>
<span>// Register an executable task to generate the 'gitversion.json' file using the 'gitversion' CLI.</span>
<span>tasks</span><span>.</span><span>register</span><span><</span><span>Exec</span><span>>(</span><span>"gitVersionOutputJSon"</span><span>)</span> <span>{</span>
    <span>commandLine</span><span>(</span><span>"sh"</span><span>,</span> <span>"-c"</span><span>,</span> <span>"gitversion /output json > $gitVersionJsonFilePath"</span><span>)</span>
<span>}</span>
<span>/* Register a task that depends on 'gitVersionOutputJson' to run after it. This task will read the 'gitversion.json' file, extract the 'SemVer' key value, and assign it to the 'project.version'. */</span>
<span>tasks</span><span>.</span><span>register</span><span>(</span><span>"parseGitVersion"</span><span>)</span> <span>{</span>
    <span>dependsOn</span><span>(</span><span>"gitVersionOutputJSon"</span><span>)</span>
    <span>doLast</span> <span>{</span>
        <span>val</span> <span>jsonSlurper</span> <span>=</span> <span>JsonSlurper</span><span>()</span>
        <span>val</span> <span>gitVersionFile</span> <span>=</span> <span>file</span><span>(</span><span>gitVersionJsonFilePath</span><span>)</span>
        <span>val</span> <span>gitVersion</span> <span>=</span> <span>jsonSlurper</span><span>.</span><span>parse</span><span>(</span><span>gitVersionFile</span><span>)</span> <span>as</span> <span>Map</span><span><</span><span>*</span><span>,</span> <span>*</span><span>></span>
        <span>project</span><span>.</span><span>version</span> <span>=</span> <span>gitVersion</span><span>[</span><span>"SemVer"</span><span>].</span><span>toString</span><span>()</span>
        <span>println</span><span>(</span><span>"---> Project version set to: ${project.version}"</span><span>)</span>
    <span>}</span>
<span>}</span>
<span>/* Configure the 'Jar' task to depend on the 'parseGitVersion' task. This ensures that every time the 'Jar' task runs, it first executes the 'parseGitVersion' task to determine the project version. Also assigns the title and version of the .jar file to the 'project.name' and 'project.version'. */</span>
<span>tasks</span><span>.</span><span>withType</span><span><</span><span>Jar</span><span>>().</span><span>configureEach</span> <span>{</span>
    <span>dependsOn</span><span>(</span><span>"parseGitVersion"</span><span>)</span>
    <span>from</span><span>(</span><span>sourceSets</span><span>[</span><span>"main"</span><span>].</span><span>output</span><span>)</span>
    <span>manifest</span> <span>{</span>
        <span>attributes</span><span>(</span>
            <span>"Implementation-Title"</span> <span>to</span> <span>project</span><span>.</span><span>name</span><span>,</span>
            <span>"Implementation-Version"</span> <span>to</span> <span>project</span><span>.</span><span>version</span>
        <span>)</span>
    <span>}</span>
<span>}</span>
<span>//---------------------------------------------------------------------------------------------------------------------</span>
<span>//Setting this version ensures that if any issues occur during versioning, it will use the default version.</span>
<span>version</span> <span>=</span> <span>"0.1.0-SNAPSHOT"</span>


<span>//----------------------------------- Semantic Versioning / Continues Integration -------------------------------------</span>
<span>val</span> <span>gitVersionJsonFilePath</span> <span>=</span> <span>"../gitversion.json"</span> <span>// make a const for the 'gitversion.json' file path.</span>

<span>// Register an executable task to generate the 'gitversion.json' file using the 'gitversion' CLI.</span>
<span>tasks</span><span>.</span><span>register</span><span><</span><span>Exec</span><span>>(</span><span>"gitVersionOutputJSon"</span><span>)</span> <span>{</span>
    <span>commandLine</span><span>(</span><span>"sh"</span><span>,</span> <span>"-c"</span><span>,</span> <span>"gitversion /output json > $gitVersionJsonFilePath"</span><span>)</span>
<span>}</span>

<span>/* Register a task that depends on 'gitVersionOutputJson' to run after it. This task will read the 'gitversion.json' file, extract the 'SemVer' key value, and assign it to the 'project.version'. */</span>
<span>tasks</span><span>.</span><span>register</span><span>(</span><span>"parseGitVersion"</span><span>)</span> <span>{</span>
    <span>dependsOn</span><span>(</span><span>"gitVersionOutputJSon"</span><span>)</span>
    <span>doLast</span> <span>{</span>
        <span>val</span> <span>jsonSlurper</span> <span>=</span> <span>JsonSlurper</span><span>()</span>
        <span>val</span> <span>gitVersionFile</span> <span>=</span> <span>file</span><span>(</span><span>gitVersionJsonFilePath</span><span>)</span>
        <span>val</span> <span>gitVersion</span> <span>=</span> <span>jsonSlurper</span><span>.</span><span>parse</span><span>(</span><span>gitVersionFile</span><span>)</span> <span>as</span> <span>Map</span><span><</span><span>*</span><span>,</span> <span>*</span><span>></span>
        <span>project</span><span>.</span><span>version</span> <span>=</span> <span>gitVersion</span><span>[</span><span>"SemVer"</span><span>].</span><span>toString</span><span>()</span>
        <span>println</span><span>(</span><span>"---> Project version set to: ${project.version}"</span><span>)</span>
    <span>}</span>
<span>}</span>

<span>/* Configure the 'Jar' task to depend on the 'parseGitVersion' task. This ensures that every time the 'Jar' task runs, it first executes the 'parseGitVersion' task to determine the project version. Also assigns the title and version of the .jar file to the 'project.name' and 'project.version'. */</span>
<span>tasks</span><span>.</span><span>withType</span><span><</span><span>Jar</span><span>>().</span><span>configureEach</span> <span>{</span>
    <span>dependsOn</span><span>(</span><span>"parseGitVersion"</span><span>)</span>
    <span>from</span><span>(</span><span>sourceSets</span><span>[</span><span>"main"</span><span>].</span><span>output</span><span>)</span>
    <span>manifest</span> <span>{</span>
        <span>attributes</span><span>(</span>
            <span>"Implementation-Title"</span> <span>to</span> <span>project</span><span>.</span><span>name</span><span>,</span>
            <span>"Implementation-Version"</span> <span>to</span> <span>project</span><span>.</span><span>version</span>
        <span>)</span>
    <span>}</span>
<span>}</span>
<span>//---------------------------------------------------------------------------------------------------------------------</span>
//Setting this version ensures that if any issues occur during versioning, it will use the default version.
version = "0.1.0-SNAPSHOT"


//----------------------------------- Semantic Versioning / Continues Integration -------------------------------------
val gitVersionJsonFilePath = "../gitversion.json" // make a const for the 'gitversion.json' file path.

// Register an executable task to generate the 'gitversion.json' file using the 'gitversion' CLI.
tasks.register<Exec>("gitVersionOutputJSon") {
    commandLine("sh", "-c", "gitversion /output json > $gitVersionJsonFilePath")
}

/* Register a task that depends on 'gitVersionOutputJson' to run after it. This task will read the 'gitversion.json' file, extract the 'SemVer' key value, and assign it to the 'project.version'. */
tasks.register("parseGitVersion") {
    dependsOn("gitVersionOutputJSon")
    doLast {
        val jsonSlurper = JsonSlurper()
        val gitVersionFile = file(gitVersionJsonFilePath)
        val gitVersion = jsonSlurper.parse(gitVersionFile) as Map<*, *>
        project.version = gitVersion["SemVer"].toString()
        println("---> Project version set to: ${project.version}")
    }
}

/* Configure the 'Jar' task to depend on the 'parseGitVersion' task. This ensures that every time the 'Jar' task runs, it first executes the 'parseGitVersion' task to determine the project version. Also assigns the title and version of the .jar file to the 'project.name' and 'project.version'. */
tasks.withType<Jar>().configureEach {
    dependsOn("parseGitVersion")
    from(sourceSets["main"].output)
    manifest {
        attributes(
            "Implementation-Title" to project.name,
            "Implementation-Version" to project.version
        )
    }
}
//---------------------------------------------------------------------------------------------------------------------

Enter fullscreen mode Exit fullscreen mode

Note: To ensure the gitVersionOutputJSon task is runnable, you need to install GitVersion CLI on your operating system and set it as an environment variable.

Install GitVersion CLI

There are several ways To installing GitVersion CLI:

  • The first approach is to use a third party installer like: dotnet tool install, brew install, choco install, or install it via docker like docker run. if you are interested in doing in this way please refer to Installation guide from gitversion.net and follow the steps.
  • However there is also a direct approach you can use:
    • First, download the latest GitVersion CLI from here based on your operating system. at the moment the latest version is 6.0.5
    • Second, extract the file into a directory and do not move the location ever.
    • Third, Make an environment variable for it: 
  <span>export </span><span>PATH</span><span>=</span><span>$PATH</span>:/home/sam/Public/gitversion-linux-x64-6.0.5
  <span>export </span><span>PATH</span><span>=</span><span>$PATH</span>:/home/sam/Public/gitversion-linux-x64-6.0.5
  export PATH=$PATH:/home/sam/Public/gitversion-linux-x64-6.0.5

Enter fullscreen mode Exit fullscreen mode

-Now, you can run GitVersion -version to verify and check your GitVersion CLI installation in terminal. you should see something like this: (if not, restart your pc to apply the changes)

This block of code should be placed between your { plugins, repositories, … } and { dependencies, …}.

finally you would have something like this: 

<span>import</span> <span>groovy.json.JsonSlurper</span>
<span>plugins</span> <span>{</span>
    <span>application</span>
<span>}</span>
<span>application</span> <span>{</span>
    <span>mainClass</span> <span>=</span> <span>"codelab.java.console.Main"</span>
    <span>applicationName</span> <span>=</span> <span>"codelab.java.console.app"</span>
<span>}</span>
<span>repositories</span> <span>{</span>
    <span>mavenCentral</span><span>()</span>
<span>}</span>
<span>group</span> <span>=</span> <span>"codelab.java"</span>
<span>//Setting this version ensures that if any issues occur during versioning, it will use the default version.</span>
<span>version</span> <span>=</span> <span>"0.1.0-SNAPSHOT"</span>
<span>//----------------------------------- Semantic Versioning / Continues Integration -------------------------------------</span>
<span>val</span> <span>gitVersionJsonFilePath</span> <span>=</span> <span>"../gitversion.json"</span> <span>// make a const for the 'gitversion.json' file path.</span>
<span>// Register an executable task to generate the 'gitversion.json' file using the 'gitversion' CLI.</span>
<span>tasks</span><span>.</span><span>register</span><span><</span><span>Exec</span><span>>(</span><span>"gitVersionOutputJSon"</span><span>)</span> <span>{</span>
    <span>commandLine</span><span>(</span><span>"sh"</span><span>,</span> <span>"-c"</span><span>,</span> <span>"gitversion /output json > $gitVersionJsonFilePath"</span><span>)</span>
<span>}</span>
<span>/* Register a task that depends on 'gitVersionOutputJson' to run after it. This task will read the 'gitversion.json' file, extract the 'SemVer' key value, and assign it to the 'project.version'. */</span>
<span>tasks</span><span>.</span><span>register</span><span>(</span><span>"parseGitVersion"</span><span>)</span> <span>{</span>
    <span>dependsOn</span><span>(</span><span>"gitVersionOutputJSon"</span><span>)</span>
    <span>doLast</span> <span>{</span>
        <span>val</span> <span>jsonSlurper</span> <span>=</span> <span>JsonSlurper</span><span>()</span>
        <span>val</span> <span>gitVersionFile</span> <span>=</span> <span>file</span><span>(</span><span>gitVersionJsonFilePath</span><span>)</span>
        <span>val</span> <span>gitVersion</span> <span>=</span> <span>jsonSlurper</span><span>.</span><span>parse</span><span>(</span><span>gitVersionFile</span><span>)</span> <span>as</span> <span>Map</span><span><</span><span>*</span><span>,</span> <span>*</span><span>></span>
        <span>project</span><span>.</span><span>version</span> <span>=</span> <span>gitVersion</span><span>[</span><span>"SemVer"</span><span>].</span><span>toString</span><span>()</span>
        <span>println</span><span>(</span><span>"---> Project version set to: ${project.version}"</span><span>)</span>
    <span>}</span>
<span>}</span>
<span>/* Configure the 'Jar' task to depend on the 'parseGitVersion' task. This ensures that every time the 'Jar' task runs, it first executes the 'parseGitVersion' task to determine the project version. Also assigns the title and version of the .jar file to the 'project.name' and 'project.version'. */</span>
<span>tasks</span><span>.</span><span>withType</span><span><</span><span>Jar</span><span>>().</span><span>configureEach</span> <span>{</span>
    <span>dependsOn</span><span>(</span><span>"parseGitVersion"</span><span>)</span>
    <span>from</span><span>(</span><span>sourceSets</span><span>[</span><span>"main"</span><span>].</span><span>output</span><span>)</span>
    <span>manifest</span> <span>{</span>
        <span>attributes</span><span>(</span>
            <span>"Implementation-Title"</span> <span>to</span> <span>project</span><span>.</span><span>name</span><span>,</span>
            <span>"Implementation-Version"</span> <span>to</span> <span>project</span><span>.</span><span>version</span>
        <span>)</span>
    <span>}</span>
<span>}</span>
<span>//---------------------------------------------------------------------------------------------------------------------</span>
<span>dependencies</span> <span>{</span>
    <span>testImplementation</span><span>(</span><span>platform</span><span>(</span><span>libs</span><span>.</span><span>junit</span><span>.</span><span>bom</span><span>))</span>
    <span>testImplementation</span><span>(</span><span>libs</span><span>.</span><span>junit</span><span>.</span><span>jupiter</span><span>)</span>
<span>}</span>
<span>tasks</span><span>.</span><span>test</span> <span>{</span>
    <span>useJUnitPlatform</span><span>()</span>
<span>}</span>
<span>tasks</span><span>.</span><span>jar</span> <span>{</span>
    <span>manifest</span> <span>{</span>
        <span>attributes</span><span>[</span><span>"Main-Class"</span><span>]</span> <span>=</span> <span>application</span><span>.</span><span>mainClass</span>
    <span>}</span>
<span>}</span>
<span>import</span> <span>groovy.json.JsonSlurper</span>

<span>plugins</span> <span>{</span>
    <span>application</span>
<span>}</span>

<span>application</span> <span>{</span>
    <span>mainClass</span> <span>=</span> <span>"codelab.java.console.Main"</span>
    <span>applicationName</span> <span>=</span> <span>"codelab.java.console.app"</span>
<span>}</span>

<span>repositories</span> <span>{</span>
    <span>mavenCentral</span><span>()</span>
<span>}</span>

<span>group</span> <span>=</span> <span>"codelab.java"</span>

<span>//Setting this version ensures that if any issues occur during versioning, it will use the default version.</span>
<span>version</span> <span>=</span> <span>"0.1.0-SNAPSHOT"</span>


<span>//----------------------------------- Semantic Versioning / Continues Integration -------------------------------------</span>
<span>val</span> <span>gitVersionJsonFilePath</span> <span>=</span> <span>"../gitversion.json"</span> <span>// make a const for the 'gitversion.json' file path.</span>

<span>// Register an executable task to generate the 'gitversion.json' file using the 'gitversion' CLI.</span>
<span>tasks</span><span>.</span><span>register</span><span><</span><span>Exec</span><span>>(</span><span>"gitVersionOutputJSon"</span><span>)</span> <span>{</span>
    <span>commandLine</span><span>(</span><span>"sh"</span><span>,</span> <span>"-c"</span><span>,</span> <span>"gitversion /output json > $gitVersionJsonFilePath"</span><span>)</span>
<span>}</span>

<span>/* Register a task that depends on 'gitVersionOutputJson' to run after it. This task will read the 'gitversion.json' file, extract the 'SemVer' key value, and assign it to the 'project.version'. */</span>
<span>tasks</span><span>.</span><span>register</span><span>(</span><span>"parseGitVersion"</span><span>)</span> <span>{</span>
    <span>dependsOn</span><span>(</span><span>"gitVersionOutputJSon"</span><span>)</span>
    <span>doLast</span> <span>{</span>
        <span>val</span> <span>jsonSlurper</span> <span>=</span> <span>JsonSlurper</span><span>()</span>
        <span>val</span> <span>gitVersionFile</span> <span>=</span> <span>file</span><span>(</span><span>gitVersionJsonFilePath</span><span>)</span>
        <span>val</span> <span>gitVersion</span> <span>=</span> <span>jsonSlurper</span><span>.</span><span>parse</span><span>(</span><span>gitVersionFile</span><span>)</span> <span>as</span> <span>Map</span><span><</span><span>*</span><span>,</span> <span>*</span><span>></span>
        <span>project</span><span>.</span><span>version</span> <span>=</span> <span>gitVersion</span><span>[</span><span>"SemVer"</span><span>].</span><span>toString</span><span>()</span>
        <span>println</span><span>(</span><span>"---> Project version set to: ${project.version}"</span><span>)</span>
    <span>}</span>
<span>}</span>

<span>/* Configure the 'Jar' task to depend on the 'parseGitVersion' task. This ensures that every time the 'Jar' task runs, it first executes the 'parseGitVersion' task to determine the project version. Also assigns the title and version of the .jar file to the 'project.name' and 'project.version'. */</span>
<span>tasks</span><span>.</span><span>withType</span><span><</span><span>Jar</span><span>>().</span><span>configureEach</span> <span>{</span>
    <span>dependsOn</span><span>(</span><span>"parseGitVersion"</span><span>)</span>
    <span>from</span><span>(</span><span>sourceSets</span><span>[</span><span>"main"</span><span>].</span><span>output</span><span>)</span>
    <span>manifest</span> <span>{</span>
        <span>attributes</span><span>(</span>
            <span>"Implementation-Title"</span> <span>to</span> <span>project</span><span>.</span><span>name</span><span>,</span>
            <span>"Implementation-Version"</span> <span>to</span> <span>project</span><span>.</span><span>version</span>
        <span>)</span>
    <span>}</span>
<span>}</span>
<span>//---------------------------------------------------------------------------------------------------------------------</span>

<span>dependencies</span> <span>{</span>
    <span>testImplementation</span><span>(</span><span>platform</span><span>(</span><span>libs</span><span>.</span><span>junit</span><span>.</span><span>bom</span><span>))</span>
    <span>testImplementation</span><span>(</span><span>libs</span><span>.</span><span>junit</span><span>.</span><span>jupiter</span><span>)</span>
<span>}</span>

<span>tasks</span><span>.</span><span>test</span> <span>{</span>
    <span>useJUnitPlatform</span><span>()</span>
<span>}</span>

<span>tasks</span><span>.</span><span>jar</span> <span>{</span>
    <span>manifest</span> <span>{</span>
        <span>attributes</span><span>[</span><span>"Main-Class"</span><span>]</span> <span>=</span> <span>application</span><span>.</span><span>mainClass</span>
    <span>}</span>
<span>}</span>
import groovy.json.JsonSlurper

plugins {
    application
}

application {
    mainClass = "codelab.java.console.Main"
    applicationName = "codelab.java.console.app"
}

repositories {
    mavenCentral()
}

group = "codelab.java"

//Setting this version ensures that if any issues occur during versioning, it will use the default version.
version = "0.1.0-SNAPSHOT"


//----------------------------------- Semantic Versioning / Continues Integration -------------------------------------
val gitVersionJsonFilePath = "../gitversion.json" // make a const for the 'gitversion.json' file path.

// Register an executable task to generate the 'gitversion.json' file using the 'gitversion' CLI.
tasks.register<Exec>("gitVersionOutputJSon") {
    commandLine("sh", "-c", "gitversion /output json > $gitVersionJsonFilePath")
}

/* Register a task that depends on 'gitVersionOutputJson' to run after it. This task will read the 'gitversion.json' file, extract the 'SemVer' key value, and assign it to the 'project.version'. */
tasks.register("parseGitVersion") {
    dependsOn("gitVersionOutputJSon")
    doLast {
        val jsonSlurper = JsonSlurper()
        val gitVersionFile = file(gitVersionJsonFilePath)
        val gitVersion = jsonSlurper.parse(gitVersionFile) as Map<*, *>
        project.version = gitVersion["SemVer"].toString()
        println("---> Project version set to: ${project.version}")
    }
}

/* Configure the 'Jar' task to depend on the 'parseGitVersion' task. This ensures that every time the 'Jar' task runs, it first executes the 'parseGitVersion' task to determine the project version. Also assigns the title and version of the .jar file to the 'project.name' and 'project.version'. */
tasks.withType<Jar>().configureEach {
    dependsOn("parseGitVersion")
    from(sourceSets["main"].output)
    manifest {
        attributes(
            "Implementation-Title" to project.name,
            "Implementation-Version" to project.version
        )
    }
}
//---------------------------------------------------------------------------------------------------------------------

dependencies {
    testImplementation(platform(libs.junit.bom))
    testImplementation(libs.junit.jupiter)
}

tasks.test {
    useJUnitPlatform()
}

tasks.jar {
    manifest {
        attributes["Main-Class"] = application.mainClass
    }
}

Enter fullscreen mode Exit fullscreen mode

The Semantic Versioning block generates the gitversion.json file in the root path of your project:

图片[1]-Semantic Versioning using GitVersion YAML file for your .NET, Java, and Kotlin projects' CI/CD - 拾光赋-拾光赋

If you look at the file, you should have something like this: 

<span>{</span><span> </span><span>"AssemblySemFileVer"</span><span>:</span><span> </span><span>"0.1.0.1"</span><span>,</span><span> </span><span>"AssemblySemVer"</span><span>:</span><span> </span><span>"0.1.0.1"</span><span>,</span><span> </span><span>"BranchName"</span><span>:</span><span> </span><span>"feature/setup"</span><span>,</span><span> </span><span>"BuildMetaData"</span><span>:</span><span> </span><span>5</span><span>,</span><span> </span><span>"CommitDate"</span><span>:</span><span> </span><span>"2024-12-05"</span><span>,</span><span> </span><span>"CommitsSinceVersionSource"</span><span>:</span><span> </span><span>5</span><span>,</span><span> </span><span>"EscapedBranchName"</span><span>:</span><span> </span><span>"feature-setup"</span><span>,</span><span> </span><span>"FullBuildMetaData"</span><span>:</span><span> </span><span>"5.Branch.feature-setup.Sha.f2526f6ec73f6753bc39a17edd186c3114f34872"</span><span>,</span><span> </span><span>"FullSemVer"</span><span>:</span><span> </span><span>"0.1.0-setup.1+5"</span><span>,</span><span> </span><span>"InformationalVersion"</span><span>:</span><span> </span><span>"0.1.0-setup.1+5"</span><span>,</span><span> </span><span>"Major"</span><span>:</span><span> </span><span>0</span><span>,</span><span> </span><span>"MajorMinorPatch"</span><span>:</span><span> </span><span>"0.1.0"</span><span>,</span><span> </span><span>"Minor"</span><span>:</span><span> </span><span>1</span><span>,</span><span> </span><span>"Patch"</span><span>:</span><span> </span><span>0</span><span>,</span><span> </span><span>"PreReleaseLabel"</span><span>:</span><span> </span><span>"setup"</span><span>,</span><span> </span><span>"PreReleaseLabelWithDash"</span><span>:</span><span> </span><span>"-setup"</span><span>,</span><span> </span><span>"PreReleaseNumber"</span><span>:</span><span> </span><span>1</span><span>,</span><span> </span><span>"PreReleaseTag"</span><span>:</span><span> </span><span>"setup.1"</span><span>,</span><span> </span><span>"PreReleaseTagWithDash"</span><span>:</span><span> </span><span>"-setup.1"</span><span>,</span><span> </span><span>"SemVer"</span><span>:</span><span> </span><span>"0.1.0-setup.1"</span><span>,</span><span> </span><span>"Sha"</span><span>:</span><span> </span><span>"f2526f6ec73f6753bc39a17edd186c3114f34872"</span><span>,</span><span> </span><span>"ShortSha"</span><span>:</span><span> </span><span>"f2526f6"</span><span>,</span><span> </span><span>"UncommittedChanges"</span><span>:</span><span> </span><span>3</span><span>,</span><span> </span><span>"VersionSourceSha"</span><span>:</span><span> </span><span>""</span><span>,</span><span> </span><span>"WeightedPreReleaseNumber"</span><span>:</span><span> </span><span>30001</span><span> </span><span>}</span><span> </span>
<span>{</span><span> </span><span>"AssemblySemFileVer"</span><span>:</span><span> </span><span>"0.1.0.1"</span><span>,</span><span> </span><span>"AssemblySemVer"</span><span>:</span><span> </span><span>"0.1.0.1"</span><span>,</span><span> </span><span>"BranchName"</span><span>:</span><span> </span><span>"feature/setup"</span><span>,</span><span> </span><span>"BuildMetaData"</span><span>:</span><span> </span><span>5</span><span>,</span><span> </span><span>"CommitDate"</span><span>:</span><span> </span><span>"2024-12-05"</span><span>,</span><span> </span><span>"CommitsSinceVersionSource"</span><span>:</span><span> </span><span>5</span><span>,</span><span> </span><span>"EscapedBranchName"</span><span>:</span><span> </span><span>"feature-setup"</span><span>,</span><span> </span><span>"FullBuildMetaData"</span><span>:</span><span> </span><span>"5.Branch.feature-setup.Sha.f2526f6ec73f6753bc39a17edd186c3114f34872"</span><span>,</span><span> </span><span>"FullSemVer"</span><span>:</span><span> </span><span>"0.1.0-setup.1+5"</span><span>,</span><span> </span><span>"InformationalVersion"</span><span>:</span><span> </span><span>"0.1.0-setup.1+5"</span><span>,</span><span> </span><span>"Major"</span><span>:</span><span> </span><span>0</span><span>,</span><span> </span><span>"MajorMinorPatch"</span><span>:</span><span> </span><span>"0.1.0"</span><span>,</span><span> </span><span>"Minor"</span><span>:</span><span> </span><span>1</span><span>,</span><span> </span><span>"Patch"</span><span>:</span><span> </span><span>0</span><span>,</span><span> </span><span>"PreReleaseLabel"</span><span>:</span><span> </span><span>"setup"</span><span>,</span><span> </span><span>"PreReleaseLabelWithDash"</span><span>:</span><span> </span><span>"-setup"</span><span>,</span><span> </span><span>"PreReleaseNumber"</span><span>:</span><span> </span><span>1</span><span>,</span><span> </span><span>"PreReleaseTag"</span><span>:</span><span> </span><span>"setup.1"</span><span>,</span><span> </span><span>"PreReleaseTagWithDash"</span><span>:</span><span> </span><span>"-setup.1"</span><span>,</span><span> </span><span>"SemVer"</span><span>:</span><span> </span><span>"0.1.0-setup.1"</span><span>,</span><span> </span><span>"Sha"</span><span>:</span><span> </span><span>"f2526f6ec73f6753bc39a17edd186c3114f34872"</span><span>,</span><span> </span><span>"ShortSha"</span><span>:</span><span> </span><span>"f2526f6"</span><span>,</span><span> </span><span>"UncommittedChanges"</span><span>:</span><span> </span><span>3</span><span>,</span><span> </span><span>"VersionSourceSha"</span><span>:</span><span> </span><span>""</span><span>,</span><span> </span><span>"WeightedPreReleaseNumber"</span><span>:</span><span> </span><span>30001</span><span> </span><span>}</span><span> </span>
{ "AssemblySemFileVer": "0.1.0.1", "AssemblySemVer": "0.1.0.1", "BranchName": "feature/setup", "BuildMetaData": 5, "CommitDate": "2024-12-05", "CommitsSinceVersionSource": 5, "EscapedBranchName": "feature-setup", "FullBuildMetaData": "5.Branch.feature-setup.Sha.f2526f6ec73f6753bc39a17edd186c3114f34872", "FullSemVer": "0.1.0-setup.1+5", "InformationalVersion": "0.1.0-setup.1+5", "Major": 0, "MajorMinorPatch": "0.1.0", "Minor": 1, "Patch": 0, "PreReleaseLabel": "setup", "PreReleaseLabelWithDash": "-setup", "PreReleaseNumber": 1, "PreReleaseTag": "setup.1", "PreReleaseTagWithDash": "-setup.1", "SemVer": "0.1.0-setup.1", "Sha": "f2526f6ec73f6753bc39a17edd186c3114f34872", "ShortSha": "f2526f6", "UncommittedChanges": 3, "VersionSourceSha": "", "WeightedPreReleaseNumber": 30001 }

Enter fullscreen mode Exit fullscreen mode

Let’s take a look at what happens when you run the build task:

  • gitVersionOutputJSon task tries to make the gitversion.json file based on your project changes..
  • parseGitVersion task tries to parse the generated JSON file and take the ‘SemVer’ and assign it to the project.version
  • Now gradle uses this property to generate the jar file.

Preparing the build in .NET

  1. Add GitVersion.MsBuild NuGet package to every single project in the solution:

Congrats! you finish the local project side.

Let’s explore the build server setup on GitHub to ensure the CI process runs smoothly 

<span>name</span><span>:</span> <span>Java Kotlin Build and Test With Gradle</span>
<span>on</span><span>:</span> <span>[</span><span>push</span><span>,</span> <span>pull_request</span><span>,</span> <span>workflow_dispatch</span><span>]</span>
<span>jobs</span><span>:</span>
  <span>build</span><span>:</span>
    <span>runs-on</span><span>:</span> <span>ubuntu-latest</span>
    <span>permissions</span><span>:</span>
      <span>contents</span><span>:</span> <span>read</span>
    <span>steps</span><span>:</span>
      <span>-</span> <span>name</span><span>:</span> <span>Checkout</span>
        <span>uses</span><span>:</span> <span>actions/checkout@v4.2.2</span>
        <span>with</span><span>:</span>
          <span>fetch-depth</span><span>:</span> <span>0</span>
      <span>-</span> <span>name</span><span>:</span> <span>Set up JDK </span><span>23</span>
        <span>uses</span><span>:</span> <span>actions/setup-java@v4.5.0</span> <span>#https://github.com/actions/setup-java</span>
        <span>with</span><span>:</span>
          <span>java-version</span><span>:</span> <span>'</span><span>23'</span>
          <span>distribution</span><span>:</span> <span>'</span><span>oracle'</span>
      <span>-</span> <span>name</span><span>:</span> <span>Install GitVersion 6.0.5 for Gradle</span>
        <span>run</span><span>:</span> <span>|</span>
          <span>wget -q -O gitversion.tar.gz https://github.com/GitTools/GitVersion/releases/download/6.0.5/gitversion-linux-x64-6.0.5.tar.gz</span>
          <span>mkdir gitversion_extracted</span>
          <span>tar -xzf gitversion.tar.gz -C gitversion_extracted</span>
          <span>ls -R gitversion_extracted</span>
          <span>sudo mv gitversion_extracted/gitversion /usr/local/bin/gitversion</span>
          <span>sudo chmod +x /usr/local/bin/gitversion</span>
      <span>-</span> <span>name</span><span>:</span> <span>Setup Gradle 8.11.1</span>
        <span>uses</span><span>:</span> <span>gradle/actions/setup-gradle@v4</span> <span>#https://github.com/gradle/actions/blob/main/docs/setup-gradle.md#build-with-a-specific-gradle-version</span>
        <span>with</span><span>:</span>
          <span>gradle-version</span><span>:</span> <span>'</span><span>8.11.1'</span>
      <span>-</span> <span>name</span><span>:</span> <span>Build with Gradle 8.11.1</span>
        <span>run</span><span>:</span> <span>gradle build --scan --warning-mode all</span>
  <span>dependency-submission</span><span>:</span> <span># See: https://github.com/gradle/actions/blob/main/dependency-submission/README.md</span>
    <span>runs-on</span><span>:</span> <span>ubuntu-latest</span>
    <span>permissions</span><span>:</span>
      <span>contents</span><span>:</span> <span>write</span>
    <span>steps</span><span>:</span>
      <span>-</span> <span>name</span><span>:</span> <span>Checkout</span>
        <span>uses</span><span>:</span> <span>actions/checkout@v4.2.2</span>
      <span>-</span> <span>name</span><span>:</span> <span>Set up JDK </span><span>23</span>
        <span>uses</span><span>:</span> <span>actions/setup-java@v4.5.0</span>
        <span>with</span><span>:</span>
          <span>java-version</span><span>:</span> <span>'</span><span>23'</span>
          <span>distribution</span><span>:</span> <span>'</span><span>oracle'</span>
      <span>-</span> <span>name</span><span>:</span> <span>Setup Gradle 8.11.1</span>
        <span>uses</span><span>:</span> <span>gradle/actions/setup-gradle@v4</span>
        <span>with</span><span>:</span>
          <span>gradle-version</span><span>:</span> <span>'</span><span>8.11.1'</span>
      <span>-</span> <span>name</span><span>:</span> <span>Setup Gradle Wrapper</span>
        <span>run</span><span>:</span> <span>gradle wrapper</span>
      <span>-</span> <span>name</span><span>:</span> <span>Generate and submit dependency graph</span>
        <span>uses</span><span>:</span> <span>gradle/actions/dependency-submission@v4</span>
<span>name</span><span>:</span> <span>Java Kotlin Build and Test With Gradle</span>

<span>on</span><span>:</span> <span>[</span><span>push</span><span>,</span> <span>pull_request</span><span>,</span> <span>workflow_dispatch</span><span>]</span>

<span>jobs</span><span>:</span>
  <span>build</span><span>:</span>
    <span>runs-on</span><span>:</span> <span>ubuntu-latest</span>
    <span>permissions</span><span>:</span>
      <span>contents</span><span>:</span> <span>read</span>

    <span>steps</span><span>:</span>
      <span>-</span> <span>name</span><span>:</span> <span>Checkout</span>
        <span>uses</span><span>:</span> <span>actions/checkout@v4.2.2</span>
        <span>with</span><span>:</span>
          <span>fetch-depth</span><span>:</span> <span>0</span>

      <span>-</span> <span>name</span><span>:</span> <span>Set up JDK </span><span>23</span>
        <span>uses</span><span>:</span> <span>actions/setup-java@v4.5.0</span> <span>#https://github.com/actions/setup-java</span>
        <span>with</span><span>:</span>
          <span>java-version</span><span>:</span> <span>'</span><span>23'</span>
          <span>distribution</span><span>:</span> <span>'</span><span>oracle'</span>

      <span>-</span> <span>name</span><span>:</span> <span>Install GitVersion 6.0.5 for Gradle</span>
        <span>run</span><span>:</span> <span>|</span>
          <span>wget -q -O gitversion.tar.gz https://github.com/GitTools/GitVersion/releases/download/6.0.5/gitversion-linux-x64-6.0.5.tar.gz</span>
          <span>mkdir gitversion_extracted</span>
          <span>tar -xzf gitversion.tar.gz -C gitversion_extracted</span>
          <span>ls -R gitversion_extracted</span>
          <span>sudo mv gitversion_extracted/gitversion /usr/local/bin/gitversion</span>
          <span>sudo chmod +x /usr/local/bin/gitversion</span>
      <span>-</span> <span>name</span><span>:</span> <span>Setup Gradle 8.11.1</span>
        <span>uses</span><span>:</span> <span>gradle/actions/setup-gradle@v4</span> <span>#https://github.com/gradle/actions/blob/main/docs/setup-gradle.md#build-with-a-specific-gradle-version</span>
        <span>with</span><span>:</span>
          <span>gradle-version</span><span>:</span> <span>'</span><span>8.11.1'</span>

      <span>-</span> <span>name</span><span>:</span> <span>Build with Gradle 8.11.1</span>
        <span>run</span><span>:</span> <span>gradle build --scan --warning-mode all</span>

  <span>dependency-submission</span><span>:</span> <span># See: https://github.com/gradle/actions/blob/main/dependency-submission/README.md</span>

    <span>runs-on</span><span>:</span> <span>ubuntu-latest</span>

    <span>permissions</span><span>:</span>
      <span>contents</span><span>:</span> <span>write</span>

    <span>steps</span><span>:</span>
      <span>-</span> <span>name</span><span>:</span> <span>Checkout</span>
        <span>uses</span><span>:</span> <span>actions/checkout@v4.2.2</span>

      <span>-</span> <span>name</span><span>:</span> <span>Set up JDK </span><span>23</span>
        <span>uses</span><span>:</span> <span>actions/setup-java@v4.5.0</span>
        <span>with</span><span>:</span>
          <span>java-version</span><span>:</span> <span>'</span><span>23'</span>
          <span>distribution</span><span>:</span> <span>'</span><span>oracle'</span>

      <span>-</span> <span>name</span><span>:</span> <span>Setup Gradle 8.11.1</span>
        <span>uses</span><span>:</span> <span>gradle/actions/setup-gradle@v4</span>
        <span>with</span><span>:</span>
          <span>gradle-version</span><span>:</span> <span>'</span><span>8.11.1'</span>

      <span>-</span> <span>name</span><span>:</span> <span>Setup Gradle Wrapper</span>
        <span>run</span><span>:</span> <span>gradle wrapper</span>

      <span>-</span> <span>name</span><span>:</span> <span>Generate and submit dependency graph</span>
        <span>uses</span><span>:</span> <span>gradle/actions/dependency-submission@v4</span>
name: Java Kotlin Build and Test With Gradle

on: [push, pull_request, workflow_dispatch]

jobs:
  build:
    runs-on: ubuntu-latest
    permissions:
      contents: read

    steps:
      - name: Checkout
        uses: actions/checkout@v4.2.2
        with:
          fetch-depth: 0

      - name: Set up JDK 23
        uses: actions/setup-java@v4.5.0 #https://github.com/actions/setup-java
        with:
          java-version: '23'
          distribution: 'oracle'

      - name: Install GitVersion 6.0.5 for Gradle
        run: |
          wget -q -O gitversion.tar.gz https://github.com/GitTools/GitVersion/releases/download/6.0.5/gitversion-linux-x64-6.0.5.tar.gz
          mkdir gitversion_extracted
          tar -xzf gitversion.tar.gz -C gitversion_extracted
          ls -R gitversion_extracted
          sudo mv gitversion_extracted/gitversion /usr/local/bin/gitversion
          sudo chmod +x /usr/local/bin/gitversion
      - name: Setup Gradle 8.11.1
        uses: gradle/actions/setup-gradle@v4 #https://github.com/gradle/actions/blob/main/docs/setup-gradle.md#build-with-a-specific-gradle-version
        with:
          gradle-version: '8.11.1'

      - name: Build with Gradle 8.11.1
        run: gradle build --scan --warning-mode all

  dependency-submission: # See: https://github.com/gradle/actions/blob/main/dependency-submission/README.md

    runs-on: ubuntu-latest

    permissions:
      contents: write

    steps:
      - name: Checkout
        uses: actions/checkout@v4.2.2

      - name: Set up JDK 23
        uses: actions/setup-java@v4.5.0
        with:
          java-version: '23'
          distribution: 'oracle'

      - name: Setup Gradle 8.11.1
        uses: gradle/actions/setup-gradle@v4
        with:
          gradle-version: '8.11.1'

      - name: Setup Gradle Wrapper
        run: gradle wrapper

      - name: Generate and submit dependency graph
        uses: gradle/actions/dependency-submission@v4

Enter fullscreen mode Exit fullscreen mode 

<span>name</span><span>:</span> <span>.NET Build and Test</span>
<span>on</span><span>:</span> <span>[</span><span>push</span><span>,</span> <span>pull_request</span><span>,</span> <span>workflow_dispatch</span><span>]</span>
<span>jobs</span><span>:</span>
  <span>build_and_Test</span><span>:</span>
    <span>runs-on</span><span>:</span> <span>ubuntu-latest</span>
    <span>steps</span><span>:</span>
      <span>-</span> <span>name</span><span>:</span> <span>Checkout</span> <span>#https://github.com/GitTools/actions/blob/main/docs/examples/github/gitversion/setup.md</span>
        <span>uses</span><span>:</span> <span>actions/checkout@v4.2.2</span>
        <span>with</span><span>:</span>
          <span>fetch-depth</span><span>:</span> <span>0</span>
      <span>-</span> <span>name</span><span>:</span> <span>Install GitVersion 6.x</span> <span>#https://github.com/GitTools/actions/blob/main/docs/examples/github/gitversion/setup.md</span>
        <span>uses</span><span>:</span> <span>gittools/actions/gitversion/setup@v3.0.4</span>
        <span>with</span><span>:</span>
          <span>versionSpec</span><span>:</span> <span>'</span><span>6.0.x'</span>
          <span>preferLatestVersion</span><span>:</span> <span>true</span>
      <span>-</span> <span>name</span><span>:</span> <span>Determine Version</span> <span>#https://github.com/GitTools/actions/blob/main/docs/examples/github/gitversion/execute.md</span>
        <span>uses</span><span>:</span> <span>gittools/actions/gitversion/execute@v3.0.4</span>
        <span>with</span><span>:</span>
          <span>useConfigFile</span><span>:</span> <span>true</span>
          <span>updateAssemblyInfo</span><span>:</span> <span>true</span>
      <span>-</span> <span>name</span><span>:</span> <span>Setup .NET </span><span>9</span> <span>#https://github.com/actions/setup-dotnet</span>
        <span>uses</span><span>:</span> <span>actions/setup-dotnet@v4.1.0</span>
        <span>with</span><span>:</span> 
          <span>dotnet-version</span><span>:</span> <span>'</span><span>9.0.x'</span>
      <span>-</span> <span>name</span><span>:</span> <span>Available projects</span>
        <span>run</span><span>:</span> <span>dotnet sln list</span>
      <span>-</span> <span>name</span><span>:</span> <span>Restore dependencies</span>
        <span>run</span><span>:</span> <span>dotnet restore</span>
      <span>-</span> <span>name</span><span>:</span> <span>Build</span>
        <span>run</span><span>:</span> <span>dotnet build --no-restore</span>
      <span>-</span> <span>name</span><span>:</span> <span>Test</span>
        <span>run</span><span>:</span> <span>dotnet test --no-build --verbosity normal</span>
<span>name</span><span>:</span> <span>.NET Build and Test</span>

<span>on</span><span>:</span> <span>[</span><span>push</span><span>,</span> <span>pull_request</span><span>,</span> <span>workflow_dispatch</span><span>]</span>

<span>jobs</span><span>:</span>
  <span>build_and_Test</span><span>:</span>
    <span>runs-on</span><span>:</span> <span>ubuntu-latest</span>

    <span>steps</span><span>:</span>
      <span>-</span> <span>name</span><span>:</span> <span>Checkout</span> <span>#https://github.com/GitTools/actions/blob/main/docs/examples/github/gitversion/setup.md</span>
        <span>uses</span><span>:</span> <span>actions/checkout@v4.2.2</span>
        <span>with</span><span>:</span>
          <span>fetch-depth</span><span>:</span> <span>0</span>

      <span>-</span> <span>name</span><span>:</span> <span>Install GitVersion 6.x</span> <span>#https://github.com/GitTools/actions/blob/main/docs/examples/github/gitversion/setup.md</span>
        <span>uses</span><span>:</span> <span>gittools/actions/gitversion/setup@v3.0.4</span>
        <span>with</span><span>:</span>
          <span>versionSpec</span><span>:</span> <span>'</span><span>6.0.x'</span>
          <span>preferLatestVersion</span><span>:</span> <span>true</span>

      <span>-</span> <span>name</span><span>:</span> <span>Determine Version</span> <span>#https://github.com/GitTools/actions/blob/main/docs/examples/github/gitversion/execute.md</span>
        <span>uses</span><span>:</span> <span>gittools/actions/gitversion/execute@v3.0.4</span>
        <span>with</span><span>:</span>
          <span>useConfigFile</span><span>:</span> <span>true</span>
          <span>updateAssemblyInfo</span><span>:</span> <span>true</span>

      <span>-</span> <span>name</span><span>:</span> <span>Setup .NET </span><span>9</span> <span>#https://github.com/actions/setup-dotnet</span>
        <span>uses</span><span>:</span> <span>actions/setup-dotnet@v4.1.0</span>
        <span>with</span><span>:</span> 
          <span>dotnet-version</span><span>:</span> <span>'</span><span>9.0.x'</span>

      <span>-</span> <span>name</span><span>:</span> <span>Available projects</span>
        <span>run</span><span>:</span> <span>dotnet sln list</span>

      <span>-</span> <span>name</span><span>:</span> <span>Restore dependencies</span>
        <span>run</span><span>:</span> <span>dotnet restore</span>

      <span>-</span> <span>name</span><span>:</span> <span>Build</span>
        <span>run</span><span>:</span> <span>dotnet build --no-restore</span>

      <span>-</span> <span>name</span><span>:</span> <span>Test</span>
        <span>run</span><span>:</span> <span>dotnet test --no-build --verbosity normal</span>
name: .NET Build and Test

on: [push, pull_request, workflow_dispatch]

jobs:
  build_and_Test:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout #https://github.com/GitTools/actions/blob/main/docs/examples/github/gitversion/setup.md
        uses: actions/checkout@v4.2.2
        with:
          fetch-depth: 0

      - name: Install GitVersion 6.x #https://github.com/GitTools/actions/blob/main/docs/examples/github/gitversion/setup.md
        uses: gittools/actions/gitversion/setup@v3.0.4
        with:
          versionSpec: '6.0.x'
          preferLatestVersion: true

      - name: Determine Version #https://github.com/GitTools/actions/blob/main/docs/examples/github/gitversion/execute.md
        uses: gittools/actions/gitversion/execute@v3.0.4
        with:
          useConfigFile: true
          updateAssemblyInfo: true

      - name: Setup .NET 9 #https://github.com/actions/setup-dotnet
        uses: actions/setup-dotnet@v4.1.0
        with: 
          dotnet-version: '9.0.x'

      - name: Available projects
        run: dotnet sln list

      - name: Restore dependencies
        run: dotnet restore

      - name: Build
        run: dotnet build --no-restore

      - name: Test
        run: dotnet test --no-build --verbosity normal

Enter fullscreen mode Exit fullscreen mode

原文链接：Semantic Versioning using GitVersion YAML file for your .NET, Java, and Kotlin projects’ CI/CD

展开阅读全文
© 版权声明
文章版权声明 1、本网站名称：拾光赋
2、本站永久网址：https://www.blogs.ink
3、本网站的文章部分内容可能来源于网络，仅供大家学习与参考，如有侵权，请联系站长QQ：805375623进行删除处理。
4、本站一切资源不代表本站立场，并不代表本站赞同其观点和对其真实性负责。
5、本站一律禁止以任何方式发布或转载任何违法的相关信息，访客发现请向站长举报
6、本站资源大多存储在云盘，如发现链接失效，请联系我们我们会第一时间更新。

THE END
Java（EN）
# java# dotnet# gitversion# semanticversioning
喜欢就支持一下吧
点赞7 分享
Only they who fulfill their duties in everyday matters will fulfill them on great occasions.
只有在日常生活中尽责的人才会在重大时刻尽责
kity的头像-拾光赋
相关推荐
评论 抢沙发

请登录后发表评论

    暂无评论内容

文章目录
kity的头像-拾光赋
文章目录
今日剩余 65.5%
本周剩余 66.5%
本月剩余 18.2%
本年剩余 76.9%
最近评论
Vito的头像-拾光赋

Vito5个月前2

你就是我心中的那首忐忑，总是让我惊心动魄
Jason.Meng的头像-拾光赋钻石会员

Jason.Meng徽章-人气大使-拾光赋5个月前2

总是会在人生的不同阶段反复爱上大佬的文章~
每日一言
Death comes to all, but great achievements raise a monument which shall endure until the sun grows old.
死亡无人能免，但非凡的成就会树起一座纪念碑，它将一直立到太阳冷却之时