如何创建适配带小型副屏翻盖手机的Android虚拟设备(AVD)？

一、Android 15副屏支持特性 #

您的应用可以声明一个属性，Android 15会借助该属性允许您的Application或Activity在支持的折叠设备的小型副屏上显示。这类屏幕尺寸过小，原本不属于Android应用的兼容运行目标，但您的应用可选择加入支持，从而拓展应用的使用场景。

属性声明方式 #

在AndroidManifest.xml中添加如下配置：

<application>
    <property
        android:name="android.window.PROPERTY_ACTIVITY_EMBEDDING_ALLOW_SYSTEM_OVERRIDE"
        android:value="true|false"/>
</application>

二、创建支持副屏测试的垂直折叠设备AVD #

针对需要测试垂直折叠（如翻盖式带小型外屏）设备的需求，可按以下步骤创建可用的AVD：

1. 基于内置折叠模板修改配置 #

• 打开Android Studio的AVD Manager，点击Create Virtual Device
• 在设备列表的Foldables分类下选择任意折叠设备模板（如Pixel Fold），点击Next
• 选择Android 15及以上版本的系统镜像（API 35+，确保支持副屏特性），点击Next
• 进入Verify Configuration页面，点击Show Advanced Settings：
  • 在Display区域修改参数：
    • 将Fold orientation设置为Vertical（垂直折叠）
    • 设置Cover screen size为小屏尺寸（比如3.4英寸），对应分辨率设为720x1600（可按需调整）
    • 将Minimum width设为低于320dp（比如280dp，符合副屏非兼容尺寸要求）
  • 确认其他配置后，点击Finish完成创建

2. 导入第三方硬件配置文件（规避自定义重启问题） #

如果自定义模板出现无限重启，可使用成熟的第三方设备配置：

• 获取三星Galaxy Z Flip系列官方硬件配置文件（可通过Android Studio设备仓库搜索或官方开发者渠道下载）
• 将配置文件放入对应目录：
  • Windows：C:\Users\<用户名>\.android\avd\devices
  • Mac：~/.android/avd/devices
• 重启AVD Manager，即可在设备列表中找到对应垂直折叠设备，搭配Android 15镜像创建AVD

3. 排查AVD启动异常 #

若创建后出现无限重启，可通过以下方式调试：

• 确保使用Android 15官方稳定版镜像，避免预览版bug
• 检查Minimum width参数，建议设置在240dp-319dp之间
• 打开Logcat过滤AndroidRuntime标签，查看具体崩溃日志，针对性调整硬件参数

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