导入开源库到基于Android Studio构建的项目中

http://my.oschina.net/sammy1990/blog/355667

  前两天,谷歌发布了Android Studio 1.0的正式版,也有更多的人开始迁移到Android Studio进行开发。然而,网上很多的开源库,控件等还是以前的基于Eclipse进行开发,很多人不知道怎么导入到自己的基于Android Studio项目中来,微博上也有人私信我,让我来写写,正好今天回来的比较早,就写写吧。主要介绍一下常见的一些导包的场景。
android  android  studio  gradle

目录[-]

  • 前言
  • 导入Jar文件
  • 导入maven中的库
  • 导入gradle构建的开源库
  • 导入基于Eclipse构建的开源库
  • 其他
  • 前两天,谷歌发布了Android Studio 1.0的正式版,也有更多的人开始迁移到Android Studio进行开发。然而,网上很多的开源库,控件等还是以前的基于Eclipse进行开发,很多人不知道怎么导入到自己的基于Android Studio项目中来,微博上也有人私信我,让我来写写,正好今天回来的比较早,就写写吧。主要介绍一下常见的一些导包的场景。

    前言

    ?
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    --project   //项目目录
       |
       build.gradle  //项目的gradle配置文件
       |
       settings.gradle //gradle设置,会保存所有的module
       |
       app    //module 目录
       |__build.gradle module的配置
       |
       module2  //module2目录
       |__build.gradle module的配置

    同eclipse中的项目一样,gradle/android studio 构建也可以有module,将moudle放到项目目录下面,然后在settings.gradle中增加该module,最简单的方法是用文件夹名。比如我们上面的结构,build.gradle文件应该如下:

    ?
    1
    include ':app' , ':module2'

    更多关于gralde的知识可以看我以前的文章:

    使用gradle构建android项目(续) 
    使用Gradle构建Android项目

    导入Jar文件

    这种可能很常见,可以下载到别人搞好的jar包,这样可以直接在自己的主module下创建libs文件夹(我这里这样,只是为了兼容eclipse方式),然后把jar文件放进去,然后在module的build.gradle文件中的dependecies{}添加如下代码:

    ?
    1
    compile files( 'libs/name.jar' )

    当libs文件夹下面有多个文件时,可以用一句代码包含这些包:

    ?
    1
    compile fileTree(dir: 'libs' , include: [ '*.jar' ])

    当有文件不需要被包含时,可以这样:

    ?
    1
    compile fileTree(dir: 'libs' , exclude: [ 'android-support*.jar' ], include: [ '*.jar' ])

    从上面的代码中可以看到我们可以使用通配符, +表示一个字符,*表示0到多个字符。

    导入maven中的库

    如果开源库作者有将代码放到Maven库中,我们可以在gradle配置中直接引入,类似如下:

    ?
    1
    compile 'com.github.dmytrodanylyk.android-process-button:library:1.0.1'

    一般我们可以在开源库的github页面上面看有没有这样一个地址,或者到maven库中根据包名搜索有没有,我们前面这个引入的项目分三个部分 group:name:version,我们引入其他的包也有遵守这个规则。

    导入gradle构建的开源库

    这种情况的比较少用到,因为这张的开源库,作者一般都有放到maven库中,但是偶尔也会用到这里也提一下。

    首先下载文件,将我们需要的这个库的module文件夹拷贝到我们的项目的目录下面,然后在setting.gradle文件中增加文件夹名称, 然后在我们需要依赖这个模块的module中的build.gradle文件中加入如下代码:

    ?
    1
    compile project( ':libmodule' )

    这样就可以了。

    导入基于Eclipse构建的开源库

    基于Eclipse构建的项目,和基于Android Studio构建的项目的很大区别是目录结构不同。 
    我们首先将module文件夹拷贝到我们的项目目录下面,然后在settings.gradle文件中增加这个module,然后在要使用的module中的build.gradle文件中引入依赖,这样看的话,似乎和引入基于gradle构建的没什么不同。但是,基于Eclipse构建的项目中,没有build.gradle文件,所以我们需要自己新建一个放到module下面,下面是一个模版:

    ?
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    apply plugin: 'android-library'
     
    repositories {
         mavenCentral()
    }
     
    android {
         compileSdkVersion 19
         buildToolsVersion "20.0.0"
     
         defaultConfig {
             minSdkVersion 9
             targetSdkVersion 19
         }
     
         sourceSets {
             main {
                 manifest.srcFile 'AndroidManifest.xml'
                 java.srcDirs = [ 'src' ]
                 resources.srcDirs = [ 'src' ]
                 aidl.srcDirs = [ 'src' ]
                 res.srcDirs = [ 'res' ]
                 assets.srcDirs = [ 'assets' ]
                 jniLibs.srcDirs = [ 'libs' ]
             }
     
         }
     
         lintOptions {
             abortOnError false
         }
     
    }
     
    dependencies {
         compile fileTree(dir: 'libs' , include: [ '*.jar' ])
    }

    当然,根据各自的sdk和buildtools版本等等,以及其他,配置会有变化,可以看我之前的文章。

    其他

    以上就是主要的集中导入场景,自己可以根据自己的实际情况然后改变配置等等。

    另外,我们导入的仓库可能不是maven中心仓库,或者可能是我们自己搭建的仓库,我们可以自定义仓库地址的,修改build.gradle文件中的repositories就可以了,例如:

    ?
    1
    2
    3
    4
    5
    6
    7
    8
    9
    buildscript {
         repositories {
             jcenter()
             mavenCentral()
             maven {
                 url "https://oss.sonatype.org/content/repositories/snapshots"
             }
         }
    }

    另外,project层的buildscript在module层也是会生效的,所以不用在每个module都配置。

    原文地址:http://blog.isming.me/2014/12/12/import-library-to-android-studio/,转载请注明出处。


    你可能感兴趣的:(导入开源库到基于Android Studio构建的项目中)