最近完成的一個(gè)小的任務(wù)是將Andorid的SDK發(fā)布到公司的maven倉(cāng)庫(kù)，供內(nèi)部開(kāi)發(fā)人員使用，這里記錄一下完成這一小的任務(wù)學(xué)習(xí)的知識(shí)以及踩的坑。

使用gradle發(fā)布Android library到maven倉(cāng)庫(kù)主要有兩種方式，一種是使用uploadArchives约啊，另一種是使用publish。下面分別對(duì)這兩種方式進(jìn)行介紹佣赖。

1.uploadArchives

uploadArchives是一種比較老的發(fā)布library到maven倉(cāng)庫(kù)的方式恰矩，我們?cè)谛枰虬l(fā)布的Module里的build.gradle模塊里增加如下代碼：

uploadArchives.png

2.png

需要注意的是屈藐，repository中填寫(xiě)的路徑榔组，如果是本地路徑熙尉，那么要在路徑前面加上file://localhost的前綴，否則會(huì)發(fā)布不成功搓扯。

然后在項(xiàng)目根目錄的命令行下執(zhí)行命令：
./gradlew uploadArchives
我們就可以在repository所填寫(xiě)的地址下查看生成的SDK检痰。

SDK文件.png

3.png

uploadArchives方式和publish方式的一個(gè)很大的區(qū)別就是uploadArchives會(huì)自動(dòng)生成pom文件里的dependencies節(jié)點(diǎn)桥帆，使得SDK的依賴被成功傳遞医增，而publish方式則需要自己手動(dòng)添加到pom文件。

使用已發(fā)布的SDK

使用已發(fā)布的SDK很簡(jiǎn)單老虫，我們只需要進(jìn)行比普通的引用多一步叶骨，即添加maven倉(cāng)庫(kù)的路徑，我們?cè)诠こ痰?code>build.gradle的allprojects下添加maven倉(cāng)庫(kù)的路徑：

maven {url '/Users/abc/.m2/repository/'}

然后在Module的build.gradle文件里正常引用：

implementation 'com.huya.hybrid:lizard:5.0.0-SNAPSHOT'

2.publish

使用publish方式發(fā)布library需要使用maven-publish插件祈匙。步驟如下：
首先在要發(fā)布的Module下的build.gradle文件同目錄下新建文件publish.gradle忽刽，在該文件中新建一個(gè)publish任務(wù)：

apply plugin: 'maven-publish'

def getReleaseRepositoryUrl() {
    return hasProperty('RELEASE_REPOSITORY_URL') ? RELEASE_REPOSITORY_URL
            : "https://oss.sonatype.org/content/repositories/releases/"
}

def getSnapshotRepositoryUrl() {
    return hasProperty('SNAPSHOT_REPOSITORY_URL') ? SNAPSHOT_REPOSITORY_URL
            : "https://oss.sonatype.org/content/repositories/snapshots/"
}

def getRepositoryUsername() {
    return hasProperty('NEXUS_USERNAME') ? NEXUS_USERNAME : "admin"
}

def getRepositoryPassword() {
    return hasProperty('NEXUS_PASSWORD') ? NEXUS_PASSWORD : "admin123"
}

task sourcesJar(type: Jar) {
    classifier = 'sources'
    from android.sourceSets.main.java.srcDirs
}

publishing {
    publications {
        PublishAndroidAssetLibrary(MavenPublication) {
            groupId 'com.huya.hybrid'
            artifactId 'oak-webview-sdk'
            version version
            afterEvaluate {
                artifact bundleReleaseAar
            }
            artifact sourcesJar

            pom.withXml {
                //在pom.xml添加依賴關(guān)系
                def dependenciesNode = asNode().appendNode('dependencies')
                //拿到所有編譯時(shí)的依賴
                def dependenciesList = []
                dependenciesList.addAll(configurations.implementation.allDependencies)
                dependenciesList.addAll(configurations.api.allDependencies)
                dependenciesList.each {
                    if (null != it.group) {
                        def dependencyNode = dependenciesNode.appendNode('dependency')
                        dependencyNode.appendNode('groupId', it.group)
                        dependencyNode.appendNode('artifactId', it.name)
                        dependencyNode.appendNode('version', it.version)
                        dependencyNode.appendNode('scope', 'compile')
                    }
                }
                
        }
    }
}


def getRepositoryUrl() {
    if (version != null && version.toLowerCase().endsWith("snapshot")) {
        return getSnapshotRepositoryUrl()
    } else {
        return getReleaseRepositoryUrl()
    }
}

boolean isJenkinsBuild = 0 != (System.getenv("BUILD_NUMBER") as Integer ?: 0)
String localMavenRepoPath = hasProperty("LOCAL_REPO") ? getProperty("LOCAL_REPO") : "${rootDir}/outputs/android/maven"

println("isJenkinsBuild=$isJenkinsBuild,repo=$localMavenRepoPath")


publishing {
    repositories {
        if (isJenkinsBuild) {
            //這個(gè)是發(fā)布到線上倉(cāng)庫(kù)的功能支持
            maven {
                url getRepositoryUrl()
                credentials {
                    username = getRepositoryUsername()
                    password = getRepositoryPassword()
                }
            }
        } else {
            //這個(gè)是發(fā)布到本地目錄功能支持
            maven {
                url localMavenRepoPath
            }
        }
    }
}

首先看到publish任務(wù)的repository模塊，該模塊確定了SDK發(fā)布的地址夺欲。

4.png

5.png

然后在gradle.properties里面可以設(shè)置version：

version=1.0.0-SNAPSHOT

在Module的build.gradle中引用publish.gradle:

apply from: "publish.gradle"

最后再根目錄下命令行執(zhí)行：

./gradlew publish

最后生成的文件目錄如下：

6.png

7.png

最后是使用侈咕，首先是跟uploadArchives一樣添加maven倉(cāng)庫(kù)地址公罕，這個(gè)不再介紹。然后是在Module的build.gradle下添加引用：

implementation ('com.huya.hybrid:lizard:6.0.0-SNAPSHOT'){transitive = true}

最后多的這個(gè){transitive = true}用來(lái)顯式指出是否傳遞本身的依賴給宿主程序耀销。

參考

Maven publish plugin
https://developer.android.com/studio/build/dependencies
https://www.baeldung.com/maven-dependency-scopes