• 设为首页
  • 点击收藏
  • 手机版
    手机扫一扫访问
    迪恩网络手机版
  • 关注官方公众号
    微信扫一扫关注
    迪恩网络公众号

passsy/gradle-gitVersioner-plugin: Extracts a useful versionCode and versionName ...

原作者: [db:作者] 来自: 网络 收藏 邀请

开源软件名称(OpenSource Name):

passsy/gradle-gitVersioner-plugin

开源软件地址(OpenSource Url):

https://github.com/passsy/gradle-gitVersioner-plugin

开源编程语言(OpenSource Language):

Kotlin 100.0%

开源软件介绍(OpenSource Introduction):

Git Versioner for gradle

Version numbers are hard. It was easier with SVN where the revision number got increased for every commit. Revision 342 was clearly older than revision 401. This is not possible in git because branching is so common (and that's a good thing). 342 commits could mean multiple commits on different branches. Not even the latest common commit in history is clear. This projects aims to bring the SVN simplicity and more back to git for your gradle (android) project.

Example

On master branch with 1850 commits and roughly half a year of development (526 timecomponent)

versionName 2376
versionCode 2376

On your feature branch feature/upgrade_gradle_4.4.1 with 3 additional commits/ versionCode stays the same and only reflects the base version on the baseBranch (master).

versionName 2376-upgrade_gradle_4.4.1+3
versionCode 2376

While working on your features when you have uncommitted changes files changed: 1, additions(+): 2, deletions(-): 0.

versionName 2376-upgrade_gradle_4.4.1+3-SNAPSHOT(1 +2 -0)
versionCode 2376

Install

// Top-level build.gradle
buildscript {
    dependencies {
        classpath 'com.pascalwelsch.gitversioner:gitversioner:0.4.1'
    }
}

// https://github.com/passsy/gradle-gitVersioner-plugin
apply plugin: 'com.pascalwelsch.gitversioner'
gitVersioner {
    baseBranch 'develop'
}

Usage Android

// app module build.gradle

android {

    defaultConfig {
        versionCode gitVersioner.versionCode
        versionName gitVersioner.versionName
    }
}

Additional gitVersioner properties

Here are the default properties, you can change them. See here for more details

gitVersioner {
    baseBranch 'master'
    yearFactor 1000 // increasing every 8.57h
    
    // Default formatter properties
    addSnapshot true // the "-SNAPSHOT" postfix
    addLocalChangesDetails true
    
    // provide a custom formatter
    formatter = { gitVersioner ->
        return "${gitVersioner.versionCode} custom generated id"
    }
}

Gradle Tasks

Show version output info

> ./gradlew gitVersion

GitVersioner Plugin
-------------------
VersionCode: 2118
VersionName: 2118-SNAPSHOT(1 +9 -8)

baseBranch: develop
current branch: develop
current commit: 1dd547a

baseBranch commits: 1653 (423e113..1dd547a)
featureBranch commits: 0 (1dd547a..1dd547a)

timeComponent: 465 (yearFactor:1000)

LocalChanges: files changed: 1, additions(+): 9, deletions(-): 8

write gitVersion information properties file (machine readable)

> ./gradlew generateGitVersionName
git versionName: 2118-SNAPSHOT(1 +9 -8)
gitVersion output: build/gitversion/gitversion.properties

gitversion.properties

#gitVersioner plugin - extracted data from git repository
#Sun Jan 14 22:08:34 CET 2018
localChanges=1 +9 -8
timeComponent=465
versionName=2118-SNAPSHOT(1 +9 -8)
versionCode=2118
featureBranchCommitCount=0
baseBranchCommitCount=1653
baseBranch=develop
branchName=develop
yearFactor=1000
currentSha1=1dd547a910b1a1da64fd65ec4b4294030511be4b

License

Copyright 2017 Pascal Welsch

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.



鲜花

握手

雷人

路过

鸡蛋
该文章已有0人参与评论

请发表评论

全部评论

专题导读
上一篇:
opendistro-for-elasticsearch/alerting: 发布时间:2022-06-14
下一篇:
PaperMC/paperweight: Gradle build system plugin for Paper and Paper forks发布时间:2022-06-14
热门推荐
阅读排行榜

扫描微信二维码

查看手机版网站

随时了解更新最新资讯

139-2527-9053

在线客服(服务时间 9:00~18:00)

在线QQ客服
地址:深圳市南山区西丽大学城创智工业园
电邮:jeky_zhao#qq.com
移动电话:139-2527-9053

Powered by 互联科技 X3.4© 2001-2213 极客世界.|Sitemap