چرخه عمر Composableها

@Composable
fun MoviesScreenLazy(movies: List<Movie>) {
    LazyColumn {
        items(movies, key = { movie -> movie.id }) { movie ->
            MovieOverview(movie)
        }
    }
}

رد شدن از اجرا اگر ورودی‌ها تغییر نکرده باشند

در طول Recomposition، بعضی توابع Composable واجد شرایط می‌توانند در صورتی که ورودی‌هایشان نسبت به Composition قبلی تغییر نکرده باشد، به‌طور کامل از اجرا شدن رد شوند.

یک تابع Composable واجد شرایط رد شدن است، مگر اینکه:

تابع مقدار بازگشتی غیر از Unit داشته باشد.

تابع با @NonRestartableComposable یا @NonSkippableComposable مشخص شده باشد.

یکی از پارامترهای الزامی آن از نوع غیر Stable باشد.

یک حالت آزمایشی کامپایلر به نام Strong Skipping وجود دارد که شرط آخر را ساده‌تر می‌کند.

برای اینکه یک نوع داده Stable در نظر گرفته شود، باید با قرارداد زیر مطابقت داشته باشد:

نتیجه equals برای دو نمونه مشخص همیشه برای همان دو نمونه یکسان باقی بماند.

اگر یکی از propertyهای public آن نوع تغییر کند، Composition از آن مطلع شود.

همه نوع‌های propertyهای public آن نیز Stable باشند.

چند نوع رایج مهم وجود دارند که در این قرارداد قرار می‌گیرند و کامپایلر Compose آن‌ها را Stable در نظر می‌گیرد، حتی اگر با annotation به نام @Stable به‌صورت صریح Stable مشخص نشده باشند:

همه نوع‌های primitive مانند Boolean، Int، Long، Float، Char و غیره

رشته‌ها یا String

همه نوع‌های تابعی یا lambdaها

همه این نوع‌ها می‌توانند قرارداد Stable را رعایت کنند، چون immutable هستند. از آنجایی که نوع‌های immutable هرگز تغییر نمی‌کنند، نیازی ندارند Composition را از تغییر مطلع کنند؛ بنابراین رعایت این قرارداد برای آن‌ها بسیار آسان‌تر است.

نکته: همه نوع‌هایی که به‌صورت عمیق immutable هستند، می‌توانند با خیال راحت Stable در نظر گرفته شوند.

یک نوع مهم که Stable است اما mutable محسوب می‌شود، نوع MutableState در Compose است. اگر مقداری داخل یک MutableState نگهداری شود، کل شیء State به‌عنوان Stable در نظر گرفته می‌شود، چون Compose از هر تغییری در property مربوط به .value در State مطلع خواهد شد.

وقتی همه نوع‌هایی که به‌عنوان پارامتر به یک Composable داده می‌شوند Stable باشند، مقدار پارامترها بر اساس موقعیت Composable در درخت UI با استفاده از equality مقایسه می‌شوند. اگر همه مقادیر نسبت به فراخوانی قبلی بدون تغییر باشند، Recomposition رد می‌شود.

نکته کلیدی: Compose اگر همه ورودی‌ها Stable باشند و تغییر نکرده باشند، Recomposition یک Composable را رد می‌کند. این مقایسه با استفاده از متد equals انجام می‌شود.

Compose فقط زمانی یک نوع را Stable در نظر می‌گیرد که بتواند آن را اثبات کند. برای مثال، یک interface معمولاً غیر Stable در نظر گرفته می‌شود. همچنین نوع‌هایی که propertyهای public قابل تغییر دارند، حتی اگر پیاده‌سازی آن‌ها بتواند immutable باشد، Stable محسوب نمی‌شوند.

اگر Compose نتواند تشخیص دهد که یک نوع Stable است، اما شما می‌خواهید Compose را مجبور کنید آن را Stable در نظر بگیرد، آن نوع را با annotation به نام @Stable مشخص کنید.

// Marking the type as stable to favor skipping and smart recompositions.
@Stable
interface UiState<T : Result<T>> {
    val value: T?
    val exception: Throwable?

    val hasError: Boolean
        get() = exception != null
}