{"id":13733988,"url":"https://github.com/ksoichiro/gradle-eclipse-aar-plugin","last_synced_at":"2025-07-21T04:08:06.224Z","repository":{"id":27029172,"uuid":"30493915","full_name":"ksoichiro/gradle-eclipse-aar-plugin","owner":"ksoichiro","description":"Gradle plugin to use Android AAR libraries on Eclipse.","archived":false,"fork":false,"pushed_at":"2017-07-09T06:11:13.000Z","size":515,"stargazers_count":126,"open_issues_count":8,"forks_count":27,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-05-21T10:40:34.931Z","etag":null,"topics":["android","eclipse","eclipse-adt","gradle","gradle-plugin"],"latest_commit_sha":null,"homepage":null,"language":"Groovy","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ksoichiro.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-02-08T14:43:52.000Z","updated_at":"2024-10-17T18:38:37.000Z","dependencies_parsed_at":"2022-08-03T06:30:37.826Z","dependency_job_id":null,"html_url":"https://github.com/ksoichiro/gradle-eclipse-aar-plugin","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/ksoichiro/gradle-eclipse-aar-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ksoichiro%2Fgradle-eclipse-aar-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ksoichiro%2Fgradle-eclipse-aar-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ksoichiro%2Fgradle-eclipse-aar-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ksoichiro%2Fgradle-eclipse-aar-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ksoichiro","download_url":"https://codeload.github.com/ksoichiro/gradle-eclipse-aar-plugin/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ksoichiro%2Fgradle-eclipse-aar-plugin/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266236948,"owners_count":23897295,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","eclipse","eclipse-adt","gradle","gradle-plugin"],"created_at":"2024-08-03T03:00:51.541Z","updated_at":"2025-07-21T04:08:06.205Z","avatar_url":"https://github.com/ksoichiro.png","language":"Groovy","funding_links":[],"categories":["Plugins"],"sub_categories":["Android application development"],"readme":"# gradle-eclipse-aar-plugin\n\n[![Build Status](http://img.shields.io/travis/ksoichiro/gradle-eclipse-aar-plugin.svg?style=flat\u0026branch=master)](https://travis-ci.org/ksoichiro/gradle-eclipse-aar-plugin)\n[![Coverage Status](https://coveralls.io/repos/github/ksoichiro/gradle-eclipse-aar-plugin/badge.svg?branch=master)](https://coveralls.io/github/ksoichiro/gradle-eclipse-aar-plugin?branch=master)\n[![Maven Central](http://img.shields.io/maven-central/v/com.github.ksoichiro/gradle-eclipse-aar-plugin.svg?style=flat)](https://github.com/ksoichiro/gradle-eclipse-aar-plugin/releases/latest)\n\nGradle plugin to use Android AAR libraries on Eclipse.  \nWith this plugin, you can manage dependencies with Gradle and build app on Eclipse.\n\nAndroid Studio has been officially released, but some of you still want/are forced to use Eclipse ADT for some reasons.\nAndroid Studio has much better build system by integrating Gradle, and many of the remarkable features are unavailable in Eclipse.\nIn particular, many Android libraries are provided with AAR format recently, so it's now big disadvantage for Eclipse to manage these dependencies.\nThis plugin will explode AAR libraries and create \"Android Library Project\"s or copy JARs for your project by executing just one command, and you just import these projects in Eclipse.\n\nOriginally I was inspired by [this article](http://www.nodeclipse.org/projects/gradle/android/aar-for-Eclipse), then rewrote almost all of it and added many improvements to automate conversion process and to cover several dependency/project conditions.\n\n![How it works](image.png)\n\n## Prerequisites\n\nEclipse ADT is no longer maintained by Google, and it's forked into the [Andmore](https://github.com/eclipse/andmore) project.\n\nThis plugin is tested under these conditions.\n\n* [Eclipse IDE for Java Developers 4.5 (Mars)](http://www.eclipse.org/downloads/packages/eclipse-ide-java-developers/mars2)\n* [Andmore](https://marketplace.eclipse.org/content/andmore)\n\nFor the original Eclipse ADT Plugin developed by Google, the plugin is tested under the following conditions.\n\n* [Eclipse IDE for Java Developers 4.4 (Luna) SR1](https://eclipse.org/downloads/packages/eclipse-ide-java-developers/lunasr1a)\n* [Eclipse ADT Plugin](http://developer.android.com/sdk/installing/installing-adt.html)\n\n## Usage\n\n### Prepare build.gradle\n\nIf your project already uses Gradle and Android Studio, just apply this plugin.\n\nGradle 2.1+:\n\n```groovy\nbuildscript {\n    repositories {\n        mavenCentral()\n        // or jcenter()\n    }\n    dependencies {\n        classpath 'com.android.tools.build:gradle:1.0.0'\n    }\n}\n\nplugins {\n    id 'com.github.ksoichiro.eclipse.aar' version '0.3.1'\n}\n\napply plugin: 'com.android.application'\n```\n\nGradle 2.0 and former:\n\n```groovy\nbuildscript {\n    repositories {\n        mavenCentral()\n        // Enable this if you use SNAPSHOT\n        //maven {\n        //    url uri('https://oss.sonatype.org/content/repositories/snapshots/')\n        //}\n    }\n    dependencies {\n        classpath 'com.android.tools.build:gradle:1.0.0'\n        classpath 'com.github.ksoichiro:gradle-eclipse-aar-plugin:0.3.1'\n    }\n}\n\napply plugin: 'com.android.application'\n\n// Apply this plugin\napply plugin: 'com.github.ksoichiro.eclipse.aar'\n```\n\nAnd configure it in `eclipseAar` closure.\n\n```groovy\nrepositories {\n    mavenCentral()\n}\n\n// Write your dependencies\ndependencies {\n    compile 'com.android.support:appcompat-v7:21.0.2'\n    compile 'com.nineoldandroids:library:2.4.0'\n    compile 'com.melnykov:floatingactionbutton:1.0.7'\n    compile 'com.github.ksoichiro:android-observablescrollview:1.5.0'\n}\n\n// Configure eclipse-aar plugin\neclipseAar {\n    // See \"Configurations\" for details\n    androidTarget = 'android-21'\n    aarDependenciesDir = 'aarDependencies'\n    // Set to true if you use Andmore. Default is false\n    andmore = true\n}\n\n// Configure android plugin\n// (Even if you don't develop with Gradle, write following at least)\nandroid {\n    compileSdkVersion 1\n\n    // Source directory is 'src/main/java' by default.\n    // This will be added as a classpath entry in .classpath file.\n    // If you'd like to set src directory other than that,\n    // override it with sourceSets.main.java.srcDirs like this.\n    sourceSets {\n        main {\n            java.srcDirs = [ 'src' ]\n        }\n    }\n}\n```\n\n### Migrate from Eclipse ADT to Andmore\n\nIf you're going to migrate from Eclipse ADT to Andmore, please check the following notes.\n\n#### Remove or edit meta data files\n\nPlease remove the meta data files (`.classpath` and `.project`) in your app project  \nor edit them manually before executing tasks.\n\nThose files are slightly different between ADT and Andmore - package has been changed  \nfrom `com.android.ide.eclipse.adt` to `org.eclipse.andmore` - and  \nif they're not changed, Andmore does not recognize the projects.\n\nPerhaps this plugin can/should overwrite those files in the future,  \nbut currently it respects the existent contents.\n\n#### Set andmore flag\n\nSet `eclipseAar.andmore` option to `true` to generate the meta data files (`.classpath` and `.project`) for Andmore.\n\n### Prepare Gradle or Gradle wrapper\n\nInstall Gradle 2.2.1+.\n\nOr copy Gradle wrapper files into your project.\nIf you use Gradle wrapper, you don't have to install Gradle.\n\n* `gradle\\wrapper\\`\n* `gradlew`\n* `gradlew.bat`\n\n### Generate dependencies\n\n```sh\n$ ./gradlew generateEclipseDependencies\n```\n\nJAR dependencies will be copied to `libs` directory,  \nand AAR dependencies will be exploded and copied to `aarDependencies` directory by default.\n\n### Import projects to Eclipse and build app\n\n1. Launch Eclipse.\n1. Select `File` \u003e `Import`.\n1. Select `General` \u003e `Existing Projects into Workspace` and click `Next`.\n1. Click `Browse` and select project root directory.\n1. Check `Search for nested projects`.\n1. Select all projects and click next.  \n   Note that if you've imported projects in Eclipse before, there might be `bin` directories and they might be recognized as projects, but don't select them.\n1. Some warning messages might be generated, but ignore them and wait until build finishes.\n\n### Run the app\n\n1. Confirm your device is connected.\n1. Right click your main project and select `Run As` \u003e `Android Application`.\n\n### project.properties?\n\nEclipse ADT plugin uses `project.properties` file to manage library project dependencies.  \n\nIf you don't have `project.properties` file, this plugin will create it.  \nIf you have `project.properties` file but don't have the required AAR dependency entries in it, this plugin will add these entries, too.  \nTherefore you don't have to care about them.\n\nBut please note that if you have file dependencies (`libs/xxx.jar`),\nyou should manually add entries for them to `project.properties` file.\n\n### .classpath files?\n\nEclipse has `.classpath` files to manage dependencies.  \nFor Android apps, each library projects must be declared as `\u003cclasspathentry\u003e` tags in `.classpath` file.\n\nIf you don't have `.classpath` file, this plugin will create it.  \nIf you have `.classpath` file but don't have `\u003cclasspathentry\u003e`s for the required libraries in it, this plugin will add these entries, too.  \nTherefore you don't have to care about them.\n\nBut please note that if you have file dependencies (`libs/xxx.jar`),\nyou should manually add entries for them to `.classpath` file.\n\nNote that `.classpath` file generated by ADT is not recognized by Andmore.  \nTo develop with Andmore, set `eclipseAar.andmore` to `true`.\n\n### .project files?\n\nEclipse has `.project` files to manage project description.  \nIf you don't have `.project` file, this plugin will create it, so you don't have to care about them.\n\nNote that `.project` file generated by ADT is not recognized by Andmore.  \nTo develop with Andmore, set `eclipseAar.andmore` to `true`.\n\n## Configurations\n\nConfigurations for this plugin are written in `eclipseAar` closure.\n\n| Configuration | Default | Description |\n| ------------- | ------- | ----------- |\n| androidTarget | `android-21` | `target` value in dependency projects' project.properties |\n| aarDependenciesDir | `aarDependencies` | Directory to explode AARs |\n| jarDependenciesDir | (null) | Directory to locate JAR. |\n| projectNamePrefix | (Empty) | Project name prefix for AAR dependencies |\n| projectName | (Target project name) | Base project name for AAR dependencies |\n| cleanLibsDirectoryEnabled | `false` | Set to `true` if you want `libs` directory to be cleaned before files are generated. |\n| andmore | `false` | Set to `true` if you use Andmore. |\n| targetConfigurations | `['compile', 'debugCompile']` | Configurations that dependency JAR/AAR will be aggregated from |\n\n## Samples\n\nSee `samples` directory.\n\nEach projects refer to `samples/repo` directory as a Maven repository.\nYou must generate it before using samples with following command:\n\n```sh\n$ cd /path/to/this/project/root/\n$ ./gradlew clean assemble uploadArchives\n```\n\nAfter that, you can try this plugin in each projects.  \nExample:\n\n```sh\n$ cd ./samples/example/\n$ ./gradlew generateEclipseDependencies\n```\n\n## License\n\n    Copyright 2015 Soichiro Kashima\n\n    Licensed under the Apache License, Version 2.0 (the \"License\");\n    you may not use this file except in compliance with the License.\n    You may obtain a copy of the License at\n\n        http://www.apache.org/licenses/LICENSE-2.0\n\n    Unless required by applicable law or agreed to in writing, software\n    distributed under the License is distributed on an \"AS IS\" BASIS,\n    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n    See the License for the specific language governing permissions and\n    limitations under the License.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fksoichiro%2Fgradle-eclipse-aar-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fksoichiro%2Fgradle-eclipse-aar-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fksoichiro%2Fgradle-eclipse-aar-plugin/lists"}