How can I use external JARs in an Android project?

Question

I have created an Android project and added an external JAR (hessian-4.0.1.jar) to my project. I then added the JAR to the build path and checked it off in Order and Export.

Order and Export is ignored it seems, and all classes from the external JAR are missing at runtime.

Is there a trick to properly include the needed classes from an external JAR when building an Android application using the Eclipse plugin? I do not want to use ant or Maven.

as you already found out: this is caused by dependencies in hessian-4.0.1.jar. If you want to use Hessian with Android, use Hessdroid (http://code.google.com/p/hessdroid/). Not very active, but works fine for me even on Android 4.0. — Ice09, Jan 12 '12 at 09:48
See also ["NoClassDefFoundError for code in an Java library on Android"](http://stackoverflow.com/questions/8678630/) for a common problem when using external jars. [Simple solution](http://stackoverflow.com/a/20497308/194894). — Flow, Dec 10 '13 at 15:16

score 444 · Answer 1 · edited Feb 22 '19 at 09:46

444

For Eclipse

A good way to add external JARs to your Android project or any Java project is:

Create a folder called libs in your project's root folder
Copy your JAR files to the libs folder
Now right click on the Jar file and then select Build Path > Add to Build Path, which will create a folder called 'Referenced Libraries' within your project

By doing this, you will not lose your libraries that are being referenced on your hard drive whenever you transfer your project to another computer.

For Android Studio

If you are in Android View in project explorer, change it to Project view as below

Right click the desired module where you would like to add the external library, then select New > Directroy and name it as 'libs'
Now copy the blah_blah.jar into the 'libs' folder
Right click the blah_blah.jar, Then select 'Add as Library..'. This will automatically add and entry in build.gradle as compile files('libs/blah_blah.jar') and sync the gradle. And you are done

Please Note : If you are using 3rd party libraries then it is better to use transitive dependencies where Gradle script automatically downloads the JAR and the dependency JAR when gradle script run.

Ex : compile 'com.google.android.gms:play-services-ads:9.4.0'

Read more about Gradle Dependency Mangement

edited Feb 22 '19 at 09:46

Abhinav Saxena

1,904
2
22
50

answered Jul 28 '11 at 12:32

Vinayak Bevinakatti

38,839
25
103
135

49

Note that when using recent Eclipse/ADT versions the external jars have to be in a folder called `libs` (instead of `lib`) – THelper May 14 '12 at 11:24
4

@THelper - Thanks! You are correct, the folder must be named "libs" and not "lib". I was banging my head over this problem. – Camille Sévigny Jul 06 '12 at 14:21
7

In recent versions of the SDK, step 3 (adding the JAR manually to the Build Path) is unnecessary. But if you have an IDE, like Eclipse open at the time you drop the file in, you will have to do a project refresh (F5 and/or context menu Refresh in the Package Explorer). – Jon Adams Nov 29 '12 at 18:26
Thanks Vinayak, was a big help. I realised all this time i've been using references from other projects. For example, for `httpmimi-4.1.2.jar` I've always been adding via `Right click new Project > Properties > Java Build Path > Add JARS ... `. I then navigate to a previous project which uses the jar. I now realise, only creates a _link_ to a previous project JARS and, as you say will potentially leave JARS behind if I move or backup the project. Thanks again – wired00 Dec 05 '12 at 03:39
4

How is it done from the command line? What configuration file must I edit, and how? – Kristian Spangsege Dec 06 '12 at 14:16
1

In order to make it works I had to "refresh" the libs folder in eclipse. – Alessandro Jacopson Feb 14 '13 at 20:57
13

This approach has been out of date since early 2012. Just add the JAR to `libs/`. Do not manually modify the build path. – CommonsWare May 19 '13 at 03:22
I had to do this because my jar file in the lib folder whas not added automatically to buildpath. So I made "right click > Build Path > Add to Build Path" and the jar was added in private libraries . I then deleted the extra jar imported in buildpath outside of private libraries. – djleop Sep 19 '13 at 15:35
After pasting it to libs please do not forget to refresh the current project in eclipse :) – Sagiruddin Mondal Jul 25 '14 at 10:18

score 127 · Answer 2 · edited Aug 10 '11 at 08:14

127

Yes, you can use it. Here is how:

Your Project -> right click -> Import -> File System -> yourjar.jar
Your Project -> right click -> Properties -> Java Build Path -> Libraries -> Add Jar -> yourjar.jar

This video might be useful in case you are having some issues.

edited Aug 10 '11 at 08:14

Nick Betcher

1,871
4
18
25

answered Aug 26 '09 at 22:39

MannyNS

4,663
2
19
16

5

This approach has been out of date since early 2012. Just add the JAR to libs/. Do not manually modify the build path. – CommonsWare May 19 '13 at 03:22
I tried various way of adding build path. Only this way I can fix Class not found exception after migrating one project to another PC – Mickey Jun 01 '13 at 13:23
The FIRST solution is outdated and wont work AS WELL. – Yousha Aleayoub Apr 16 '15 at 14:18

score 5 · Answer 3 · edited May 23 '17 at 12:18

I'm currently using SDK 20.0.3 and none of the previous solutions worked for me.

The reason that hessdroid works where hess failed is because the two jar files contain java that is compiled for different virtual machines. The byte code created by the Java compiler is not guaranteed to run on the Dalvik virtual machine. The byte code created by the Android compiler is not guaranteed to run on the Java virtual machine.

In my case I had access to the source code and was able to create an Android jar file for it using the method that I described here: https://stackoverflow.com/a/13144382/545064

score 5 · Answer 4 · answered Jun 09 '13 at 19:23

I know the OP ends his question with reference to the Eclipse plugin, but I arrived here with a search that didn't specify Eclipse. So here goes for Android Studio:

Add jar file to libs directory (such as copy/paste)
Right-Click on jar file and select "Add as Library..."
click "Ok" on next dialog or renamed if you choose to.

That's it!

score 4 · Answer 5 · answered Aug 27 '09 at 14:15

Turns out I have not looked good enough at my stack trace, the problem is not that the external JAR is not included.

The problem is that Android platform is missing javax.naming.* and many other packages that the external JAR has dependencies too.

Adding external JAR files, and setting Order and Export in Eclipse works as expected with Android projects.

score 3 · Answer 6 · edited Oct 11 '12 at 04:03

3

Goto Current Project

RightClick->Properties->Java Build Path->Add Jar Files into Libraries -> Click OK

Then it is added into the Referenced Libraries File in your Current Project .

edited Oct 11 '12 at 04:03

Gapchoos

1,412
4
18
39

answered Jul 03 '12 at 05:10

kalyan G

31
1

score 1 · Answer 7 · edited Jul 29 '15 at 20:04

If using Android Studio, do the following (I've copied and modified @Vinayak Bs answer):

Select the Project view in the Project sideview (instead of Packages or Android)

Create a folder called libs in your project's root folder

Copy your JAR files to the libs folder

The sideview will be updated and the JAR files will show up in your project

Now right click on each JAR file you want to import and then select "Add as Library...", which will include it in your project

After that, all you need to do is reference the new classes in your code, eg. import javax.mail.*

score 1 · Answer 8 · answered Aug 29 '15 at 21:51

1

in android studio if using gradle

add this to build.gradle

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

and add the jar file to libs folder

answered Aug 29 '15 at 21:51

g_vk

106
7

score 1 · Answer 9 · answered Mar 30 '16 at 20:20

If you are using gradle build system, follow these steps:

put jar files inside respective libs folder of your android app. You will generally find it at Project > app > libs. If libs folder is missing, create one.
add this to your build.gradle file your app. (Not to your Project's build.gradle)
```
dependencies {
    compile fileTree(dir: 'libs', include: '*.jar')
    // other dependencies
}
```
This will include all your jar files available in libs folder.

If don't want to include all jar files, then you can add it individually.

compile fileTree(dir: 'libs', include: 'file.jar')

score 1 · Answer 10 · answered Nov 24 '10 at 03:54

1

Android's Java API does not support javax.naming.* and many other javax.* stuff. You need to include the dependencies as separate jars.

answered Nov 24 '10 at 03:54

Rodrigo

11
1

score 0 · Answer 11 · edited May 21 '13 at 10:26

0

create a folder (like lib) inside your project, copy your jar to that folder. now go to configure build path from right click on project, there in build path select

'add jar' browse to the folder you created and pick the jar.

edited May 21 '13 at 10:26

Dariusz

19,750
7
65
104

answered Jan 24 '13 at 12:26

sharma_kunal

2,018
1
26
27

Yochai Timmer · Answer 12 · 2015-10-31T07:57:37.800

Copying the .jar file into the Android project's folder isn't always possible.
Especially if it's an output of another project in your workspace, and it keeps getting updated.

To solve this you'll have to add the jar as a linked file to your project, instead of importing it (which will copy it locally).

In the UI choose:

Project -> Import -> File System -> yourjar.jar -> (Options area) Advanced -> Create link in workspace.

The link is save in the .project file:

<linkedResources>
    <link>
        <name>yourjar.jar</name>
        <type>1</type>
        <locationURI>PARENT-5-PROJECT_LOC/bin/android_ndk10d_armeabi-v7a/yourjar.jar</locationURI>
    </link>
</linkedResources>

PARENT-5-PROJECT_LOC means relative to the project file, 5 directories up (../../../../../).

Then add it to the libraries:
Project -> Properties -> Java Build Path -> Libraries -> Add Jar -> yourjar.jar

In the same window choose the Order and Export tab and mark your jar so it will be added to the apk.

How can I use external JARs in an Android project?

12 Answers12

Linked

Related