Nexus搭建本地Maven仓库

Nexus搭建本地Maven仓库

1、共享利器,利人利己

  在团队协作开发中，每个程序员都有自己的模块开发维护，其中有很多共用的代码不需要每个程序员都编写一遍。这就可以把公用的代码模块抽离出来，
并形成可依赖使用的jar或者aar。这样既能提高效率，也有利于代码维护，形成快速开发的利器。本文就是总结开发中，搭建私有的maven仓库的过程与使用。

2、Nexus的下载与安装

  具体详情，请查看上一篇博文Nexus 3.x的使用

3、Nexus的仓库目录与路径

3.1、仓库的类型

hosted

  本地仓库，通常用于提交本地开发的库

proxy

  代理仓库，如果本地仓库中没有资源，就会从远程仓库(比如maven)中拉取。

group

  仓库组，用来合并多个hosted/proxy仓库

3.2、仓库的路径

URL

  点击copy，就可以复制仓库的路径。

4、Library实例PermissionKit

  项目地址： https://github.com/ProgressiveDevelop/PermissionKit

5、配置Nexus上传脚本 nexus_push.gradle

//引入插件
apply plugin: 'maven'
//编译 Javadoc
task androidJavadocs(type: Javadoc) {
    source = android.sourceSets.main.java.srcDirs
    classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
}
//编译 xxx-javadoc.jar
task androidJavadocsJar(type: Jar) {
    classifier = 'javadoc'
    from androidJavadocs.destinationDir
}
//编译 xxx-sources.jar
task androidSourcesJar(type: Jar) {
    classifier = 'sources'
    from android.sourceSets.main.java.srcDirs
}
artifacts {
    archives androidSourcesJar
    archives androidJavadocsJar
}
uploadArchives {
    repositories {
        mavenDeployer {
            //配置发布的仓库与账号、密码
            repository(url: "http://127.0.0.1:8081/repository/maven-releases/") {
                authentication(userName: "admin", password: "admin123")
            }
            //指定id
            pom.artifactId = 'permissionkit'
            //指定版本
            pom.version = '1.0.0'
            pom.project {
                licenses {
                    license {
                        name 'The Apache Software License, Version 2.0'
                        url 'http://www.apache.org/licenses/LICENSE-2.0.txt'
                    }
                }
            }
        }
    }
}

6、编译

apply from: ‘./nexus-push.gradle’

  首先需要在library中的 build.gradle 最后引入 nexus-push.gradle(两个文件在同一目录下)。

命令行输入：gradlew uploadArchives

  在Android studio底部的 Terminal 的窗口执行命令,出现如下图，表示编译成功。

  在Nexus管理后台即可查看编译的文件。

7、如何使用

7.1、引入仓库

/*项目根 build.gradle 中配置仓库*/
allprojects {
    repositories {
        google()
        jcenter()
        maven{
            url "http://127.0.0.1:8081/repository/maven-releases/"
        }
    }
}

7.2、项目module中 build.gradle中引入 jar包

 implementation 'PermissionKit:permissionkit:1.0.0@aar'

8、错误与解决

8.1、错误: 编码GBK的不可映射字符

  原因：当Java源代码中包含中文字符时，在用javac编译时会出现“错误：编码GBK的不可映射字符”。
由于JDK是国际版的，在用javac编译时，编译程序首先会获取操作系统默认采用的编码格式(GBK)，然后JDK就把Java源文件
从GBK编码格式转换为Java内部默认的Unicode格式放入内存中，然后javac把转换后的Unicode格式的文件编译成class类文
件，此时，class文件是Unicode编码的，它暂存在内存中，JDK将此以Unicode格式编码的class文件保存到操作系统中形成
最终的class文件。当不指定编码方式就编译时，相当于使用了参数：javac -encoding GBK xxx.java，此时就会出现不兼容的情况。
  解决：指定编码方式。