### Upgrade Notes

#### v14.0.0

- **Breaking Change**: The `core` plugin no longer depends on the `kotlinx.immutable` collections library.
    - Collections are marked as stable via the stability config file instead: https://github.com/mikepenz/AboutLibraries/pull/1267
- **Breaking Change**: The already deprecated `generateLibraryDefinitions*` tasks are now removed
- **Breaking Change**: The plugin will now only work for projects that use AGP 7 or newer, with the new variants API via `AndroidComponentsExtension` available
- **Breaking Change**: Due to Paparazzi requiring Java 21 - This project is now also compiled with Java 21

#### v13.2.0

- **Breaking Change**: Some underlying APIs start to require API 23 instead of 21.
    - `org.jetbrains.compose.components.resources`
- **Dependency Upgrade**: Kotlin 2.3.0
- **Dependency Upgrade**: Compose 1.10.x

#### v13.1.0

- **Behaviour Change**: The `Gradle Plugin` now by default enables MERGING duplicates with EXACT matches. In prior releases, duplicates would be kept.
```kotlin
// To enable the prior behavior, you can simply configure this in your build script
aboutLibraries {
    library {
        duplicationMode = DuplicateMode.KEEP
        duplicationRule = DuplicateRule.SIMPLE
    }
}

```


#### v13.0.0

- **Breaking Change**: Deprecated APIs from v12.x.y were removed
- **Breaking Change**: The `Gradle Plugin` was split into 2. The main plugin that is registering all the manual tasks, and an Android specific one automatically registering the Android auto
  generation task.
  - For most projects the manual tasks are recommended. Only if you require or want to use the generation as part of the android build, use the `.android` plugin.
  - The main plugin (`com.mikepenz.aboutlibraries.plugin`) provides tasks like `exportLibraryDefinitions` that need to be manually executed
  - The Android plugin (`com.mikepenz.aboutlibraries.plugin.android`) automatically hooks into the Android build process

```kotlin
// To use the Android auto registering plugin - add the following to your module:
id("com.mikepenz.aboutlibraries.plugin.android")
```
- **Breaking Change**: The `AndroidConfig` class and its `registerAndroidTasks` property were removed, replaced by the Android-specific plugin
- **Breaking Change**: Reworked the `LibraryColors` interface to be more descriptive and more flexible
  - Renamed `backgroundColor` to `libraryBackgroundColor`
  - Renamed `contentColor` to `libraryContentColor`
  - Added new background, content color variants for the dialog

#### v12.2.0

- **Breaking Change**: Renamed `nameTextStyles` in `libraryTextStyles`/`LibraryTextStyles` to `nameTextStyle` (to align with other styles).
- **Breaking Change**: Introduced new `libraryPadding()` default function to replace the existing one. This moves to use a new class to hold chip paddings.
- **Breaking Change**: Wrappers around the `LibrariesContainer` were deprecated in favor of `remember*` functions. To be removed in release `13.x.y`.
- **Breaking Change**: The `LicenseDialogBody` now also accepts the `Modifier` to include padding in text instead of scrollable container
- **Deprecate**: Deprecate series of APIs to cleanup and simplify API surface, and simplify maintenance.
- **Note**: Updated README to suggest new non deprecated API for using `LibrariesContainer` on Android.

#### v12.0.0

- **Dependency Upgrade**: Kotlin 2.1.20
- **Breaking Change**: The `Gradle Plugin` and `Compose UI` library have undergone significant changes, including multiple breaking API changes.
- **Breaking Change**: The `Gradle Plugin` has moved to a `Property` based configuration schema with nested configs for better organization.
- **Breaking Change**: The `Gradle Plugin's` configuration options which were `Array` or `List` types have been changed to `Set` types.
- **Breaking Change**: The `Gradle Plugin` now only has a singular `outputPath` property, to specify where the generated file should be written to.
- **Behaviour Change**: The `Gradle Plugin` will now do parts of the setup during configuration time to improve configuration cache compatibility.
- **Breaking Change**: The Compose UI APIs were overhauled to improve the API and reduce the number of parameters, and make it more flexible for the future.

API changes to simplify the expansion and configuration of the compose UI.

v11.x.y

```kotlin
LibrariesContainer(
    itemContentPadding = PaddingValues(16.dp),
    itemSpacing = 2.dp
)
```

v12.x.y

