Releases: cashapp/molecule
2.1.0
New:
- Add
SnapshotNotifierenum to control whether Molecule automatically sends snapshot apply notifications.
If you are using Molecule with another Compose-based library in a single application, you may want to disable our snapshot notification.
See the enum for details on when that is appropriate.
Additionally, theapp.cash.molecule.snapshotNotifiersystem property can be set to one of the enum entry names to control the default process-wide.
Changed:
- Any specified additional coroutine context elements will now be honored in the coroutine used internally with
RecompositionMode.Immediateto send frames and cause recomposition to occur. This is observable, most notably, when aCoroutineDispatcheris included, as now recompositions which occur after the first, synchronous one will occur on that dispatcher.
Fixed:
- Correct calculation of frame nano time for native Windows and native Linux targets.
2.0.0
New:
- Support for Kotlin 2.0.0!
Changed:
- Remove our Gradle plugin in favor of JetBrains' (see below for more).
Fixed:
- Mac OS
DisplayLinkClockwas updated to correctly use a "static" function for pointer-passing toCVDisplayLink, as newly-enforced by Kotlin 2.0. This should not cause a behavior change.
Note: This release is otherwise binary-compatible with the 1.x versions. The major version bump is due to the build change only.
Gradle plugin removed
This version of Molecule removes the custom Gradle plugin in favor of the official JetBrains Compose compiler plugin which ships as part of Kotlin itself.
Each module in which you had previously applied the app.cash.molecule plugin should be changed to apply org.jetbrains.kotlin.plugin.compose instead.
The Molecule runtime will no longer be added as a result of the plugin change, and so any module which references Molecule APIs like launchMolecule should apply the app.cash.molecule:molecule-runtime dependency.
For posterity, the Kotlin version compatibility table and compiler version customization for our old Molecule Gradle plugin will be archived here:
Molecule 1.x Gradle plugin Kotlin compatibility table
Since Kotlin compiler plugins are an unstable API, certain versions of Molecule only work with
certain versions of Kotlin.
| Kotlin | Molecule |
|---|---|
| 1.9.24 | 1.4.3 |
| 1.9.23 | 1.4.2 |
| 1.9.22 | 1.3.2 - 1.4.1 |
| 1.9.21 | 1.3.1 |
| 1.9.20 | 1.3.0 |
| 1.9.10 | 1.2.1 |
| 1.9.0 | 1.1.0 - 1.2.0 |
| 1.8.22 | 0.11.0 - 1.0.0 |
| 1.8.21 | 0.10.0 |
| 1.8.20 | 0.9.0 |
| 1.8.10 | 0.8.0 |
| 1.8.0 | 0.7.0 - 0.7.1 |
| 1.7.20 | 0.6.0 - 0.6.1 |
| 1.7.10 | 0.4.0 - 0.5.0 |
| 1.7.0 | 0.3.0 - 0.3.1 |
| 1.6.10 | 0.2.0 |
| 1.5.31 | 0.1.0 |
Molecule 1.x Gradle plugin Compose compiler customization instructions
Each version of Molecule ships with a specific JetBrains Compose compiler version which works with
a single version of Kotlin (see version table above). Newer versions of the Compose
compiler or alternate Compose compilers can be specified using the Gradle extension.
To use a new version of the JetBrains Compose compiler version:
molecule {
kotlinCompilerPlugin.set("1.4.8")
}To use an alternate Compose compiler dependency:
molecule {
kotlinCompilerPlugin.set("com.example:custom-compose-compiler:1.0.0")
}1.4.3
New:
- Support for Kotlin 1.9.24
This version works with Kotlin 1.9.24 by default.
1.4.2
New:
- Support for Kotlin 1.9.23
Changed:
- Disable klib signature clash checks for JS compilations. These occasionally occur as a result of Compose compiler behavior, and are safe to disable (the first-party JetBrains Compose Gradle plugin also disables them).
This version works with Kotlin 1.9.23 by default.
1.4.1
New:
- Support for
linuxArm64andwasmJstargets.
1.4.0
Changed:
- Disable decoy generation for JS target to make compatible with JetBrains Compose 1.6. This is an ABI-breaking change, so all Compose-based libraries targeting JS will also need to have been recompiled.
This version works with Kotlin 1.9.22 by default.
1.3.2
New:
- Support for Kotlin 1.9.22
This version works with Kotlin 1.9.22 by default.
1.3.1
New:
- Support for Kotlin 1.9.21
This version works with Kotlin 1.9.21 by default.
1.3.0
New:
- Add
CoroutineContextparameter tolaunchMoleculeto contribute elements to the combined context that is used for running Compose. - Support for Kotlin 1.9.20
Changed:
- Removed now-unsupported
watchosX86target.
This version works with Kotlin 1.9.20 by default.
1.2.1
New:
- Support for Kotlin 1.9.10
- Switch to JetBrains Compose compiler 1.5.2 (based on AndroidX Compose compiler 1.5.3)
This version works with Kotlin 1.9.10 by default.