Android maven-publish使用

一、背景

如果自己开发的库想给别的项目用，需要把自己的库打包后上传到maven，最后每个项目只要依赖maven库就可以集成，maven插件已经过时，官方推荐使用maven-publish插件来实现将我们的代码发布到 Apache Maven仓库的功能。

二、依赖

apply plugin: 'maven-publish'

三、publish Task

所有以下任务都归在名为publishing类型为PublishingExtension的扩展下。

• generatePomFileForPubNamePublication：为名为PubName的发布创建一个POM文件，填充已知元数据，如项目名称、项目版本和依赖项。生成的POM文件默认放在 build/publications/$pubName/pom-default.xml.
• publishPubNamePublicationToRepoNameRepository ：将名为PubName的发布发布到名为RepoName的存储库中。如果您有一个没有显式名称的存储库定义，那么RepoName将是Maven。
• publishPubNamePublicationToMavenLocal ：将PubName发布复制到本地Maven缓存—通常是*$USER_HOME/.m2/repository*——连同发布的POM文件和其他元数据一起。
• publish：依赖于所有publishPubNamePublicationToRepoNameRepository任务。将所有已定义的发布发布到所有已定义存储库的聚合任务。它不包括将发布复制到本地Maven缓存。
  publishToMavenLocal：依赖于所有publishPubNamePublicationToMavenLocal任务。将所有已定义的发布复制到本地Maven缓存，包括它们的元数据(POM文件等)。

四、仓库 Repositories

publishing {
    repositories {
        maven {
            // 基于版本名称选择不同的仓库地址
            def releasesRepoUrl = "$buildDir/repos/releases"
            def snapshotsRepoUrl = "$buildDir/repos/snapshots"
            // url是必须要配置的
            url = version.endsWith('SNAPSHOT') ? snapshotsRepoUrl : releasesRepoUrl
            // 仓库用户名密码
            credentials {
                username = "root"
                password = "root"
            }
        }
    }
}

五、完整示例

apply plugin: 'maven-publish'

// debug仓库
def SNAPSHOT_REPOSITORY_URL = '$buildDir/repository/maven-snapshots/'
// release仓库
def RELEASE_REPOSITORY_URL = '$buildDir/repository/maven-releases/'
// maven 账户
def REPOSITORY_USER_NAME = 'username'
def REPOSITORY_USER_PSW = 'password'

afterEvaluate {
    publishing {
        publications {
            // Creates a Maven publication called "release".
            release(MavenPublication) {
                from components.release

                groupId = POM_GROUP_ID
                artifactId = POM_ARTIFACT_ID
                version = VERSION_NAME

                pom {
                    name = POM_NAME
                    description = POM_DESCRIPTION
                    url = POM_SCM_URL

                    licenses {
                        license {
                            name = 'The Apache License, Version 2.0'
                            url = 'http://www.apache.org/licenses/LICENSE-2.0.txt'
                        }
                    }
                    developers {
                        developer {
                            id = POM_DEVELOPER_NAME
                            name = POM_DEVELOPER_NAME
                        }
                    }
                    scm {
                        url = POM_SCM_URL
                        connection = ""
                        developerConnection = ""
                    }
                }
            }

        }

        repositories {
            maven {
                url = VERSION_NAME.endsWith('SNAPSHOT') ? SNAPSHOT_REPOSITORY_URL : RELEASE_REPOSITORY_URL
                credentials {
                    username = REPOSITORY_USER_NAME
                    password = REPOSITORY_USER_PSW
                }
            }
        }
    }
}