将自己的工程开源到GitHub---转载记录保存

最新推荐文章于 2022-06-24 01:53:09 发布

安卓开发-顺

最新推荐文章于 2022-06-24 01:53:09 发布

阅读量161

点赞数

分类专栏： Android 杂谈随记文章标签： Android开源代码到GitHub 代码提交到GitHub并开源

原文链接：https://blog.csdn.net/hmh0512/article/details/53818058

版权

Android 杂谈随记专栏收录该内容

57 篇文章 0 订阅

订阅专栏

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);
}

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

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

　　是不是有种似曾相识的感觉？使用友盟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很简单：

把整个module文件夹复制到工程的根目录
在工程的settings.gradle中增加对module的引用。
　　由include ‘:app’变成include ‘:app’, ‘:orangeretrofit’
在工程的主module (Module: app)中增加对库module的引用
　　compile project(path: ‘:orangeretrofit’)
　　配置好后，gradle synchronize一下就可以使用了。

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

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

在github上新建一个repository，然后你会得到一个类似https://github.com/xxxx/xxxx.git这样的URL
在Android Studio的命令行中执行git init，或者打开windows的命令行，cd到要上传的工程根目录下，或者在工程根目录右键Git Bash here（如果你安装了GitExtension的话）执行相同的命令；
执行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'
}

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

原文链接：https://blog.csdn.net/hmh0512/article/details/53818058