Monday, September 28, 2015

How to create and use an Android Archive (*.aar) using Android Studio

Besides a plain old Java archive file (*.jar), Android Studio can be used to create an Android archive file (*.aar) that can contain classes and methods that make use of Android classes and related files. Like creating the Jar file, an Android project must be created first, then the Android library module can be created and added. The following steps illustrate the process in creating a Android archive file.

Generating the Android archive (*.aar) file

  1. Start up Android Studio.
  2.  Select Start a new Android Studio project.

    The Create New Project dialog box appears.
  3. Type in an Application name and a Company Domain. Select a Project location. Click Next.

    The Target Android Device page appears.
  4. Choose a Minimum SDK, e.g. API 14. Click Next.

    The Add an activity to Mobile page appears.
  5. Select Add No Activity. Click Finish.

    The Android project is created.
  6. Select File | New | New Module.

    The Create New Module dialog box appears.

  7. Select Android library. Click Next.

    The Configure your new module page appears.

  8. In the Application/Library name field, type in e.g. MyAarLibrary.
  9. In the Module name field, type in e.g. myaarlibrary.
  10. If necessary, edit the Package name and/or change the Minimum SDK.
  11. Click Next.

    The myaarlibrary library is created.
  12. In the newly created myaarlibrary module node, create the classes and methods of the library in the editor, e.g. LibraryClass class with a printLog method.

    Note: the example printLog uses the Android.Util.Log class to print a debug log message.

  13. In the Project tree view, select the newly created module node, e.g. myaarlibrary. Then open the Gradle projects pane on the right side. Expand the Tasks node, as shown below.

  14. Double click on assembleRelease.

    The Android archive file is generated, e.g. myaarlibrary-release.aar.

Using the Android archive (*.aar) file
  1. In Android Studio, create a new project or open up an existing project that you want to use the Android archive file library.
  2. In the Project view, expand the libs node of the app.
  3. Using the Mac Finder or Windows Explorer, select and copy the Android archive file (*.aar) e.g. myaarlibrary.aar. Paste the aar file into the libs node in Android Studio.

    The Copy dialog box appears.

  4.  If necessary, change the name. Click OK.

    The Aar file is added to the project.
  5. In Android Studio, open the app's build.gradle file in the editor.

  6. As shown above, add in the repositories section.

    repositories {
    flatDir {
    dirs 'libs'

  7. Add in the following line to the dependencies section.

    compile (name: 'myaarlibrary-release', ext:'aar')

    Now the classes and methods in the Android archive file can be used in your app, as shown in the example below.


Unknown said...

Works perfectly. Thanks.
PS : nice profile picture :p

jean-philippe denis said...

Perfect for me. No trick left behind. good job :)

Lucas Daniel said...

Thank you!
Very good tutorial

Kameswari said...

Thanks for the detailed explanation. Can we create resource files like layouts, styles,...etc and reuse them with this?

Anonymous said...

I feel compelled to tell you how happy I am to have found this blog - without the gradle instructions and descriptions, nowhere does it say ON THE ENTIRE INTERNET how you're supposed to get an AAR in a library. Thank you so much!

(There are significant steps missing from this page:

riChArDfu said...

Great tutorial, been finding this for a while and finally got this easy and clear instruction.

Unknown said...

anyone would like to please help me here .. THANX

Related Posts with Thumbnails