怎样将自己的工程改造成库，并上传到Github作为依赖

转载自： http://blog.csdn.net/hmh0512/article/details/53818058 侵删

在Eclipse时代，也许你会在工程中依赖本地的另一个工程，或者把一个工程打成jar包并引入到另一个工程，又或者你公司的后台架构师会把通用的代码（比如bean）打成jar包后放到中央仓库，然后需要使用时配置Maven的pom.xml文件把它拿下来。这一切在Android Studio时代并没有太大改变，只是方式略有不同。这个题目有点长，顾名思义，它分为三个步骤：

1. 在Android Studio中将普通工程改造成库
2. 将改造后的库上传到Github
3. 将库作为依赖被自己的其他项目或别人使用

1.1 工程中创建Module

　　最开始你可能自己写了个工程，感觉不错，进行了一定的封装和优化，想留作开发下一个App时用或者给别人用。但是每次复制粘贴代码显得繁琐，还要处理一堆的package name和import错误。于是你想着把它改造成独立的工程，每次整个工程复制进去，设置引用就可以了。这就要使用android Studio的module了。以前，你的工程只有一个Module，就是(Module: app)。现在你需要新建一个Module，如图所示：

在工程名上右键–>New–>Module， 
　　 
　　 
选择Android Library–>Next，　　 
　　　　

给库取名，比如xxxLibrary，我这里叫OrangeRetrofit。 
　　　　

1.2 将核心代码移植到Module

　　接下来要做的是，把原先在工程的(Module: app)中的核心代码移到(Module：OrangeRetrofit)中。比如这里将网络请求框架的封装全部移到(Module：OrangeRetrofit)中，(Module: app)中只剩下UI相关以及封装后的网络请求框架的使用。移植过程中尤其要注意的一点是，不要把Application移过去。那么之前很多写在Application中的通用方法怎么办？比如在Application中定义了这样一个方法。

public static void runOnUiThreadDelayed(Runnable task, long miliis) {
    mainHandler.postDelayed(task, miliis);
}
 
 
1
2
3
 
 
1
2
3

　　解决办法是，在Module中新增一个静态类，我这里就叫OrangeRetrofit，用于完成Application的职责。OrangeRetrofit静态类中有一个init方法，要求使用这个库的人必须在Application的onCreate方法中调用一次OrangeRetrofit.init(this)，把context传进来。

public static void init(Context context) {
    if (null != context) {
        appContext = context;
}
 
 
1
2
3
4
 
 
1
2
3
4

　　是不是有种似曾相识的感觉？使用友盟SDK时，要求你在Application的onCreate方法中调用一次PushAgent.getInstance(this); 使用百度地图SDK时，要求你在Application的onCreate中调用一次SDKInitializer.initialize(this)。这些都是为了实现类似的功能，那就是传递app context。这样你在库中，没有Application，也可以随意得Toast，随意地getVersionName()。又因为OrangeRetrofit是个静态类，所以在调用OrangeRetrofit.init(this)时就会加载这个类，也就是在Application初始化时，app context就会传进去，OrangeRetrofit类里的静态块会比别的类和方法先执行。这样，OrangeRetrofit之于库(Module：OrangeRetrofit)就非常类似Application之于工程(Module: app)。

1.3 导入Module

　　上述步骤都完成了，并且调试通过后，你可能想在另一个工程中使用它。在工程中导入Module很简单：

1. 把整个module文件夹复制到工程的根目录
2. 在工程的settings.gradle中增加对module的引用。 
   　　由include ‘:app’变成include ‘:app’, ‘:orangeretrofit’
3. 在工程的主module (Module: app)中增加对库module的引用 
   　　compile project(path: ‘:orangeretrofit’)

　　配置好后，gradle synchronize一下就可以使用了。

2.1 把自己的库上传到Github开源

　　这个就和上传普通的代码到Github一摸一样了，在我的例子中，我上传的是包含(Module: app)和(Module：OrangeRetrofit)的整个工程。

1. 在github上新建一个repository，然后你会得到一个类似https://github.com/xxxx/xxxx.git这样的URL
2. 在Android Studio的命令行中执行git init，或者打开windows的命令行，cd到要上传的工程根目录下，或者在工程根目录右键Git Bash here（如果你安装了GitExtension的话）执行相同的命令；
3. 执行git remote add origin https://github.com/xxxx/xxxx.git，记得改成你自己的URL

　　这样你就把本地工程和Github上的repository关联起来了，就可以愉快地pull和push了。这里省略了很多细节，比如，建议写一个Markdown格式的自述文件README.md；再如，上述第2、3步可以在Android Studio的图形界面完成，这里不再赘述。对Git命令操作不熟悉的可阅读这篇翻译贴Git详解之三 Git分支

3.1 Release Github project

　　在2.1中上传到Github上的项目别人可以看到、下载、仿照、修改、整合到自己项目中，但是依然需要复制粘贴，并不能直接依赖。继续

点击releases 
　　 
　　 
按照右边的英文提示填写版本信息和描述，然后点击Publish Release一键发布。 
　　

看到这样的页面表示发布成功。

3.2 添加到JitPack

　　打开JitPack官网https://jitpack.io/，在输入框中粘贴刚刚在Github上Release的项目的地址。 
　　点击Look up然后在弹出的输入框中点击Get it 完成库的生成。我上传的是整个工程，但是这里它可以自动识别出工程中的库module。 
 
　　然后就看到我们熟悉的添加依赖的指导了，把Gradle和Maven的添加依赖的指导复制到Github上库项目的自述文件README.md中，告诉别人怎么用你的库。 

3.3 测试库依赖

　　自己新建一个工程，在主module的build.gradle中的dependencies节点中加入依赖

dependencies{
    ...//其他依赖
    compile 'com.github.ashima0512:OrangeRetrofitDemo:v1.0.0'
}
 
 
1
2
3
4
 
 
1
2
3
4

　　gradle synchronize一下，在工程中调用库中的任意一个API，如果只提示导包，而不是报错，则表示添加依赖成功。记得实际使用时，在Application的onCreate方法中调用OrangeRetrofit.init(this)。文中示例库OrangeRetrofit的源码可在Github上查看。