Hi all! It seems like material3-compose went to stable (latest version is 1.0.1) But there are still...

# compose

[Anton Afanasev]

Hi all!
It seems like material3-compose went to stable (latest version is 1.0.1) But there are still stuff annotated with ExperimentalMaterial3Api like Scaffold, which makes it a little bit confusing. Is it safe to use Experimental api in prod? Are there going to be breaking changes for that api?

[Filip Wiesner]

Is it safe to use Experimental api in prod

Should be, yes

Are there going to be breaking changes for that api?

Probably also yes. That's the point of experimental annotation

[Anton Afanasev]

Usually, I would expect from production ready api's not to have an "experimental" annotations...

[Filip Wiesner]

"production ready" could mean something else for different people. Some people consider API to be production ready only after it's been out for several years 🙂
Read the Android/Kotlin experimental annotations as "_Possibility of API change until stable_". It does not have other meaning as far as I know.

[Anton Afanasev]

https://kotlinlang.org/docs/opt-in-requirements.html#opt-in-requirements-for-pre-stable-apis

"Once your pre-stable API graduates and is released in a stable state, remove its opt-in requirement annotations from declarations."
Based on Kotlin requirements to OptIn the experimental should be removed if version is stable.

[Filip Wiesner]

Not if version is stable but if the API is stable.

[Anton Afanasev]

Lol...is not it the same?

[Filip Wiesner]

Depends on the context. By API you could mean the "whole API surface of a library" or "API of some class" or "API of package" or just API of some functionality that spans across several files/packages

[Filip Wiesner]

Relevant thread: https://kotlinlang.slack.com/archives/CJLTWPH7S/p1644326373737959

[Anton Afanasev]

Thanks @Filip Wiesner

[dewildte]

Version can be stable as in it has been sufficiently tested to the point of not having any
glaring bugs or runtime stability issues.

API, as in the naming/architectural implementation is still up for debate and subject to possible change.

The car runs and the engine is stable, but the doors might change to gull wing as opposed to classical or the media interface might change.

[dewildte]

@Anton Afanasev ☝️