uniapp ios 启动图如何设置

在uniapp开发中，iOS平台的启动图应该如何正确配置？我已经按照文档在manifest.json中设置了启动图参数，但真机运行时仍然显示默认白屏。需要具体操作步骤说明：是否需要单独准备不同尺寸的图片？图片命名和存放路径有什么要求？是否需要通过Xcode进行额外设置？

2 回复

在HBuilder X中，点击manifest.json，选择“App启动图配置”，在iOS启动图部分上传对应尺寸的图片即可。注意适配不同设备的分辨率。


在 UniApp 中，iOS 启动图（Launch Screen）的设置主要通过配置 manifest.json 文件实现。以下是详细步骤和注意事项：

步骤：

  1. 打开 manifest.json
    在 HBuilderX 中打开项目根目录下的 manifest.json 文件，切换到“App 启动图配置”或“源码视图”。

  2. 配置 iOS 启动图
    在 "app-plus" -> "distribute" -> "ios" 节点下，找到 "launchimage" 配置项。示例如下：

    {
  "app-plus": {
    "distribute": {
      "ios": {
        "launchimage": {
          "iphone": {
            "retina": "[@2x](/user/2x)", // 对应 2x 分辨率图片
            "retina4": "[@2x](/user/2x)", // iPhone 4/4s（已废弃，可忽略）
            "retina47": "[@2x](/user/2x)", // iPhone 6/7/8/SE2
            "retina55": "[@3x](/user/3x)", // iPhone 6+/7+/8+
            "retina58": "[@3x](/user/3x)", // iPhone X/XS/11 Pro
            "retina61": "[@3x](/user/3x)", // iPhone XR/11
            "retina65": "[@3x](/user/3x)", // iPhone XS Max/11 Pro Max/12/13
            "retina67": "[@3x](/user/3x)"  // iPhone 12 Pro Max/13 Pro Max
          },
          "ipad": {
            "portrait": "[@2x](/user/2x)", // iPad 竖屏
            "landscape": "[@2x](/user/2x)" // iPad 横屏
          }
        }
      }
    }
  }
}

  3. 准备图片资源

    • 图片需为 PNG 格式，无透明通道，尺寸严格匹配设备分辨率（单位：像素）。
    • 命名规则示例：
      • iPhone 6/7/8（750x1334）：launchimage-750x1334[@2x](/user/2x).png
      • iPhone X（1125x2436）：launchimage-1125x2436[@3x](/user/3x).png
      • iPad（1536x2048）：launchimage-1536x2048[@2x](/user/2x).png
    • 将图片放入项目 nativeplugins 或 unpackage 目录（具体路径根据 HBuilderX 要求）。

  4. 生成并应用
    在 HBuilderX 中选择“发行 -> 原生 App 云打包”，勾选 iOS 平台并提交打包。云端会自动处理启动图适配。

注意事项：

  • 审核要求：启动图内容需静态，避免动态元素或广告，否则可能被 App Store 拒绝。
  • 更新问题：修改启动图后需重新云打包，真机运行可能不生效。
  • 分辨率参考：
    • iPhone 标准设备：750x1334（@2x）、1125x2436（@3x）
    • iPad：1536x2048（@2x，竖屏）

常见问题：

  • 图片不显示：检查图片命名、格式和路径是否正确，确保打包时已包含新资源。
  • 黑屏/白屏：未配置对应分辨率图片时，系统会显示默认背景色（可在 Xcode 中调整）。

通过以上配置，即可完成 UniApp iOS 启动图的设置。如有特殊需求（如动态启动图），需使用原生开发扩展。

回到顶部