Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cjstehno/gradle-natives
Gradle plugin to aid in managing native libraries associated with Java-based projects.
https://github.com/cjstehno/gradle-natives
abandoned gradle-plugin groovy help-wanted native-libraries
Last synced: about 1 month ago
JSON representation
Gradle plugin to aid in managing native libraries associated with Java-based projects.
- Host: GitHub
- URL: https://github.com/cjstehno/gradle-natives
- Owner: cjstehno
- License: apache-2.0
- Created: 2014-03-15T12:04:06.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2017-10-23T12:44:45.000Z (about 7 years ago)
- Last Synced: 2023-03-11T10:41:28.940Z (almost 2 years ago)
- Topics: abandoned, gradle-plugin, groovy, help-wanted, native-libraries
- Language: Groovy
- Homepage: http://cjstehno.github.io/gradle-natives/
- Size: 1.94 MB
- Stars: 32
- Watchers: 5
- Forks: 4
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Gradle Natives Plugin
[](https://travis-ci.org/cjstehno/gradle-natives) [](https://coveralls.io/github/cjstehno/gradle-natives?branch=master)
A Gradle plugin to aid in working with Java-based projects that provide supporting native libraries.
## Current Status: Abandoned
This plugin started out to solve the simple problem of making the native libraries stored in dependency jar files more easily usable in Gradle projects,
namely the simple game project that I was working on at the time. When I stopped working on the game project, it seemed that there was some interest
in the plugin so I kept it up and tried to make it a bit better. Personally, I have not used it since a few months after it was written, and I have
other projects that I do actually use, so I am listing this project as abandoned.
That being said, I will make some attempt to keep it building successfully under current Gradle and Groovy trends; however, most reported issues
probably won't get much attention. You are welcome to submit pull requests for fixes and features and I will review and act on them in a timely manner.
## Build
./gradlew clean build
## Installation
To add the plugin to your project, add the following to your `build.gradle` file (or update the `buildscript` block if it already exists):
```groovy
buildscript {
repositories {
maven {
url "https://plugins.gradle.org/m2/"
}
}
dependencies {
classpath "gradle.plugin.com.stehno:gradle-natives:0.3.1"
}
}
apply plugin: "com.stehno.natives"
```
Alternately, you can use the new plug definition block in Gradle 2.1 and beyond.
```groovy
plugins {
id 'com.stehno.natives' version '0.3.1'
}
```
The plugin is compiled on Java 7.
## Usage
Without any additional configuration, the plugin will find all native libraries in all `compile` and `runtime` dependency configurations, for all platforms, and unpack them into
the `build/natives` directory of your project. You can configure this behavior by adding a `natives` block to your `build.gradle` file. The default behavior has the following configuration:
```groovy
natives {
configurations = ['compile', 'runtime']
platforms = Platform.all()
outputDir = 'natives'
}
```
A `libraries` Closure may also be added to filter the resolved libraries, such as:
```groovy
natives {
configurations = ['compile', 'runtime']
platforms = Platform.all()
outputDir = 'natives'
libraries {
exclude = ['somelib.dll']
}
}
```
There are two tasks provided by the plguin:
* `listNatives` - lists all of the native libraries resolved by the current configuration.
* `includeNatives` - includes (copies) the resolved native libraries into the configured output directory.
## Warning
This plugin only resolves native libraries that are on the project classpath as dependencies of the project (Gradle dependencies, either direct or transitive).
## References
* Site: http://cjstehno.github.io/gradle-natives
* Blog Post: http://coffeaelectronica.com/blog/2014/going-native-with-gradle.html