Maven私有服务器搭建与Android Studio Library管理 (Maven Server Creation And Android Library Management)

此工程包含了与这篇文章相应的demo实例。方便你马上上手。

(初版文档,文档内容需要随时更改和补充)

引言 公司需要有自己的library仓库,避免重复造车轮子,方便需要时随时使用。一个方法就是建立自己的私有repository。本文档教你如下内容:

  • 如何搭建Nexus Maven私服
  • 在Android Studio中上传私有library
  • 使用私有library

Nexus下载和安装(如果已经安装好服务器,省略此步骤) 本地仓库需要有自己的仓库管理工具。Sonatype Nexus和Artifactory都是不错的选择。本文选择Sonatype Nexus。下载地址为: https://www.sonatype.com/download-oss-sonatype

image001.png

请根据你的操作系统进行选择。下载解压后,你可以看到如下的文件夹:

image002.png

在Console中(windows下为cmd),键入:

Windows:
将nexus.exe设置成以管理员身份运行
cd {nexus解压后目录/nexus-版本号/bin/}
nexus.exe /install
nexus.exe /start
Mac:
cd {nexus解压后目录/nexus-版本号/bin/}
./nexus run

如果有疑问请参考: http://books.sonatype.com/nexus-book/reference3/install.html#service-windows

打开私服管理器 在浏览器中,输入http://localhost:8081,如果一切顺利,你可以看到Nexus Repository Manager管理页面。

Tips:你也可以使用花生壳等工具,将其部署到外网中去(通过内网映射),这样你就可以用外网地址访问私服服务器了。

创建私有仓库 私服管理页面中,你首先会进入guest账户页面,这个账户你还不能新建repository。这里点击右上角的sign in

image003.png

输入管理员密码

image004.png

默认为admin,密码admin123。登陆后,点击设置按钮


image005.png

,点击Repository-Repository-Create Repository

image006.png

选择maven2(hosted)类型。当然,你也可以选择别的类型的repository。这里选择maven2是为了和android studio的maven插件配合使用,也是推荐的选择。

image007.png

输入repository的名字。Deployment policy选择Allow redeploy,否则library的提交就只能进行一次,不能重复提交。点击Create repository。

image008.png

至此私有Maven库就创建完毕了。

创建私有仓库 Library的创建是为了解决一个实际问题,可以完全是自己新建的项目,可以来自局域网的svn,也可以是在github上委托的项目。

Tips: 如何github上的项目创建,请看 https://www.londonappdeveloper.com/how-to-use-git-hub-with-android-studio/。

  • 首先,我们在Android Studio中新建一个project,点击File-New-New Project。
  • 新建一个Module,选择Android Library,指定Library Name,点击Finish。
  • 根据项目需要,编写Library Module。对于公司编写的library而言,这里应该执行版本管理,利用svn或者git等等。

Tips:library完成了某一milestone,或者进行了一遍迭代时,才应该上传代码到maven库。请注意区分这两种不同的提交。

  • 为了gradle文件的模块性,新建nexus_maven.gradle文件,输入如下代码:
apply plugin: 'maven'

task androidJavadocs(type: Javadoc) {    
  source = android.sourceSets.main.java.srcDirs    
  classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
}

task androidJavadocsJar(type: Jar, dependsOn: androidJavadocs) {
  classifier = 'javadoc'    
  from androidJavadocs.destinationDir
}

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

artifacts {    
  archives androidSourcesJar    
  archives androidJavadocsJar
}

uploadArchives {    
  repositories {        
    mavenDeployer {            
      repository(url: "YourMavenRepositoryUrl") {                            
        authentication(userName: "admin", password: "admin123")            
      }            
      pom.project {                
        name 'YourProjectName'                
        version '1.0.0'                
        artifactId 'yourartifactid'                
        groupId 'com.company'                
        packaging 'aar'                
        description 'Your Project Description'            
      }       
    }    
  }
}

这段代码首先引用maven插件;然后定义了2个任务:androidSourcesJarandroidJavadocsJar,这两个任务分别用于对Java sources打包和Java doc进行打包;接着我们对uploadArchives.repositories闭包进行一些配置,包括仓库的url地址,比如http://localhost:8081/repository/android-lib,上传所需的用户名和密码,以及pom属性。

  • 在module的build.gradle文件最后添加
