Releases: cashapp/redwood
0.6.0
New:
-
Support for specifying custom Compose compiler versions. This will allow you to use the latest
version of Redwood with newer versions of Kotlin than it explicitly supports.See the README for more information.
-
LazyList
can now be programmatically scrolled through itsScrollItemIndex
parameter. -
Pull-to-refresh indicator color on
LazyList
is now customizable through
pullRefreshContentColor
parameter.
Changes:
- Many public types have been migrated away from
data class
to regular classes with
equals
/hashCode
/toString()
. If you were relying on destructuring orcopy()
for these
types you will need to migrate to doing this manually.
Fix:
- The emoji search browser sample no longer crashes on first load.
- Lots of rendering and performance fixes for UIKit version of
LazyList
- Only measure items which are visible in the active viewport.
- Remove some default item spacing imposed by the backing
UICollectionViewFlowLayout
. - Share most of the internal bookkeeping logic with the Android implementations for consistency
and correctness. - Placeholders are now correctly sized along the main axis.
This version works with Kotlin 1.9.0 by default.
0.5.0
This release marks Redwood's "beta" period which provides slightly more stability guarantees than
before. All future releases up to (but NOT including) 1.0 will have protocol and service
compatibility with older versions. In practice, what this means is that you can use Redwood 0.6
(and beyond) to compile and deploy Treehouse guest code which will run inside a Treehouse host
from Redwood 0.5.
Redwood still reserves the right to make binary- and source-incompatible changes within the host
code or within the guest code.
New:
- The relevant tags and names from your schema will now automatically be tracked in an API file and
changes will be validated to be backwards-compatible. TheredwoodApiGenerate
Gradle task will
generate or update the file, and theredwoodApiCheck
task will validate the current schema as
part of thecheck
lifecycle task. width
,height
, andsize
modifiers allow precise control over widget size within
Redwood layout.- Preliminary support for
rememberSaveable
within Treehouse guest code with persistence only
available on Android hosts.
Changes:
- The flexbox implementation has changed from being a Kotlin port of the Google's Java flexbox
layout to using Facebook's Yoga library. LazyList
now has arguments formargin
and cross-axis alignment
(verticalAlignment
forLazyRow
,horizontalAlignment
forLazyColumn
)- Remove the ability to use custom implementations of
LazyList
. Any missing functionality from
the built-in versions should be filed as a feature request. - The command-line tools (codegen, lint, schema) are now uploaded to Maven Central as standalone
zip files in addition to each regular jar artifact for use with non-Gradle build systems.
Fixed:
- RTL layout direction is now supported by the Compose UI and View-based implementations of
Redwood layout.
This version only works with Kotlin 1.8.22.
0.4.0
New:
- Experimental support for refresh indicators on
LazyRow
andLazyColumn
viarefreshing
boolean
andonRefresh
lambda. These are experimental because we expect refresh support to migrate to
some kind of future support for widget decorators so that it can be applied to any widget. DisplayLinkClock
is available for iOS and MacOS users of Redwood.
(Treehouse already had a frame clock for iOS).- A
WidgetValue
(orList<WidgetValue>
) produced from the generated testing function's
awaitSnapshot()
can now be converted to aSnapshotChangeList
which can be serialized to JSON.
That JSON can then later be deserialized and applied to aTreehouseView
to recreate a full view
hierarchy from any state. This is useful for unit testing widget implementations, screenshot
testing, and more. - Widget implementations can implement the
ChangeListener
interface to receive anonEndChanges()
callback which occurs after all property or event lambda changes in that batch. This can help
reduce thrashing in response to changes to multiple properties or event lambdas at once. LazyRow
andLazyColumn
now support aplaceholder
composable slot which will be used with
Treehouse when a new item is displayed but before its content has loaded. Additionally, the size
of these widgets can now be controlled throughwidth
andheight
constraints.
Changes:
-
LayoutModifier
has been renamed toModifier
. -
UI primitives like
Dp
,Density
, andMargin
have moved from Treehouse into the Redwood
runtime (in theapp.cash.redwood.ui
package). -
HostConfiguration
has moved from Treehouse into the Redwood runtime (in the
app.cash.redwood.ui
package) and is now calledUiConfiguration
. -
Composables running in Treehouse now run on a background thread on iOS. Previously they were
running on the main thread. Interactions with UIKit still occur on the main thread. -
RedwoodContent
function for hosting a Redwood composable within Compose UI has moved into a new
redwood-composeui
artifact as it will soon require a Compose UI dependency. -
The generated testing function now returns the value which was returned from the testing lambda.
Before:
suspend fun ExampleTester(body: suspend TestRedwoodComposition.() -> Unit)
Now:
suspend fun <R> ExampleTester(body: suspend TestRedwoodComposition.() -> R): R
-
The Redwood and Treehouse frame clocks now send actual values for the frame time instead of 0.
Fixed:
- Widgets which accept nullable lambdas for events now receive an initial
null
value when no
lambda is set. Previously anull
would only be seen after a non-null
lambda. - Reduce binary impact of each widget's composable function by eliminating a large error string
generated by the Kotlin compiler for an error case whose occurrence was impossible. - The iOS implementation of
Row
,Column
,Spacer
, andUIViewChildren
now react to size and
child view changes more accurately according to UIKit norms.
This version only works with Kotlin 1.8.20.
0.3.0
New:
- Support for testing Composables with new test-specific code generation. Use the
'app.cash.redwood.generator.testing' plugin to generate a lambda-accepting entrypoint function
(such asExampleTester()
). Inside the lambda you can await snapshots of the values which
would be bound to the UI widgets at that time. - Redwood Layout now contains a
Spacer
which can be used to create negative space separately
from padding (which otherwise disappears when the item disappears). - The host's safe area insets are now included in
HostConfiguration
. Note that these are global
values which should only be applied when a view is known to be occupying the full window size. - Use the host's native frame rate to trigger recomposition inside of Treehouse. Pending snapshot
changes are also required for recomposition to occur.
Changes:
- Widgets are now created, populated, and attached to the native view hierarchy in a different order
than before. Previously widget was created, attached to its parent, and then its properties were
all set followed by any language modifiers. Now, the widget is created, all of its properties and
layout modifiers are set, and then it is added to its parent. Additionally, widgets are added to
their parents in a bottom-up manner. Code likeRow { Column { Text } }
will seeText
be added
toColumn
beforeColumn
is added to `Row. - 'redwood-treehouse' module has been split into '-shared', '-guest', and '-host' modules to
more cleanly delineate where each is used. "Host" is the native application and "guess" is code
running inside the Zipline JS VM. - Schema dependencies are not longer parsed when loading a schema. Instead, a JSON representation
is loaded from the classpath which contains the parsed structure of the dependency. As a result,
the module which contains the schema files must apply the 'app.cash.redwood.schema' plugin in
order to create this JSON. - Redwood Layout's
Padding
type is now calledMargin
. - Both Redwood's own API as well as code generated from your schema is now annotated with
@ObjCName
to create better-looking APIs in Objective-C (and Swift). - The
@Deprecated
annotation on a widget or its properties will now propagate into the generated
Composable and widget interface. - Event types are no longer always nullable. They will now respect the nullability in the schema.
- Layout modifiers are now generated into a 'modifier' subpackage.
Fixed:
- Redwood Layout
Constraint
s are now correctly propagated into HTML.
This version only works with Kotlin 1.8.20.
0.2.1
Changed:
- Do not use a
ScrollView
/HorizontalScrollView
as the parent container for View-basedRow
and
Column
display when the container is not scrollable (the default). Use aFrameLayout
instead.
Fixed:
- Actually publish the
redwood-treehouse-composeui
artifact.
This version only works with Kotlin 1.7.20.
0.2.0
New:
redwood-layout-dom
module provides HTML implementations ofRow
andColumn
.- Lazy layout's schema artifacts are now published and can be used by other projects.
- Expose
concurrentDownloads
parameter forTreehouseApp.Factory
. The default is 8. - Add
moduleLoadStart
andmoduleLoadEnd
events to Treehouse'sEventListener
.
Changed:
- Compile with Android API 33.
- Counter sample now uses shared
Row
andColumn
layouts rather than its own unspecified one. - JSON serialization on the Compose-side of Treehouse is now faster and emits dramatically
less code than before. - Create a dedicated
CoroutineScope
for eachTreehouseView
. When a view leaves, its coroutines
can now be immediately canceled without waiting for anything on the application-side. TreehouseLauncher
is now calledTreehouseApp.Factory
. Additionally, when youcreate()
a
TreehouseApp
from a factory you must also callstart()
for it to actually start.- Use platform-specific collections types in JS for the Compose-side of Treehouse. This is faster,
more memory-efficient, and produces less code. - Update to Zipline 0.9.15.
Fixed:
- Do not expose Gradle
Configuration
s created by our plugin. This ensures they are not candidates
for downstream modules to match against when declaring a dependency on a project using the plugin. - Change when the Treehouse
FrameClock
is closed to avoid crashing on updates.
This version only works with Kotlin 1.7.20.
0.1.0
Initial release