引言
对于程序开发人员来说,了解和熟练使用Github是一项必备且重要的技能。因为Github作为一个分布式的版本控制系统和代码托管平台,开源了海量的源码资源,能够极大的提高学习效率,减少开发周期。当然毕竟是计算机业界专业平台,它的使用是有一定门槛的,对于萌新来说,Github就好像一个装满宝藏的宫殿,带不走更花不了,着实痛苦。本文就通过一个案例,从下载到部署详细的介绍如何从Github上下载的项目中抠出库文件并部署在个人AndroidStudio工程中,将宝藏据为己有!
项目选择
本人最近在研究Android开源的UI框架,在CSDN上找到了一篇文章介绍Side-Menu揭幕式侧边栏实现效果,特别想据为己有,正好又提供了项目地址,那就不好意思了,哈哈!
下载
由于Github上下载文件需要安装git,因此还没有了解什么是git以及如何通过git操作github的同学请先移步了解安装,这里推荐一个学习地址还不错哦!
git安装与常用操作:
https://www.liaoxuefeng.com/wiki/896043488029600
从github上下载源码非常简单:
1.进入下载路径:打开你想要保存下载文件的文件夹
2.右键-》Git Bash:比如我想在将文件下载到桌面,那么直接在桌面右键-》Git Bash就可以启动控制台
3.拷贝github上项目的SSH:
通过项目地址跳转到github,然后如图1、2、3
一般下载的SSH Key格式如下:
[email protected]:Yalantis/Side-Menu.Android.git
4.在git bash控制台中输入:git clone github上复制的SSH Key 后回车
完成后在你的当前目录就可以看到完整工程了,文件名同github上一样:
以上就将github上的代码完整克隆到本地了!
导入前的准备
拿到项目后先别急着用AndroidStudio打开,因为人家项目中使用的构建工具多半跟你不同,为了避免长时间下载等待,建议提前做以下工作:
1.打开下载项目文件夹,删除.gradle、gradle文件夹
2.使用文本编辑器,打开build.gradle文件,修改gradle为你自己的gradle版本。
不知道自己版本的同学,可以新建一个项目,然后将工程build.gradle中的版本拷贝。
用文本编辑其打开github项目的工程build.gradle,用复制的gradle替换项目中的:
3.完成前面工作后,就可以启动AndroidStudio通过Open的方式加载项目了!
5.run起来看效果
效果很不错,其实第二大步的操作并不是一定要求完成的,这里跟大家总结下第二步的主要目的:
1.验证程序的正确性,万一移植了半天库结果本来提供的程序就有问题那就很尴尬了1
2.提前调试错误以及下载相关组件,减少后期倒库后错误太多。
查看库文件
万事俱备就等倒库了,等等。。。这个项目有哪些库?
这个项目里面实际上包含两个我们新建项目中没有的库,这个如何去看呢?方法如下:
1.查看github项目工程目录
2.查看app文件目录下的模块build.gradle关联库
总结:本github工程一共有两个库需要被导入到个人项目:
1.library文件夹作为库文件引入
2.com.github.ozodrukh:CircularReveal:2.1.0 jar包导入
开始导入
一、新建工程
二、导入library库文件,对于library这种文件的导入很简单,大家展开library文件夹可以看到,
它具备完整的目录结构,可以作为moudle直接import到新工程中:
点击确认后,构建代码,然后报错:
解决:将github原工程中工程build.gradle里的关联拷贝到个人项目中
是不是真的引入成功,还要看能否使用库中的类,因此我们在个人工程的MainActivity.java文件中实例化FlipAnimation对象,居然报错。。。
不要慌,现在的错误就很简单了,办法如下:
1.关联模块
2.引入申明
现在第一个库导入全部完成,可以使用库中的类了!
二、再来看看CircularReveal:2.1.0库的导入,这个就比较简单了,只需要指定好关联和数据仓库地址,就能够在线下载到extra library中了,这也是最常用的引入方式!方法如下:
1.对比github原工程app文件夹中的build.gradle文件,发现关联了’com.github.ozodrukh:CircularReveal:2.1.0’,直接复制到个人工程对应文件即可
2.编译后发现报错,大概就是说找不到关联在哪里,或者从哪里下载
解决:同样对比github原工程app文件夹中的build.gradle文件,直接复制到个人工程对应文件即可,编译换成后发现错误变了。。。
解决办法:
所有问题解决,看下引入效果:
总结
花了一整天时间研究github和导入库,并根据自己的理解完整的通过项目实现了一遍,整体来说还算顺利,需要注意的是不同的项目或者环境在导入库的过程中出现的错误可能不同,这也给初学者在实验过程中带来了很多不确定性和困难,所以也是建议大家一定要有信心、决心、恒心!