This document is licensed under the GNU Free Documentation License,
Version 1.3, 3 November 2008

# Compatibility

This plugin is compatible with all bndtools versions since 3.1.0.REL.

# Update Log

* this: 6f9720f
* bnd:  575c12f

# Changes since bndtools 3.1.1 release

* Some documentation snippets were added: section 'Replacing The Bndtools
  Gradle Setup', a remark about using the latest Jenkins plugins, and 2 links
  to the Eclipse marketplace landing pages for the plugin.
* The jacoco version  ```jacocoToolVersion``` setting was updated to
  0.7.6.201602180812.

# Changes since bndtools 3.0.0 release

* The jacoco task re-introduced its ```jacocoToolVersion``` setting, with a
  default of the latest released version (0.7.5.201505241946).
  This is because the Gradle Jacoco plugin uses an old version of Jacoco.
* Like other bndtools headless build plugins, the plugin will issue
  relevant warnings when generating or removing files.
* Improve caching  behaviour when using the Gradle daemon.

# Changes since bndtools 2.4.0 release

* Defaults (most of them) are no longer overridden for the findbugs task.
  Instead of using the 'override' variables, configure the desired settings
  directly on the project or in one of the 'custom' templates.

  These 'override' variables were removed:
  * &nbsp;```findbugsEffort```
  * &nbsp;```findbugsReportLevel```
  * &nbsp;```findbugsReportsDir```
  * &nbsp;```findbugsToolVersion```

  * Note that ```ignoreFailures```, ```includeFilter```
    and ```excludeFilter``` are still overridden if the project doesn't
    configure their 'override' variables:
    * &nbsp;```ignoreFailures``` is overridden to ```true``` if the
      'override' variable ```findbugsIgnoreFailures``` is not set by the
      project. This is because its default is ```false```, which will fail
      the build when findbugs reports anything.
    * &nbsp;```includeFilter``` is overridden
      to ```<cnf>/findbugs/findbugs.include.xml``` if the 'override'
      variable ```findbugsIncludesFile``` is not set by the project.
    * &nbsp;```excludeFilter``` is overridden
      to ```<cnf>/findbugs/findbugs.exclude.xml``` if the 'override'
      variable ```findbugsExcludesFile``` is not set by the project.

* Defaults are no longer overridden for the jacoco task.
  Instead of using the 'override' variables, configure the desired settings
  directly on the project or in one of the 'custom' templates.

  These 'override' variables were removed:
  * &nbsp;```jacocoHtmlDir```
  * &nbsp;```jacocoReportsDir```
  * &nbsp;```jacocoToolVersion```

  * The destination file changes from ```reports/jacoco/test.exec```
    to ```jacoco/test.exec```.

    ```
    generated/reports/jacoco/test.exec --> generated/jacoco/test.exec
    ```

* Defaults are no longer overridden for java projects.
  Instead of using the 'override' variables, configure the desired settings
  directly on the project or in one of the 'custom' templates.

  These 'override' variables were removed:
  * &nbsp;```javaLibsDirName```
  * &nbsp;```javaTestEnableAssertions```
  * &nbsp;```javaTestIgnoreFailures```
  * &nbsp;```javaTestMaxParallelForks```
  * &nbsp;```javaTestReportDirName```
  * &nbsp;```javaTestResultsDirName```

  * &nbsp;```libsDirName``` changes from ```.``` to the default ```libs```.
  * &nbsp;```testResultsDirName``` changes from ```reports/tests/xml``` to
    the default ```test-results```.
  * &nbsp;```testReportDirName``` changes from ```tests/html``` to the
    default ```tests```.

    ```
    generated/reports/tests/xml --> generated/test-results
    generated/tests/html        --> generated/reports/tests
    ```

* Support bndtools 3.0.0 (DEV)

# Changes since bndtools 2.3.0 release

The changes were made to let the build be more in-line with what is delivered
by the bndtools project through its Gradle support (starting with
bndtools 2.4.0.M1).

Below the changes that affect users are detailed.

* The wrapper task now always uses the latest released Gradle version, unless
  unless the ```rootGradleVersion``` is set when running the task.
* The javadoc title, docTitle and windowTitle are now configurable.
* The ```jacocoTestReport``` task is automatically run when either of
  the ```test``` or ```check``` tasks are scheduled to run.