```kotlin
LibrariesContainer(
    padding = LibraryDefaults.libraryPadding(contentPadding = PaddingValues(16.dp)),
    dimensions = LibraryDefaults.libraryDimensions(itemSpacing = 2.dp),
)
```

#### v10.x.y

* v10 includes a major rewrite of the `Gradle Plugin`. The old `xml` string resource format
  definitions are no longer supported.
    * All meta information is now written to a single json file
    * Old `enchant` config files are no longer supported
* The UI module dropped a major amount of configurations to lower complexity.
* TODO

#### v7.0.1

* in case your project has custom licenses, check out the new feature to allow the license
  description be included as raw file. This helps to solve the potential STRING_TOO_LARGE issue.

#### v7.x.y

* Upgraded the library to be in `kotlin` dependencies.
* Update `FastAdapter` to v4 - If you use this library too, please check out
  the [migration guide](https://github.com/mikepenz/FastAdapter/blob/develop/MIGRATION.md)
* Update `Android-Iconics` to v4 - If you use this library too, please check out
  the [migration guide](https://github.com/mikepenz/Android-Iconics/blob/develop/MIGRATION.md)

#### v6.2.x

* Upgraded the library to use `androidX` dependencies. This means your project will need to depend
  on `androidX` dependencies too. If you still use appcompat please consider using a version older
  than v6.2.x.
* Further details about migrating to androidX and a overview can be found on the official
  docs. https://developer.android.com/topic/libraries/support-library/refactor

#### v6.0.0

**IMPORTANT IF YOU USE THE FASTADAPTER OR MATERIALDRAWER**

* You have to update your FastAdapter dependency to v3.0.0 with this release
* See the MIGRATION information of the
  FastAdapter https://github.com/mikepenz/FastAdapter/blob/develop/MIGRATION.md

#### v5.9.7

**IMPORTANT IF YOU USE THE Android-Iconics**

* You have to update your Android-Iconics dependency to v2.9.0 with this release
* See the MIGRATION information of the
  Android-Iconics https://github.com/mikepenz/Android-Iconics/blob/develop/MIGRATION.md#290

#### v5.9.5

**IMPORTANT IF YOU USE THE FASTADAPTER OR MATERIALDRAWER**

* You have to update your FastAdapter dependency to v2.5.0 with this release
* See the MIGRATION information of the
  FastAdapter https://github.com/mikepenz/FastAdapter/blob/develop/MIGRATION.md

#### v5.9.0

**IMPORTANT IF YOU USE THE FASTADAPTER OR MATERIALDRAWER**

* You have to update your FastAdapter dependency to v2.1.0 with this release
* See the MIGRATION information of the
  FastAdapter https://github.com/mikepenz/FastAdapter/blob/develop/MIGRATION.md

#### v5.8.5

**IMPORTANT IF YOU USE THE FASTADAPTER**

* You have to update your FastAdapter dependency to v2.0.0 with this release
* See the MIGRATION information of the
  FastAdapter https://github.com/mikepenz/FastAdapter/blob/develop/MIGRATION.md

#### v5.8.1

**IMPORTANT IF YOU USE THE FASTADAPTER**

* This release brings a breaking interface change. Your items now have to implement
  `bindView(ViewHolder holder, List payloads)` instead of `bindView(VH holder)`.
* The additional payload can be used to implement a more performant view updating when only parts of
  the item have changed. Please also refer to the `DiffUtils` which may provide the payload.

#### v5.8.0

* **Dropping support for API < 14. New MinSdkVersion is 14**

#### v5.6.1 -> v5.6.2

* Change `void onLibTaskFinished()` to `void onLibTaskFinished(FastItemAdapter fastItemAdapter)`

#### v5.3.0 -> v5.3.1

* renamed `withAnimations()` to `withSlideInAnimation()` and change the default to `false`
* now use the `DefaultItemAnimator` to animate the displaying of the elements
* you can now define a different `ItemAnimator` via
  `LibsConfiguration.getInstance().setItemAnimator()`

#### v5.2.6 -> v5.3.0

* change `.fragment()` to `.supportFragment()` and `LibsFragment` to `LibsSupportFragment`

**INFO**

* moved logic of the fragment to the new `LibsFragmentCompat` class
* create new `LibsSupportFragment` which extends the `android.support.v4.app.Fragment`
* change the `LibsFragment` which now extends the `android.app.Fragment`
* add new method `.supportFragment()` which returns `android.support.v4.app.Fragment`
* change `.fragment()` which now returns `android.app.Fragment`