Android Library Maven发布SDK至(Github、码云)

作者:雨田Android开发

链接:https://www.jianshu.com/p/6182c474b66f

来源:简书

著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。

1 需求

你是否用过友盟、微信、微博、支付宝的sdk?

有没有想研究一下对方的代码,却发现已经混淆了?

你有没有想过有一天,你也会进入一家牛逼的企业,需要发布自己SDK?

又或者仅仅是满足自己的虚荣心,发布一个自己得意的工具?

这篇文章正是为实现这一目的

2 开发环境及工具

MAC(Windows也无所谓,路径不同而已)

Android Studio 2.3.1

JDK 1.8

Github

Maven

3 实现步骤

3.1 新建工程

新建一个工程TestModule,选择empty activity,让Android studio生成一个最简单的activity,这个工程我们用来做什么的呢?

大家知道,你交付的代码是需要有质量保证的,因此需要对他有过详尽的测试,这个工程就是我们的测试工程,简单来说就模拟用户的开发环境

3.2 新建module

新版本的Android Studio已经支持模块开发,我们选择File-->New-->New Module,此时会有一个弹框,我们选择Android Library,并起名为MySDK

image

新建成功后,你会发现左侧工程导航栏里,多出了一个模块工程,这个工程有着独立的一套目录结构,跟app一样。他有自己独立的gradle配置

image

3.2 建立功能类

在mysdk这个模块下的操作跟普通的Android工程没有任何区别,所以我们按平常一样,建立一个新的activity,起名叫mySDKTest,并自动建好layout。这篇文章的重点不在功能,所以我们在这个layout中随便建一个什么view,我们就建一个button吧,实现一个最简单的功能,点击这个button,就打印出一句“You clicked module button”。

假设,这个就是我们最终要封装的功能。

image

<?xml version="1.0" encoding="utf-8"?><LinearLayoutandroid:layout_width="match_parent"android:layout_height="match_parent"android:background="#ffffff"xmlns:android="http://schemas.android.com/apk/res/android"><Buttonandroid:layout_width="match_parent"android:layout_height="wrap_content"android:id="@+id/button"android:text="Button"/></LinearLayout>

publicclassmySDKTestextendsAppCompatActivity{privatestaticfinalStringTAG="mySDKTest";@OverrideprotectedvoidonCreate(BundlesavedInstanceState){super.onCreate(savedInstanceState);setContentView(R.layout.activity_my_sdktest);Buttonbutton=(Button)findViewById(R.id.button);button.setOnClickListener(newView.OnClickListener(){@OverridepublicvoidonClick(Viewview){Log.i(TAG,"You clicked module button!!");}});}}

3.3测试功能

此时,你会发现你根本run不起来这个工程,根本没有选项去跑这个功能,可选的只有app,没有mysdk。

image

这就是我们在3.1新建工程时说这个工程是测试工程的原因,因为Module根本跑不起来的啊

3.4配置依赖

因此我们要用到app来测试SDK,所以我们要在app中配置依赖mysdk。

方法是在app的build.gradle里加入依赖语句

compile project(':mysdk')

此时,再去app的MainActivity里,你就可以import我们刚刚建立的mySDKTest了。

同样,我们实现一个button,点击跳转到mysdk的activity。

Buttonbutton=(Button)findViewById(com.flame.mysdk.R.id.button);button.setOnClickListener(newView.OnClickListener(){@OverridepublicvoidonClick(Viewview){Intentintent=newIntent(MainActivity.this,mySDKTest.class);startActivity(intent);}});

这样就能跑起来测试了

跑起来后,点击跳转按钮,会发现进入了sdk的页面,再点击按钮,会打出那句log。

之后你可以根据自己的需求,继续开发,并测试。

image

3.5 管理依赖

3.5.1简单方式

我们假设,你已经完成了功能开发和测试,现在需要发布出去或者提交给用户,如何给到用户呢?

我们打开mysdk的目录,在build-->outputs-->aar下面是有生成的AAR文件,你把这个文件拷贝一份给用户其实,也是可以的,大家搜一下导入AAR文件即可。

image

3.5.2 Maven + Github

Apache Maven是Apache开发的一个工具,提供了用于贡献library的文件服务器。

通过Maven + Github的方式,我们可以更简单的发布,更便捷的做版本管理;用户可以更简单的导入。

也是我们重点要讲的内容

3.5.2.1配置打包gradle

在mysdk的目录下,新建一个名为maven-release-aar.gradle的文件,并在build.gradle中添加如下字段:

applyfrom:'maven-release-kline-aar.gradle'

image

3.5.2.2配置maven-release-aar.gradle

可以这么理解,maven-release-aar.gradle就是我们用来设置打包的脚本,在文件中添加如下代码:

注意看注释!!

// 1.maven-插件apply plugin:'maven'// 