* The jacoco reports are now placed in ```generated/reports/jacoco```.
* The findbugs reports are now placed in ```generated/reports/findbugs```.
* All custom buildscripts were renamed to better reflect that they're hooks,
  when they're invoked and the scope they affect.
* Default tasks are no longer set up.
* The build dependencies cache directory is no longer configurable and is fixed
  to ```cnf/cache```.
* The build properties in ```cnf/build.gradle.properties``` were moved
  to ```gradle.properties```.
* Build dependencies now only support '*.uri' properties (configured
  in ```gradle.properties```), support for the '*.location' properties was
  dropped and the '*.url' properties are now interpreted as URIs, hence the
  name-change. It is also no longer needed to list the bnd jar in these
  properties because it is defined in the ```gradle.properties``` file.
* The template now automatically applies the
  buildscript ```cnf/gradle/template/javaProject.gradle``` to projects that
  hava applied the Gradle Java plugin.
* The bindex and repoindex properties for the jar and the main class are no
  longer configurable.
* All ```gradleBuild...``` properties were renamed and some were removed.
  * The property ```gradleBuildDependenciesCacheDir``` was removed.
  * The property ```gradleBuildBuildProperties``` was removed.
  * The ```gradleBuildLogging...``` properties were removed.
  * The property ```gradleBuildGradleVersion``` was renamed
    to ```rootGradleVersion```.
  * The property ```gradleBuildBndProjectsDefaultTasks``` was renamed
    to ```bnd_defaultTask``` in ```gradle.properties``` and is now a
    comma-separated list of tasks.
  * The property ```gradleBuildNonBndProjectsDefaultTasks``` was renamed
    to ```others_defaultTask``` in ```gradle.properties``` and is now a
    comma-separated list of tasks.
  * The property ```gradleBuildRootProjectDefaultTasks``` was renamed
    to ```root_defaultTask``` in ```gradle.properties``` and is now a
    comma-separated list of tasks.
  * The ```gradleBuildLibsDirName``` property was renamed
    to ```javaLibsDirName```.
  * The ```gradleBuildTest...``` properties were renamed
    to ```javaTest...```.
  * The ```gradleBuildJacoco...``` properties were renamed
    to ```jacoco...```.
  * The ```gradleBuildIndex...``` properties were renamed
    to ```index...```.
  * The ```gradleBuildJavaDoc...``` properties were renamed
    to ```javadoc...```.
  * The ```gradleBuildFindbugs...``` properties were renamed
    to ```findbugs...```.
* The findbugs include and exclude files were moved from ```cnf```
  to ```cnf/findbugs```.
* The official bnd plugin as delivered by the bnd project is now used. This adds
  support for all features that it implements, like setting the Java 8 compiler
  profile (through ```javac.profile``` in a bnd file).
* Many ```bnd...``` properties are no longer set  (as a result of using the
  official bnd plugin).
* Some tasks were renamed (as a result of using the official bnd plugin):

```
bundle     --> jar
bundleTest --> check
```

* A ```name.bndrun``` file will now create an ```export.name```  task
  automatically. The ```export``` task will depend on all such created export
  tasks in the project.
* The ```export``` tasks now put their artifacts in
  the ```generated/distributions``` directory instead of
  the ```generated/export``` directory (as a result of using the official bnd
  plugin).
* Logging is no longer set up.
* The default bnd directories are no longer setup on the project. The
  corresponding properties are

```
bndSrcDir
bndSrcBinDir
bndTestSrcDir
bndTestSrcBinDir
bndTargetDir
```

* The file ```cnf/gradle/bndLayout.gradle``` was removed. Projects usings it
  should manually setup their source sets
  (as described [here](BUILDING-GRADLE.md#AddingJavaProjectsToTheBuild)).
* The property ```in.ant``` is no longer set to indicate a headless build.
  Instead, the ```driver``` or ```gestallt``` macros from bnd can be used.
  For example: setting a different release repository in the gradle build can
  be accomplished by
  setting ```-releaserepo:${if;${driver;gradle};ReleaseCI;Release}``` in the
  file ```cnf/ext/repositories.bnd```.
* The ```jsr14``` compiler target is no longer directly supported.
  Refer to the official bnd plugin for details.
* Some task dependencies were adjusted, see
  the ```cnf/gradle/doc/template.svg``` diagram for details.
