如何在Compose Multiplatform中检测Android和iOS设备为平板、iPad或手机

针对Compose Multiplatform项目中Android/iOS设备（手机、平板、iPad）的UI适配需求，以下是分平台的专属检测方案及适配实现：

一、核心思路 #

通过平台专属API判断设备类型，结合Compose布局特性（如WindowSizeClass）实现差异化UI。核心是用Kotlin的expect/actual机制封装跨平台设备检测逻辑，避免平台代码耦合。

二、跨平台设备检测实现 #

1. 定义通用检测接口（commonMain） #

在通用模块中声明预期函数，统一对外暴露检测能力：

object DeviceInfo {
    // 判断是否为平板（含Android平板、iPad）
    expect fun isTablet(): Boolean
    // 专门判断是否为iPad（iOS专属）
    expect fun isIPad(): Boolean
}

2. Android平台实现（androidMain） #

利用Android系统的smallestScreenWidthDp（官方推荐的平板判断标准，不受屏幕旋转影响）检测：

import android.content.Context
import androidx.compose.ui.platform.LocalContext

object DeviceInfo {
    actual fun isTablet(): Boolean {
        val context = LocalContext.current
        // 最小宽度≥600dp判定为平板
        return context.resources.configuration.smallestScreenWidthDp >= 600
    }

    actual fun isIPad(): Boolean = false // Android无iPad，直接返回false
}

3. iOS平台实现（iosMain） #

通过UIKit的UIDevice直接获取设备类型，无需计算尺寸：

import platform.UIKit.UIDevice
import platform.UIKit.UIUserInterfaceIdiomPad

object DeviceInfo {
    actual fun isTablet(): Boolean {
        return UIDevice.current.userInterfaceIdiom == UIUserInterfaceIdiomPad
    }

    actual fun isIPad(): Boolean {
        return UIDevice.current.userInterfaceIdiom == UIUserInterfaceIdiomPad
    }
}

三、UI适配实战 #

在Compose布局中根据设备类型分支处理，同时可结合WindowSizeClass优化横竖屏适配：

基础适配示例 #

@Composable
fun AdaptiveMainScreen() {
    val isTabletOrIPad = DeviceInfo.isTablet()

    if (isTabletOrIPad) {
        // 平板/iPad布局：侧边栏+主内容区
        Row(modifier = Modifier.fillMaxSize()) {
            Sidebar(modifier = Modifier.width(280.dp))
            MainContent(modifier = Modifier.weight(1f))
        }
    } else {
        // 手机布局：顶部导航+单列内容
        Column(modifier = Modifier.fillMaxSize()) {
            TopNavigationBar()
            MainContent(modifier = Modifier.weight(1f))
        }
    }
}

结合WindowSizeClass优化（应对平板竖屏场景） #

import androidx.compose.material3.windowsizeclass.calculateWindowSizeClass
import androidx.compose.material3.windowsizeclass.WindowWidthSizeClass

@Composable
fun AdaptiveMainScreen() {
    val context = LocalContext.current
    val windowSizeClass = calculateWindowSizeClass(context)
    val isTabletOrIPad = DeviceInfo.isTablet()
    // 平板横屏时用双列布局，竖屏切换为单列
    val useWideLayout = isTabletOrIPad && windowSizeClass.widthSizeClass >= WindowWidthSizeClass.Medium

    if (useWideLayout) {
        Row(modifier = Modifier.fillMaxSize()) {
            Sidebar(modifier = Modifier.width(280.dp))
            MainContent(modifier = Modifier.weight(1f))
        }
    } else {
        Column(modifier = Modifier.fillMaxSize()) {
            TopNavigationBar()
            MainContent(modifier = Modifier.weight(1f))
        }
    }
}

四、注意事项 #

• Android的smallestScreenWidthDp是系统提供的固定值，不会因屏幕旋转改变，比直接计算屏幕尺寸更可靠。
• iOS的userInterfaceIdiom直接由系统判定设备类型，避免了尺寸计算的误差。
• 若需更精细的适配（如折叠屏、大屏手机），可结合WindowSizeClass的Expanded/Medium/Compact分类进一步调整。

内容的提问来源于stack exchange，提问作者Murodjon Abdukholikov