برنامه نویسی اندروید با زبان کاتلین

uiState = uiState.copy(
    showSnackBar = true
)

class Kotlin {
    fun kotlinMag() = println("Kotlin Mag!")
}

fun channelSuggestion(subject: Any) {
// شرط را در یک متغیر ذخیره می‌کنیم
    val isKotlin = subject is Kotlin

    if (isKotlin) {
// ❌ در کاتلین 1.9: ارور کامپایل می‌داد و نیاز به کست دستی داشت
// ✅ در کاتلین 2.0: کامپایلر هوشمندانه می‌فهمد subject یک Kotlin است!
        subject.kotlinMag()
    }
}

@Immutable
data class UserListState(
    val users: List<User>
)

val users = remember {
    listOf(
        User(1, "Ali", listOf("Coding")),
        User(2, "Sara", listOf("Design"))
    )
}

val premiumUsers by remember {
    derivedStateOf {
        users.filter { it.isPremium }
    }
}

data class User(
    val id: Int,
    val name: String,
    val hobbies: List<String> // مشکل اینجاست!
)

@Composable
fun UserScreen() {
    // در هر بار Recomposition یک لیست کاملاً جدید ساخته می‌شود!
    val users = listOf(
        User(1, "Ali", listOf("Coding")),
        User(2, "Sara", listOf("Design"))
    )

    UserList(users) // این کامپوننت مدام بی‌دلیل اجرا می‌شود
}

PredictiveBackHandler(enabled = true) { progressFlow ->
    try {
        progressFlow.collect { backEvent ->
            val progress = backEvent.progress
            // اعمال تغییرات بصری دلخواه روی المان‌های صفحه
        }
        // حرکت کامل شد؛ حالا به صورت دستی برمی‌گردیم
        navController.popBackStack()
    } catch (e: CancellationException) {
        // کاربر پشیمان شد؛ UI را به حالت اول برگردانید
    }
}

NavHost(
    navController = navController,
    startDestination = HomeRoute,
    popExitTransition = {
        slideOutHorizontally(targetOffsetX = { it }) + fadeOut()
    }
) {
    // تعریف مقصدها...
}

<application
    ...
    android:enableOnBackInvokedCallback="true">
    
    <activity ... />
</application>

// ۱. ابتدا مقصدها را با کلاس‌های Serializable تعریف کنید
@Serializable
object HomeRoute

@Serializable
data class ProfileRoute(val id: Int, val username: String)

// ۲. استفاده در NavHost
NavHost(navController, startDestination = HomeRoute) {
    
    composable<HomeRoute> {
        HomeScreen(onUserClick = { 
            // ارسال دیتا به صورت یک شیء کلاس
            navController.navigate(ProfileRoute(id = 1, username = "KotlinMag")) 
        })
    }

    composable<ProfileRoute> { backStackEntry ->
        // دریافت دیتا به صورت Type-safe بدون نیاز به کلیدهای رشته‌ای
        val profile = backStackEntry.toRoute<ProfileRoute>()
        ProfileScreen(profile.id, profile.username)
    }
}

// ۱. تعریف در NavHost
composable(
    route = "profile/{userId}",
    arguments = listOf(navArgument("userId") { type = NavType.StringType })
) { backStackEntry ->
    val userId = backStackEntry.arguments?.getString("userId")
    ProfileScreen(userId)
}

// ۲. نحوه فراخوانی و ارسال
navController.navigate("profile/user_123")

@Composable
fun AppNavigation() {
    val navController = rememberNavController()

    NavHost(navController = navController, startDestination = "home") {
        composable("home") { 
            HomeScreen(onNavigateToDetails = { navController.navigate("details") }) 
        }
        composable("details") { 
            DetailsScreen() 
        }
    }
}

sealed interface Action
sealed interface AnalyticsEvent

// یک سنگ و دو نشان: این کلاس هم یک Action است و هم یک Event برای آنالیتیکس
data class OnLoginClicked(val userId: String) : Action, AnalyticsEvent

fun handleAction(action: Action) {
    when (action) {
        is OnLoginClicked -> { /* مدیریت لاگین */ }
        // کامپایلر با دقت تمام حالت‌ها را چک می‌کند
    }
}

sealed interface NetworkResponse

data class Success(val data: String) : NetworkResponse
data class Error(val message: String) : NetworkResponse
object Loading : NetworkResponse

// ۱. تابعی برای مخفی کردن ویو در اندروید
fun View.hide() {
    this.visibility = View.GONE
}

// ۲. تابعی برای بررسی معتبر بودن ایمیل
fun String.isValidEmail(): Boolean {
    return android.util.Patterns.EMAIL_ADDRESS.matcher(this).matches()
}

// نحوه استفاده در پروژه:
val userEmail = "[email protected]"

if (userEmail.isValidEmail()) {
    // انجام عملیات
    loginButton.hide() // استفاده بسیار تمیز و راحت
}