SwiftUI应用启动图标真机显示超出屏幕适配求助

数据老陈

2026-6-24

解决SwiftUI应用启动图标（启动屏内）真机超出屏幕问题

针对你遇到的模拟器显示正常、iOS 17.4.1真机上启动图标超出屏幕的问题，按以下步骤排查解决：

一、调整启动屏布局约束（核心解决点）

如果是在SwiftUI启动屏（Launch Screen）中使用该图标，必须添加正确的缩放和布局限制，避免图标超出屏幕：

使用scaledToFit()保证图标按原比例缩放，不会拉伸变形
配合frame(maxWidth: .infinity, maxHeight: .infinity)让图标自适应父视图空间
添加padding限制图标与屏幕边缘的最小距离
示例代码：

Image("launchIcon")
    .resizable()
    .scaledToFit()
    .frame(maxWidth: .infinity, maxHeight: .infinity)
    .padding(20)

二、修正Assets图标集配置

不要仅添加单一大尺寸图标，需按iOS分辨率规范提供多版本图标：

为不同缩放级别准备对应尺寸：
- @1x：320px × 480px（可选，适配旧设备）
- @2x：640px × 960px
- @3x：960px × 1440px（接近你的1000×1500，可调整到该尺寸）
检查launchIcon.imageset内的Contents.json，确保每个图标对应正确的scale值，示例配置：

{
  "images": [
    {
      "filename": "launchIcon@1x.png",
      "idiom": "universal",
      "scale": "1x"
    },
    {
      "filename": "launchIcon@2x.png",
      "idiom": "universal",
      "scale": "2x"
    },
    {
      "filename": "launchIcon@3x.png",
      "idiom": "universal",
      "scale": "3x"
    }
  ],
  "info": {
    "author": "xcode",
    "version": 1
  }
}

三、检查Info.plist启动屏配置

确保Info.plist中UILaunchScreen配置正确，未使用旧版启动图属性：
- 若使用SwiftUI启动屏，不要设置UILaunchImageFile这类废弃属性
- 确认UILaunchScreenStoryboard指向正确的SwiftUI启动屏文件（或留空使用默认配置）