UniApp 配置 iOS 启动界面完整指南

1. 配置 Storyboard 启动界面

在 manifest.json 中配置 iOS 启动界面时，需使用 ​Storyboard 格式而非直接图片，以避免 App Store 审核不通过，如果不上架IOS商店的话就无所谓了，直接和安卓一样用图片就行。
具体步骤如下：

---

​2. 创建 Storyboard 文件

• ​计划界面
  
  
  
  • 使用 Xcode 创建 .storyboard 文件，定义启动页的结构和元素（如 Logo、文字等）。
    
  • 支持 Auto Layout 适配差别屏幕尺寸。
    
  
  
• ​关联启动图
  
  
  
  • 在 Storyboard 中引用 @2x 和 @3x 的 PNG 图片，适配差别分辨率的 iOS 设备。
    
  • 图片命名规范：launchimage@2x.png、launchimage@3x.png。
    
  
  

---

​3. 资源文件打包

• ​文件要求
  
  
  
  • ​必需文件：.storyboard 文件 + @2x 和 @3x 的 PNG 图片。
    
  • ​压缩格式：将文件打包为 .zip 格式，确保根目录直接包含文件（无嵌套文件夹）。
    
  
  
• ​示例目录结构
  
  1. launch.zip
  2. ├── LaunchScreen.storyboard
  3. ├── launchimage@2x.png
  4. └── launchimage@3x.png

  复制代码

---

​4. Manifest.json 配置

在 manifest.json 的 app-plus → splashscreen 节点下配置：

1. {
2.   "app-plus": {
3.     "splashscreen": {
4.       "ios": {
5.         "storyboard": "LaunchScreen",  // 无需后缀名
6.         "images": ["launchimage"]     // 图片基础名（自动匹配@2x/@3x）
7.       }
8.     }
9.   }
10. }

复制代码

参数说明

• storyboard: Storyboard 文件名（不包含后缀）。
  
• images: 图片基础名称，系统主动加载 @2x 和 @3x 资源。
  

---

​5. 审核与兼容性处置惩罚

• ​避免审核失败
  
  
  
  • ​克制直接使用 PNG 图片：仅配置 Storyboard 文件，否则 App Store 可能拒绝上架。
    
  • ​隐藏状态栏：在 Storyboard 中设置 View controller-based status bar appearance 为 NO。
    
  
  
• ​多设备适配
  
  
  
  • ​iPhone/iPad 分离：为差别设备创建独立的 Storyboard 文件，通过 manifest.json 动态加载。
    
  • ​动态文本：使用 Auto Layout 确保文字在差别屏幕尺寸下居中显示。
    
  
  

---

​6. 测试与调试

• ​本地预览
  
  
  
  • 在 Xcode 中运行模拟器，检查启动页结构是否正常。
    
  • 使用 uni.getSystemInfoSync() 获取设备分辨率，验证图片加载逻辑。
    
  
  
• ​真机测试
  
  
  
  • 通过 TestFlight 分发测试包，验证差别 iOS 版本下的兼容性。
    
  • 检查启动页加载时间，优化资源压缩率以减少白屏时长。
    
  
  

---

​7. 常见问题

• ​图片不显示
  
  
  
  • ​缘故起因：PNG 文件未按 @2x/@3x 命名，或 Storyboard 中图片名称未匹配。
    
  • ​解决：检查压缩包内文件命名，确保与代码配置一致。
    
  
  
• ​结构错位
  
  
  
  • ​缘故起因：未使用 Auto Layout 或约束冲突。
    
  • ​解决：在 Xcode 中重新调解约束，优先使用「Safe Area」结构。
    
  
  

---

​总结

通过 Storyboard 配置 iOS 启动界面，既能满意苹果审核要求，又能实现动态结构和多分辨率适配。开辟者需严格遵照文件命名规范，并在真机测试中验证兼容性。更多细节可参考
 UniApp 官方文档

https://uniapp.dcloud.net.cn/tutorial/app-splashscreen.html#storyboard

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。