apply from: './nexus_maven.gradle'

这样,代码就可以准备上传到Maven私服了。

上传本地代码到Maven库

点击Android Studio右侧的Gradle projects。双击uploadArchives上传代码。在Run Console中,查看是否成功。在Maven私服后台中,点击Browse server contents-Browse-Components,你应该可以看到刚才上传的repository。

Tips:一般而言,maven库的提交者维护着整个library的版本,不应该由library的开发者执行,repository url用localhost应该已经足够了。

image009.png

在Android Studio工程中使用某一maven库

  • 打开项目的根build.gradle文件,声明需要使用的私服地址
  allprojects {    
    repositories {        
      jcenter()        
      maven { 
        url 'http://localhost:8081/nexus/content/repositories/android-lib/' 
      }        
    }
  }

  • 在对应模块的build.gradle文件中,添加项目依赖
compile '{groupId}:{artifactId}:{version}@{packaging}'

这里的组成和提交的pom.project的信息有关,比如:

  <dependency>
    <groupId>com.vic</groupId>
    <artifactId>myrecyclerview</artifactId>
    <version>1.2.0</version>
    <type>aar</type>
  </dependency>

关于Gradle缓存

在执行过一次Gradle的同步之后,Gradle会把对应的Library的文件下载在本地,之后会直接使用。所以当我们删除旧的Library,用同样的pom.project信息重新上传一个新的Library时,执行Gradle同步,并不会更新最新的Library下来。这个时候可以到仓库存储路径下把对应的Library文件删除。 一般来说, Mac系统默认下载到:/Users/(用户名)/.gradle/caches/modules-2/files-2.1 Windows系统默认下载到:C:\Users\(用户名)\.gradle\caches\modules-2\files-2.1

参考文献

1 用AndroidStudio发布Libs到Bintray jCenter
http://www.cnblogs.com/jacksBlogs/p/5622948.html

2 巧用 GitHub 创建自己的私人 Maven 仓库,及一些开发Library的建议
http://www.jianshu.com/p/d2fae8c7d93f

3 使用 Android Studio + Nexus 搭建 Maven 私服 http://www.jianshu.com/p/f815a05c627e
http://www.jianshu.com/p/a8aac4d95214

4 Nexus Repository Manager 3.2 Documentation http://books.sonatype.com/nexus-book/reference3/install.html#service-windows

5 Android Studio发布项目到Maven仓库 http://blog.csdn.net/h_zhang/article/details/51558800

6 在Android Studio中发布Library到jCenter公共仓库 https://yangbo.tech/2015/10/19/distribute-android-library-to-jcetner/

7 拥抱 Android Studio 之四:Maven 仓库使用与私有仓库搭建 http://blog.bugtags.com/2016/01/27/embrace-android-studio-maven-deploy/#简介

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,547评论 6 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,399评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,428评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,599评论 1 274
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,612评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,577评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,941评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,603评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,852评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,605评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,693评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,375评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,955评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,936评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,172评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,970评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,414评论 2 342

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,401评论 25 707
  • 首先万恶的电子网络,我在心里1给你一万个白眼!!! 然后我很生气,为什么我自己不认真把写好的文章储存,而是不小心把...
    億佯阅读 160评论 0 0
  • 董家沟村历史久远,人才辈出,其中的好汉董老园,因行侠仗义,扶危济贫,而深得村民的推崇与爱戴,他的故事历时长...
    wangfengqun阅读 523评论 0 0
  • 化妆不仅仅关乎美不美的问题在某一层面上来说也是尊不尊重主人的问题化妆品化妆补妆不可在公众场合补妆,最好在洗手间上补...
    tang小米阅读 199评论 2 1
  • 雨, 湿透了谁的衣襟? 千百年来, 有谁在雨中哭泣? 江南的烟雨, 莫名的情绪, 这里, 没有, 只有冰冷的气息。...
    想飞的树不如草阅读 134评论 0 1