How do I add a library project to the Android Studio?

最新推荐文章于 2025-06-09 08:45:54 发布

转载最新推荐文章于 2025-06-09 08:45:54 发布 · 656 阅读

本文详细介绍了在Android Studio 1.0版本中通过Gradle文件手动添加外部库项目的全过程。包括创建新项目、放置库文件、编辑设置文件、添加依赖等步骤。

http://stackoverflow.com/questions/16588064/how-do-i-add-a-library-project-to-the-android-studio

Update for Android Studio 1.0

Since Android Studio 1.0 was released (and a lot of versions between v1.0 and one of the firsts from the time of my previous answer) some things has changed.

My description is focused on adding external library project by hand via gradle files (for better understanding the process). If you want to add library via Android Studio creator just check theanswer below with visual guide (there are some differents between Android Studio 1.0 and those from screenshots, but the process is very similar).

Before you start adding library to your project by hand consider adding external dependency. It won’t mess in your project structure. Almost every well known Android library is available in maven repository and its installation takes only one line of code in app/build.gradle file:

dependencies {
     compile 'com.jakewharton:butterknife:6.0.0'
}

Adding the library

Here is the full process of adding external Android library to our project:

Create new project via Android Studio creator. I named it HelloWorld
Here is the original project structure created by Android Studio:

HelloWorld/
      app/
           - build.gradle  // local gradle config (for app only)
           ...
      - build.gradle // global gradle config (for whole project)
      - settings.gradle 
      - gradle.properties
      ...

In root directory (HelloWorld/) create new folder: /libs in which we’ll place our external libraries (this step is not required - only for keeping cleaner project structure).
Paste your library in newly created /libs folder. In this example I used PagerSlidingTabStrip library (just download ZIP from Github, rename library directory to „PagerSlidingTabStrip" and copy it). Here is the new structure of our project:

HelloWorld/
      app/
           - build.gradle  // local gradle config (for app only)
           ...
      libs/
           PagerSlidingTabStrip/
                - build.gradle // local gradle config (for library only)
      - build.gradle // global gradle config (for whole project)
      - settings.gradle 
      - gradle.properties
      ...

Edit settings.gradle by adding your library to include. If you use custom path like I did, you have also define project directory for our library. Whole settings.gradle should look like below:
```
include ':app', ':PagerSlidingTabStrip'
project(':PagerSlidingTabStrip').projectDir = new File('libs/PagerSlidingTabStrip')
```

5.1 If you face "Default Configuration" error, then try this instead of step 5,

include ':app'
include ':libs:PagerSlidingTabStrip'

In app/build.gradle add our library project as an dependency:

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    compile 'com.android.support:appcompat-v7:21.0.3'
    compile project(":PagerSlidingTabStrip")
}

6.1. If you followed step 5.1, then follow this instead of 6,

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    compile 'com.android.support:appcompat-v7:21.0.3'

    compile project(":libs:PagerSlidingTabStrip")
}

If your library project doesn’t have build.gradle file you have to create it manually. Here is example of that file:

apply plugin: 'com.android.library'

dependencies {
    compile 'com.android.support:support-v4:21.0.3'
}

android {
    compileSdkVersion 21
    buildToolsVersion "21.1.2"

    defaultConfig {
        minSdkVersion 14
        targetSdkVersion 21
    }

    sourceSets {
        main {
            manifest.srcFile 'AndroidManifest.xml'
            java.srcDirs = ['src']
            res.srcDirs = ['res']
        }
    }
}

Additionaly you can create global config for your project which will contain SDK versions and build tools version for every module to keep consistency. Just edit gradle.properties file and add lines:

ANDROID_BUILD_MIN_SDK_VERSION=14
ANDROID_BUILD_TARGET_SDK_VERSION=21
ANDROID_BUILD_TOOLS_VERSION=21.1.3
ANDROID_BUILD_SDK_VERSION=21

Now you can use it in your build.gradle files (in app and libraries modules) like below:

//...
android {
    compileSdkVersion Integer.parseInt(project.ANDROID_BUILD_SDK_VERSION)
    buildToolsVersion project.ANDROID_BUILD_TOOLS_VERSION

    defaultConfig {
        minSdkVersion Integer.parseInt(project.ANDROID_BUILD_MIN_SDK_VERSION)
        targetSdkVersion Integer.parseInt(project.ANDROID_BUILD_TARGET_SDK_VERSION)
    }
}
//...