Skip to content

MIGRATION.md

Latest commit

 

History

History
165 lines (117 loc) · 7.36 KB

MIGRATION.md

File metadata and controls

165 lines (117 loc) · 7.36 KB

Upgrade Notes

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
// 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

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

v12.x.y

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
  • Update Android-Iconics to v4 - If you use this library too, please check out the migration guide

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

v5.9.7

IMPORTANT IF YOU USE THE Android-Iconics

v5.9.5

IMPORTANT IF YOU USE THE FASTADAPTER OR MATERIALDRAWER

v5.9.0

IMPORTANT IF YOU USE THE FASTADAPTER OR MATERIALDRAWER

v5.8.5

IMPORTANT IF YOU USE THE FASTADAPTER

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