Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/AghilasMessara/android-native-dependencies
Gradle plugin for resolving and downloading Android native dependencies (.so)
https://github.com/AghilasMessara/android-native-dependencies
Last synced: about 2 months ago
JSON representation
Gradle plugin for resolving and downloading Android native dependencies (.so)
- Host: GitHub
- URL: https://github.com/AghilasMessara/android-native-dependencies
- Owner: AghilasMessara
- Created: 2014-05-25T00:45:16.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2017-08-14T08:04:49.000Z (almost 7 years ago)
- Last Synced: 2024-05-08T04:07:15.089Z (about 2 months ago)
- Language: Groovy
- Size: 933 KB
- Stars: 205
- Watchers: 15
- Forks: 29
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Lists
- awesome-gradle - android-native-dependencies - Gradle plugin for resolving and downloading Android native dependencies (.so) (Plugins / Android application development)
README
Overview
========
This Gradle plugin allows you to automatically *resolve and add* your native dependencies to `jniLibs` directory.
Usage
=====
Apply the plugin in your `build.gradle` after the regular `android` plugin, then declare the list of your native dependencies.
```groovy
buildscript {
repositories {
mavenCentral()
}
dependencies {
classpath 'com.android.tools.build:gradle:1.0.0'
classpath 'com.nabilhachicha:android-native-dependencies:0.1.2'
}
}
apply plugin: 'android'
apply plugin: 'android-native-dependencies'
native_dependencies {
artifact 'com.snappydb:snappydb-native:0.2.+:armeabi'
artifact 'com.snappydb:snappydb-native:0.2.+:x86'
}
dependencies {
//regular Jar dependencies ...
}
```
Convention
==========
> The artifact DSL follows the naming convention for Maven artifacts.
> thus, you can use one of the following syntax:
- abbreviated *group:name:version[:classifier]*
```groovy
//adding x86 classifier will resolve only intel's (.so) lib
native_dependencies {
artifact 'com.snappydb:snappydb-native:0.2+:x86'
}
//omit the classifier will resolve all supported architectures
native_dependencies {
artifact 'com.snappydb:snappydb-native:0.2+'
}
```
- map-style notation
```groovy
//adding x86 classifier will resolve only intel's (.so) lib
native_dependencies {
artifact group: 'com.snappydb', name: 'snappydb-native', version: '0.2+', classifier: 'x86'
}
//omit the classifier will resolve all supported architectures
native_dependencies {
artifact group: 'com.snappydb', name: 'snappydb-native', version: '0.2+'
}
```
In both notations, *classifier* is optional. this means that when omitted, the plugin try to resolve the artifact for *all* architectures: `armeabi`, `armeabi-v7a`, `x86` and `mips`.
- Disable `lib` prefix:
You may want to disable the plugin from prefixing the resolved artifact with `lib` (when copying into **jniLibs** directory)
```groovy
native_dependencies {
artifact ('com.snappydb:snappydb-native:0.2.+:armeabi') {
addLibPrefixToArtifact=false
}
}
```
in this example the ARM dependency will have the name `snappydb-native.so` rather than `libsnappydb-native.so`
Tasks
=====
The plugin adds the `resolveNativeDependencies` task to your project, this task runs automatically whenever you build your project.
##### Note: #####
The plugin uses [Gradle incremental task](http://www.gradle.org/docs/current/dsl/org.gradle.api.tasks.incremental.IncrementalTaskInputs.html) system to run faster if the configuration didn't change since the last build.
License
=======
Copyright 2014 Nabil Hachicha
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
[](https://travis-ci.org/nhachicha/android-native-dependencies)