Clarify deprecation message for materialIconsExtended#5520
Merged
MatkovIvan merged 1 commit intoJetBrains:masterfrom Jan 26, 2026
Merged
Conversation
The current deprecation message "Specify dependency directly" is misleading because it suggests a migration path that doesn't fully work - the material-icons-extended artifact is intentionally pinned to version 1.7.3 and newer versions aren't published. This change updates the message to: - Explain that the artifact is pinned and won't receive updates - Suggest either using version 1.7.3 explicitly or migrating to Material Symbols (vector resources) - Link to the relevant documentation
MatkovIvan
approved these changes
Jan 26, 2026
Member
|
Thanks! Notes:
|
MatkovIvan
pushed a commit
that referenced
this pull request
Jan 26, 2026
## Problem
When using `compose.materialIconsExtended` in Compose Multiplatform
1.10+, developers see the deprecation warning:
```
'val materialIconsExtended: String' is deprecated. Specify dependency directly.
```
This message is confusing because it implies you can simply switch to a
direct dependency like other Compose artifacts. However, unlike
`compose.runtime` or `compose.ui`, the `material-icons-extended`
artifact is **intentionally pinned to version 1.7.3** and newer versions
aren't published.
When developers try to follow the deprecation guidance by adding:
```kotlin
implementation("org.jetbrains.compose.material:material-icons-extended:1.10.0")
```
They get a dependency resolution failure because this artifact doesn't
exist at that version.
I ran into this while updating dependencies in a project and spent some
time investigating before discovering that the artifact was
intentionally discontinued after 1.7.3.
## Solution
This PR updates the deprecation message to be more helpful:
```kotlin
@deprecated(
"This artifact is pinned to version 1.7.3 and will not receive updates. " +
"Either use this version explicitly or migrate to Material Symbols (vector resources). " +
"See https://kotlinlang.org/docs/multiplatform/whats-new-compose-180.html",
replaceWith = ReplaceWith("\"org.jetbrains.compose.material:material-icons-extended:1.7.3\"")
)
```
The new message:
- Explains that the artifact is pinned and won't receive updates
- Offers two clear migration paths: use 1.7.3 explicitly, or migrate to
Material Symbols
- Links to the documentation that explains the change
## Context
- PR #5462 introduced the deprecation for all dependency aliases
- PRs #5151 and #5247 pinned the material-icons-extended version to
1.7.3
- The "What's new in 1.8" docs explain the removal but the deprecation
message doesn't connect the dots
## Testing
Built the gradle-plugins module locally and verified the deprecation
message appears correctly.
## Release Notes
### Highlights - Multiple Platforms
- Improved the deprecation message for `compose.materialIconsExtended`
to explain that the artifact is pinned to version 1.7.3 and suggest
migration to Material Symbols
Co-authored-by: Sergei Petunin <[email protected]>
MatkovIvan
changed the title
materialIconsExtended
Kpotko
added a commit
that referenced
this pull request
Jan 26, 2026
See #5520 for details Fixes [CMP-9684](https://youtrack.jetbrains.com/issue/CMP-9684) Clarify deprecation message for materialIconsExtended ## Release Notes ### Fixes - Multiple Platforms - Improved the deprecation message for `compose.materialIconsExtended` to explain that the artifact is pinned to version `1.7.3` and suggest migration to Material Symbols
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
When using
compose.materialIconsExtendedin Compose Multiplatform 1.10+, developers see the deprecation warning:This message is confusing because it implies you can simply switch to a direct dependency like other Compose artifacts. However, unlike
compose.runtimeorcompose.ui, thematerial-icons-extendedartifact is intentionally pinned to version 1.7.3 and newer versions aren't published.When developers try to follow the deprecation guidance by adding:
implementation("org.jetbrains.compose.material:material-icons-extended:1.10.0")They get a dependency resolution failure because this artifact doesn't exist at that version.
I ran into this while updating dependencies in a project and spent some time investigating before discovering that the artifact was intentionally discontinued after 1.7.3.
Solution
This PR updates the deprecation message to be more helpful:
@Deprecated( "This artifact is pinned to version 1.7.3 and will not receive updates. " + "Either use this version explicitly or migrate to Material Symbols (vector resources). " + "See https://kotlinlang.org/docs/multiplatform/whats-new-compose-180.html", replaceWith = ReplaceWith("\"org.jetbrains.compose.material:material-icons-extended:1.7.3\"") )The new message:
Context
material-icons-extendedversion #5151 and Update pinnedmaterial-icons-extendedto the latest version #5247 pinned the material-icons-extended version to 1.7.3Testing
Built the gradle-plugins module locally and verified the deprecation message appears correctly.
Release Notes
Fixes - Multiple Platforms
compose.materialIconsExtendedto explain that the artifact is pinned to version1.7.3and suggest migration to Material Symbols