2.maven-信息ext{// ext is a gradle closure allowing the declaration of global propertiesPUBLISH_GROUP_ID='com.flame'PUBLISH_ARTIFACT_ID='mySDK'PUBLISH_VERSION=android.defaultConfig.versionName}// 3.maven-输出路径

uploadArchives{

       repositories.mavenDeployer{

//这里就是最后输出地址,

在自己电脑上新建个文件夹,把文件夹路径粘贴在此//注意”file://“ + 路径,有三个斜杠,别漏了(如果路径找不到注意要带上对应盘路径)

repository(url:"file:///C:/Users/flame/Documents/sourceTree/mysdk")

pom.project{

groupId project.PUBLISH_GROUP_ID

artifactId project.PUBLISH_ARTIFACT_ID

version project.PUBLISH_VERSION

}

}

}

//以下代码会生成jar包源文件,如果是不开源码,请不要输入这段//aar包内包含注释

taskandroidSourcesJar(type:Jar){

classifier='sources'fromandroid.sourceSets.main.java.sourceFiles

}

artifacts{

archives androidSourcesJar

}

3.5.2.3生成AAR文件

接下来就是生成最终的AAR文件了,在Android studio右侧有个gradle侧边栏,点击会有如下画面,选择mysdk,点击uploadArchives

image

最后build成功

image

再去上面配置好的maven输出路径下看,会发现已经有生成文件了。

注意看,version是1.0,而且有jar包,解压jar包就会得到全部源文件

如果在上一步不开源,注释掉生成jar包的代码,这里就不会有jar包

image

3.5.2.4.1上传至github

将整个文件夹上传至Github,注意,要上传的是完整的路径

在github中新建organization,create new-new organization.

此处需要注意,create new有两个选项,new repository和new organization,此处务必要选择organization,虽然区别不大,但是假如选择repository的话不能够作为私有仓库导入到新项目(报Failed to resolve错误)

3.5.2.4.2上传至码云(

这是另外一篇文章,不要纠结两篇文章的项目路径,只要参考对应操作完成即可。

作者:啥啥啥娜娜)

链接:https://www.jianshu.com/p/3e0b213ab03d

来源:简书

著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。


1,首先在码云上新建一个项目,如下图所示


2,本地新建一个文件夹


3,进入新建的文件夹,点击鼠标右键,选择git bash here


然后在窗口输入 git init  这时候文件夹会多出一个.git文件夹,看不到文件夹的,点击鼠标右键选择“显示不显示隐藏的文件”就可以看到这个文件夹了

4,进入刚刚在码云新建的项目里,复制框框里的路径

5,然后在回到本地新建的文件夹里

继续操作git    

输入git remote add origin + 你刚刚在码云复制的那行路径

6,继续输入 git pull origin master 命令,将码云上的仓库pull到本地文件夹

7,将要上传的文件,添加到刚刚创建的文件夹   

8,使用git add .  (. 表示所有的)或者 git add + 文件名            // 将文件保存到缓存区


9,使用git commit -m '新添加的文件内容描述'     //添加文件描述



10、使用git push origin master ,将本地仓库推送到远程仓库


11,回到码云,刷新试试,就可以看到新建项目了 



3.5.2.5 管理版本

刚刚提到之所以用maven的一个原因就是版本控制,这里我们就演示一下,所谓的版本控制

打开mysdk的build.gradle,修改defaultConfig下的versionName 为"1.1"

image

再来一次#3.5.2.3 - uploadArchives,build成功后再看目录,已经生成了新的版本1.1

再上传至Github

这样我们就有了清晰的版本控制

image

3.6 如何引用

在之前的章节中,我们已经生成了对应代码,那么如何引用呢?

首先我们先要在app的build.gradle里面移除之前的依赖方法

//注释掉这段,不需要了//compile project(':mysdk')

3.6.1 本地模式

代码就在我们本地,我们当然可以就近引用咯

我们在app的build.gradle中加入如下代码,这里已经省略了无关代码

repositories{jcenter()//略//指定绝对路径maven{url"file:///Users/flame/Documents/sourceTree/mysdk"}}dependencies{//略//mysdk,这里可以指定版本,我们有1.0,1.1两个版本可选compile('com.flame:mySDK:1.1')}

3.6.2 网络模式

上面提到的方法,当然是少数,毕竟我们大多数都是在网络导入依赖库,这里就是需要用到之前上传至Github的代码了。

只需把路径指向Github即可

repositories{jcenter()//略//指定Github路径maven{url"https://github.com/flameandroid/mysdk/raw/master"}}dependencies{//略å//mysdk,这里可以指定版本,我们有1.0,1.1两个版本可选compile('com.flame:mySDK:1.1')}

3.7 混淆

我们打开External Libraries,会发现mySDK已经导入工程,而且还是完全开源的。

而很多时候我们是不需要开源的,那么如何做到呢?其实和普通的Android打包混淆一模一样

把混淆过的代码上传至Github,这样我们就完成了SDK的制作和发布

release{// 不显示LogbuildConfigField"boolean","LOG_DEBUG","false"//混淆minifyEnabledtrue//Zipalign优化zipAlignEnabledtrue// 移除无用的resource文件shrinkResourcestrue//前一部分代表系统默认的android程序的混淆文件,该文件已经包含了基本的混淆声明,后一个文件是自己的定义混淆文件proguardFilesgetDefaultProguardFile('proguard-android.txt'),'proguard-rules.pro'}

4 注意事项

注意路径一定要写对,特别是大小写,路径的大小写不对是找不到文件的,这虽然是低级错误,但其实挺常见的

注意Github路径不是常见的https://github.com/flameandroid/mysdk.git

而是https://github.com/flameandroid/mysdk/raw/master

注意如果选择了混淆,切勿在打包那步生成了jar,还上传到Github了,否则白混淆了

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

推荐阅读更多精彩内容