Releases: Splitties/refreshVersions
0.11.0
Version 0.11.0 (2021-08-03)
New feature
Add task refreshVersionsMigrate that adds all missing entries in versions.properties and try to migrate the build.gradle(.kts)
and other known files like libraries.gradle
so that the version placeholder _
is used everywhere. Please try it out and give us your feedback for refreshVersionsMigrate
Fixes
- Plugins org.jetbrains.kotlinx.benchmark should not use key version.kotlin
New dependency notations
- Ktor.features.serialization
- AndroidX.navigation.testing
- Testing.kotestExtensions who replaces Testing.kotest.extensions in Kotest >= 4.5.0
0.10.1
Version 0.10.1 (2021-06-10)
New features
- In Android projects, if you used the version placeholder (
_
) directly inbuild.gradle(.kts)
files, Android lint would trigger an unwanted warning, or error in the case of the Android build tools (aka. AGP, the Android Gradle Plugin). To avoid this inconvenience, running the refreshVersions task will now automatically check if it's running on an Android project, and in such cases, will edit (safely) thelint.xml
file, creating it if needed, and add the needed rules to have these specific warnings and errors ignored.
Fixes
- Add missing version placeholder (
_
) for theGoogle.android.material.composeThemeAdapter
dependency notation. - Fix a bug that prevented from using the correct version of
org.jetbrains.kotlinx.benchmark
and any other Gradle plugin with an id starting withorg.jetbrains.kotlinx
because it matched overorg.jetbrains.kotlin
as well. We are now matching onorg.jetbrains.kotlin.
to avoid this issue.
New dependency notations:
- AndroidX:
- emoji2
- views-helper
- views
- health.servicesClient
- security.appAuthenticatorTesting
- emoji2
- Google.accompanist.insets.ui
0.10.0
Version 0.10.0 (2021-05-13)
New features
- There's a new
versionFor
function that takes a dependency notation, or a version key, and returns the corresponding version that is in theversions.properties
file. For example, if you use Jetpack Compose, you can leverage it to setkotlinCompilerExtensionVersion
withversionFor(AndroidX.compose.ui)
. Groovy DSL users can find it in theVersions
class. - Support updates of settings plugins in
settings.gradle.kts
andsettings.gradle
files (including refreshVersions itself). - Support getting versions from Google Cloud Storage backed repositories. This can be helpful if you need to update private artifacts hosted there. Thanks to NikkyAI for the contribution!
Changes
- Setting up refreshVersions has been significantly simplified: Now, it's simply a plugin that must be applied in the
settings.gradle.kts
orsettings.gradle
file. Note that if you want to apply it tobuildSrc
as well, there's a gotcha regarding defining the version. The best thing is that on upgrade, refreshVersions will automatically replace the old & verbose bootstrap with the new plugin setup, and that works for buildSrc special case as well. We made many tests to ensure that this logic is reliable, doesn't break any code, doesn't remove important comments, and doesn't affect custom configuration in any way. - Bintray sunset resiliency: If refreshVersions encounters an HTTP 403 response on a bintray repository or on jcenter, it will consider the artifact to not be in this repository instead of crashing (but you can/should still remove bintray repo declarations anyway since it has been sunset).
- Missing short version key rules have been added for many dependency notations groups in the
Testing
object, and forOrchid
.
Potentially breaking changes
- The fix of the
Square.sqlDelight.coroutinesExtensions
dependency notation can lead to such an error:Failed to resolve: coroutines-extensions-1.4.4-_
. If you get a similar error on upgrade, it's because you applied a fix like that one:Square.sqlDelight.coroutinesExtensions + ":_"
. You now can (must) remove it. - A bunch of new version key rules have been added, which means you might have changes of version keys, and because we currently don't have a migration facility for those, it might cause unwanted upgrades. Consequently, especially for Android projects, we recommend checking/verifying the changes made by refreshVersions after the first Gradle sync/reload/build that follows the upgrade.
Fixes
- Authentication for maven repositories should now work correctly. Should, because it can only work using internal Gradle APIs for the time being (though there's a safeguard to not crash if the API changes). Thanks to Mayank Kharbanda for the PR!
- Custom
extraArtifactVersionKeyRules
could not be taken into account if there was an overlapping rule already present in refreshVersions, even if it was more specific. That ordering issue has now been fixed, the most specific rule will now always be the one applied. - If you had issues with some recent AndroidX artifacts, and their version key, they should all be fixed now, and there's all the latest dependency notations.
New dependency notations
- AndroidX:
- activity.ktx
- activity.compose
- appSearch
- appSearch.compiler
- appSearch.localStorage
- biometricKtx
- carApp
- carApp.testing
- compose:
- material.ripple
- runtime.rxJava3
- runtime.saveable
- ui:
- test
- testJunit4
- testManifest
- tooling
- toolingData
- viewBinding
- constraintLayoutCompose
- core.googleShortcuts
- dataStore:
- core
- rxJava2
- rxJava3
- preferences:
- core
- rxJava2
- rxJava3
- hilt.navigationCompose
- hilt.navigationFragment
- leanback.paging
- leanback.preference
- leanback.tab
- lifecycle.viewModelCompose
- navigation.compose
- navigation.dynamicFeaturesFragment
- paging.compose
- paging.rxJava3
- savedStateKtx
- security.appAuthenticator
- transitionKtx
- wear:
- complications.data
- complications.provider
- input
- inputTesting
- ongoing
- phoneInteractions
- remoteInteractions
- watchFace
- watchFace.guava
- watchFace.client
- watchFace.clientGuava
- watchFace.complicationsRendering
- watchFace.data
- watchFace.editor
- watchFace.editorGuava
- watchFace.style
- tiles:
- proto
- renderer
- work.multiprocess
- work.rxJava3
- Firebase:
- analyticsKtx
- authenticationKtx
- cloudMessagingKtx
- crashlyticsKtx
- dynamicLinksKtx
- performanceMonitoringKtx
- Google:
- accompanist:
- appcompatTheme
- coil
- flowlayout
- glide
- imageloadingCore
- insets
- pager.indicators
- pager
- swiperefresh
- systemuicontroller
- android.material.composeThemeAdapter
- dagger.hilt.compiler
- accompanist:
- Testing.kotest.assertions.kotlinxDateTime
Special mentions
Thanks to all the folks that joined Louis CAD in pair-programming sessions:
- Waqas Ahmed
- Benjamin Orsini
- Zahra Heydari
- Alexi Bre
- …and of course the original author and maintainer Jean-Michel Fayard
These were critical to ensure thorough testing, and great quality, all while keeping motivation to keep going.
We're very grateful for your time and help, and we think our users will be as well. 🙏
Also, thanks to all the folks that reported issues. It was very helpful to prioritize on our side.
refreshVersions 0.9.7
Version 0.9.7 (2020-10-16)
Fixes
- Running the
refreshVersions
task twice or more would fail with "executor rejected" as an error message, until the Gradle daemon is killed. This has now been fixed. (Issue #263) - The
refreshVersions
task was failing after the latest Gradle release candidate was superseded by the stable release because the API would return an empty JSON object after this, which we didn't expect. - (Minor) We fixed a typo in a diagnostic task name (
refreshVersionsDependenciesMapping
)
refreshVersions 0.9.6
Version 0.9.6 (2020-10-12)
Fixes
- This release fixes a major memory leak that would make Gradle Daemons unusable after several builds (or Gradle syncs/imports). We are very sorry for that issue, and the annoyance it might have caused. We experienced it too as users, and that's why we are bringing the fix now. We took the necessary measures to avoid future recurrence of such memory leaks.
- Fix of a bug that'd make the first Gradle sync after adding a dependency fail.
Breaking change
- If you were using Jetpack Compose, the compiler dependency had its maven coordinates changed in version 1.0.0-alpha04. We updated the
AndroidX.compose.compiler
dependency constant, which means it now works only for Compose 1.0.0-alpha04 and more future versions.
New dependency constants
- Google.android.playServices.mlKit
- Google.mlKit
- KotlinX.serialization.json
Deprecated
Firebase ML Kit has been rebranded to Google ML Kit along with API and feature changes since 2020-08-14 update, so we deprecated the Firebase.mlKit
dependencies and introduced new ones in Google.android.playServices.mlKit
and Google.mlKit
.
New features
- refreshVersions will now warn you when Gradle is not up to date, and will give you the commands to run to update it for you to copy/paste and run. It works if you're using a release candidate, and also if you're using a nightly version!
refreshVersions 0.9.5
Version 0.9.5 (2020-08-21)
This is a major release that brings surface-level and internal changes, paving the way for the upcoming 1.0 release.
The plugin setup/bootstrap has changed, so check out the updated documentation in Setting-up.adoc.
New features
- Self update discovery. RefreshVersions will check for its own updates, and add available comments in the
settings.gradle[.kts]
file if needed for easy upgrade. This allows you to get future improvements conveniently. - Support for
buildscript
dependencies. It now works just like regular dependencies. - First class support for
buildSrc
- Support maven repositories with basic authentication (aka. credentials with username and password)
- Going forward, refreshVersions will be able to auto-migrate any breaking changes a new version would introduce in your
versions.properties
,build.gradle
andbuild.gradle.kts
files in. This version of refreshVersions integrates the facility to
let future versions of refreshVersions that migration is needed, and from which version. This is a very important change that ensures you can keep your projects updated with the least effort possible.
New dependency constants
- Kotlin.stdlib (for the base version of the stdlib)
- KotlinX:
- html
- Coroutines:
- reactive
- reactor
- rx2
- rx3
- Serialization:
- core (replaces runtime artifacts since 1.0.0-RC)
- protobuf
- cbor
- properties
- io
- reflect.lite
- nodeJs
- COIL, a Coroutine Image Loader for Android.
- Square:
- LeakCanary
- KotlinPoet
- Wire
- SqlDelight
- Moshi
- Picasso
- okio
- Retrofit2:
- Adapter:
- java8 (renamed from retrofitJava8)
- rxJava1 (renamed from retrofitRxJava1)
- rxJava2 (renamed from retrofitRxJava2)
- rxJava3
- Adapter:
- KoTest (in the
Testing
object) - CashApp:
- sqlDelight (alias to Square.sqlDelight)
- turbine
- Copper
- Google:
- Dagger (including hilt for Android)
- Android:
- browserHelper
- JakeWharton:
- picnic
- wormholeGradlePlugin
- confundusGradlePlugin
- moshi.shimo
- AndroidX:
- Gaming
- Hilt
- startup
- tracing
- vectorDrawableSeekable
- Window
- Core:
- animation
- animationTesting
- Security:
- cryptoKtx
- identityCredential
- Compose:
- Runtime:
- dispatch
- savedInstance
- liveData
- rxJava2
- Animation
- Ui
- Foundation
- Material
- Runtime:
- Media2:
- lifecycle
- Concurrent:
- futuresKtx
Dependency constants renamed
Several dependencies constants have been renamed in this release (compared to version 0.9.4).
If you were using one of the following, you'll need to migrate these usages.
We recommend to use "Replace in Path" in IntelliJ or Android Studio, filtering for the *.gradle.kts
or *.gradle
file extensions to do these replacements with ease.
Note that for future versions, refreshVersions will be able to do this automatically.
Here's the list of renamed dependency constants:
AndroidX.coreKtx
->AndroidX.core.ktx
AndroidX.coreRole
->AndroidX.core.role
Square.retrofit2.adapter.retrofitJava8
->Square.retrofit2.adapter.java8
Square.retrofit2.adapter.retrofitRxJava1
->Square.retrofit2.adapter.rxJava1
Square.retrofit2.adapter.retrofitRxJava2
->Square.retrofit2.adapter.rxJava2
Testing.junit.junitJupiter
->Testing.junit
Testing.mockK.mockK
->Testing.mockK
Changes
- Make the
refreshVersions
task cancellable during network requests. - Now, only http 404 and 401 responses from repositories will be silent.
- Server errors (i.e. all but http 404 and 401 responses) are now reported.
- Network failures are now reported.
- There is now a connection timeout (10 seconds per request for now)
- An error is reported if a dependency wasn't found in any of the configured repositories.
- All the searched repositories are now listed if a dependency wasn't found in any of them.
- Only declared repositories are now looked up. (Before, refreshVersions would search all dependencies in all repositories of all modules and their buildscript, regardless of which module was declaring them.)
- Dependency constants in
Ktor
no longer uses thenative
suffixed artifacts (because Kotlin 1.4 drops them, as the main ones become multiplatform)
Fixes
- Version sorting would crash if a version had a long number in it. This has now been fixed, any length of digit sequence is now supported in versions.
- Fix maven coordinates of several dependency constants
- Don't crash on repositories that are not https or file or have non password credentials.
- The
AndroidX.test.ext.jankTestHelper
constant and few other ones inFirebase.mlKit
had wrong maven coordinates. This has been fixed, and tests have been added to prevent it from happening again on any dependency constant we provide.
v0.8.3
v0.8.2
The long-term plan for v1.0 is to focus on :refreshVersions
instead of :buildSrcVersions
See #104
Starting from release 0.8.0 the plugin is now called and contain only the task refreshVersions
plugins {
id("de.fayard.refreshVersions").version("0.8.x") // or newer
}
We are not quite ready yet to extract the useful parts of buildSrcVersions
to another plugin,
so if you need the features from buildSrcVersions, stay with this for now:
plugins {
id("de.fayard.buildSrcVersions").version("0.7.0")
}
v0.7.0
The plugin will in the future focus on :refreshVersions
.
For now it is published under two names, with an identical content:
plugins {
id("de.fayard.refreshVersions").version("0.7.0")
// or
id("de.fayard.buildSrcVersions).version("0.7.0")
}
Next step: integration with https://github.com/LouisCAD/Splitties
See #104
Changes: