Showkase icon indicating copy to clipboard operation
Showkase copied to clipboard

showkaseName for composable is unstable when referencing custom multipreview annotation from another module

Open vincent-paing opened this issue 3 months ago • 1 comments

When I was looking into why the paparazzi snapshot keep generating a new golden images for existing components whenever I add a new component, I found out that it may be because of the name generation although I'm not really quite sure exactly if it's related yet. When a composable has a custom multipreview annotation from another module ,every time you add a composable to that module, the name will be generated with different integer in it.

To demonstrate, follow these steps:

  1. Create a module, we call this rootModule, since this is where ShowKaseRoot will live. Setup ShowKase here
  2. In this Module, create a composable, ComposableB
@Composable
fun ComposableB() { /*...*/ }
  1. Create an Android library module, for future reference, we call this lib and setup ShowKase there
  2. Create a custom multipreview annotation in the lib module
@Preview(group = "Large", fontScale = 2.0f, showBackground = true)
@Preview(group = "XLarge", fontScale = 3.0f, showBackground = true)
@Preview(group = "Small", fontScale = 0.1f, showBackground = true)
annotation class PreviewGroupFromAnotherModule
  1. Add a preview for ComposableB back in rootModule with this annotation
@PreviewGroupFromAnotherModule
@Composable
fun ComposableBPreview() {
 ComposableB()
}
  1. Rebuild project and check the code generated and we see this for showkase metadata
@ShowkaseCodegenMetadata(
    showkaseName = "ComposableBPreview -  - 0",
    ...
)
  1. Create another Composable in rootModule and preview with same preview group
@Composable
fun ComposableA() { /*...*/ }

@PreviewGroupFromAnotherModule
@Composable
fun ComposableAPreview() {
 ComposableA()
}
  1. Rebuild the project and observe that the name for ComposableBPreview has now changed from previously 0 to now 1
@ShowkaseCodegenMetadata(
    showkaseName = "ComposableAPreview -  - 0",
    //...
)
//...
@ShowkaseCodegenMetadata(
    showkaseName = "ComposableBPreview -  - 1",
    //...
)

I don't observe this problem when using Preview or when the custom multipreview annotation is from same module. This only happens when referencing the one from another module. And this integer shift only affects previews that are lower in term of alphabetical order than the new one. In above example, B used to be 1. Then adding A shift B to 1. Adding ComposableC would not affect ComposableB

This impact us greatly because we have a common multipreview annotations in our core module referenced by different feature module. Every time we add a new composable, all of our snapshots are regenerated and we can't rely anything from snapshot test because of this bug. It also would not make sense to have the same preview groups across all features for us that would be a lot harder to maintain.

I have a made a repo here to test out easily

vincent-paing avatar Apr 03 '24 14:04 vincent-paing