版本化我自己的Android库

我目前正在为 Android开发自定义库.

我的想法是为应用程序创建一个版本(我目前在de build.gradle文件中设置它并且工作正常),以及该库的不同版本.

如果没有将两个build.gradle文件合并在一起,是否有最佳实践?

我在SO上发现了几个类似的问题,但他们已经4岁了,并没有多大帮助.

解决方法

解决方案不是Git,因为你可能已经想到了. OP希望对库进行外部版本,可能是在不提供源代码的情况下向第三方提供API的方法.

这对Gradle来说并不是微不足道的,但它是可行的.

你可以在不同的层面上做到这一点,我将解释最容易和最直接的.

设置版本号

首先,您需要将一个版本变量添加到gradle.properties文件中.您可以使用简单的单行设置此变量:

版本0.1.0 =-SNAPSHOT

构建版本字符串

在你的项目中创建一个名为versioning.gradle的文件并将以下代码粘贴到内部(我很久以前在网上找到了这个,我没有源代码):

ext {
    /**
  * Builds an Android version code from the version of the project.
  * This is designed to handle the -SNAPSHOT and -RC format.
  *
  * I.e. during development the version ends with -SNAPSHOT. As the code stabilizes and release nears
  * one or many Release Candidates are tagged. These all end with "-RC1","-RC2" etc.
  * And the final release is without any suffix.
  * @return
  */
    buildVersionCode = {
        //The rules is as follows:
        //-SNAPSHOT counts as 0
        //-RC* counts as the RC number,i.e. 1 to 98
        //final release counts as 99.
        //Thus you can only have 98 Release Candidates,which ought to be enough for everyone

        def candidate = "99"
        def (major,minor,patch) = version.toLowerCase().replaceAll('-','').tokenize('.')
        if (patch.endsWith("snapshot")) {
            candidate = "0"
            patch = patch.replaceAll("[^0-9]","")
        } else {
            def rc
            (patch,rc) = patch.tokenize("rc")
            if (rc) {
                candidate = rc
            }
        }

        (major,patch,candidate) = [major,candidate].collect{it.toInteger()}

        (major * 1000000) + (minor * 10000) + (patch * 100) + candidate;
    }
}

完成此操作后,请确保在main build.gradle文件中包含versioning.gradle文件,方法是在Android插件的加载位置附近添加apply:’.. / version.gradle’.

然后,在defaultConfig块中,您希望将认版本变量更改为以下值:

versionCode buildVersionCode()
versionName version

库的文件名中的版本号

如果您真正构建了一个Android库,那么预期的输出就是.aar文件.

因此,请将以下gradle代码添加到build.gradle文件中:

libraryVariants.all {
    variant -> variant.outputs.each {
        output -> output.outputFile = new File(
                output.outputFile.parent,output.outputFile.name.replace(".aar","-${defaultConfig.versionName}.aar")
        )
    }
}

就是这样!您的输出文件将具有您在gradle.proprties文件中指定的版本号的名称.

注意事项

这将以非常静态的方式对您的库和/或API进行版本控制.这意味着开发人员无法通过方法调用动态获取版本号.

一定要有一个方法可以为客户端开发人员提供版本号,并确保两者保持同步.只有这样你才能拥有一个正确版本的库.

相关文章

Android性能优化——之控件的优化 前面讲了图像的优化,接下...
前言 上一篇已经讲了如何实现textView中粗字体效果,里面主要...
最近项目重构,涉及到了数据库和文件下载,发现GreenDao这个...
WebView加载页面的两种方式 一、加载网络页面 加载网络页面,...
给APP全局设置字体主要分为两个方面来介绍 一、给原生界面设...
前言 最近UI大牛出了一版新的效果图,按照IOS的效果做的,页...