DCloud_App_Array
DCloud_App_Array
  • 发布:2020-06-28 13:15
  • 更新:2024-04-25 13:31
  • 阅读:117033

iOS平台自定义storyboard启动界面

分类:HTML5+

背景

6月30日起,苹果App Store审核要求应用在启动时,不能使用启动图片,必须改为使用Storyboard来制作启动界面。原文参考:https://developer.apple.com/news/?id=03262020b

之前使用静态png图片做启动屏的方式,最大的问题是多尺寸适配,iOS设备目前不同屏幕尺寸太多,为每种屏幕做png图片不是合理解决方案。

Android处理多屏适配问题使用了.9.png,iOS则使用了Storyboard来处理。

什么是Storyboard

Storyboard是Apple提供的一种简化的布局界面,通过xml描述界面,不能编程。
虽然无法制作非常灵活的界面,但满足启动界面是没问题的,比如设定背景色背景图、设定前景文字、图片的位置。
storyboard的优势是启动速度快。在App的真实首页被渲染完成前,可以快速给用户提供一个基于Storyboard的启动屏。

其实5+App、wap2app、uni-app在iOS上,已经在两种情况下使用了Storyboard:

  • 如果在manifest里没有选择自定义启动图片,那么默认情况下,打包后App启动时,会出现一个显示着app logo和name的通用启动界面。在iOS上,其实这个界面就是使用Storyboard实现的。
  • 如果你的App启用了uni-AD广告服务,那么开屏广告界面,iOS上也是基于Storyboard实现的。

6月30日起,如上线Appstore,iOS只能使用Storyboard做启动图。如果你不想自己做Storyboard文件,就选择上述2种方式。
如果想自定义Storyboard,那么从HBuilderX 2.8起,也提供了自定义storyboard的方式。

如何自定义storyboard

HBuilderX2.8+版本开始支持配置自定义storyboard启动界面。

概要流程是:开发者首先制作storyboard文件,然后将storyboard文件和图片资源打包成zip,然后在HBuilderX 2.8+的项目manifest中选择这个zip,最后打包生效。

第一步:制作storyboard文件

storyboard有两种制作方式:
1. 直接使用附件提供的相对常用的 storyboard 模板,可在这个文件的基础上进行自定义(不需要 Mac 及 XCode,详情请查看附件中的 readme 教程)
此 storyboard 文件适用于各种 iPhone 及 iPad 设备的横竖屏,支持自定义界面元素包括

  • 页面背景图片或背景颜色
  • 中间显示图片
  • 底部显示文字及颜色
    注:每一项都是可选的(比如只显示背景图片,只提供背景图片即可)

2. 使用xcode自行制作。xcode提供了可视化的制作storyboard的方式,但依赖于mac电脑。在xcode中制作storyboard的教程请自行网络搜索,请注意下面的注意事项。

HBuilderX需要的自定义storyboard文件格式为zip压缩包,里面要求包含XCode使用的.storyboard文件,以及.stroybard文件中使用的png图,如下图所示:

注意事项

  • zip压缩包中不要包含目录,直接包含.storyboard和.png文件
  • 有且只有一个.storyboard文件
  • .storyboard文件可以通过xcode生成,也可以使用任何文本编辑器修改其源码,比如对.storyboard文件点右键,使用HBuilderX打开。它本质是一个xml文件。
  • png文件名称中的@2x和@3x是适配不同分辨率的图片,系统会自动根据设备dpi选择,可参考这里
  • 为了避免png文件名称与应用中内置的文件名冲突,建议以dc_launchscreen开头
  • 制作 storyboard 时,请将图片资源直接拖到放工程中,不要放到 imageset 里面,并且图片命名要保证一定的唯一性可参考附件中的示例
  • XCode中创建 storyboard 文件时,页面元素添加约束时一定要相对于 Superview,不然启动图到 loading页面过渡时页面会跳动或者变形

第二步:在HBuilderX的manifest界面中选择 自定义storyboard文件包。

把制作好的storyboard的zip包放置到硬盘中。
HBuilderX中打开项目的manifest.json文件,在“App启动界面配置”页面中勾选“自定义storyboard启动界面”,并选择自定义storyboard的zip包:

配置后需提交云端打包才能生效

离线打包请参考:iOS平台配置应用启动界面

附件说明

附件CustomStoryboard.zip为自定义sotyboard模板示例,默认效果如下:

此 storyboard 文件适用于各种 iPhone 及 iPad 设备的横竖屏,支持自定义界面元素包括

  • 页面背景图片或背景颜色
  • 中间显示图片
  • 底部显示文字及颜色

注:每一项都是可选的(比如只显示背景图片,按照附件zip文件中的 readme.md 教程进行自定义修改,只提供背景图片即可)

后续

为iOS和Android制作不同的屏幕适配方案,还是比较麻烦。
通用启动界面虽然双端均支持,且可以上Appstore,但自定义性不足。
后续DCloud会强化通用启动界面的灵活度,允许对背景、前景提供更多自定义性,并确保在iOS、Android双端均支持。

暂时,开发者如觉得自定义storyboard启动界面配置麻烦,也可以在manifest的启动图设置中选择默认的通用启动界面(或在HBuilderX2.8以前的版本删除启动图片配置),也满足App Store审核要求。

温馨提示:请勿在本贴下频繁刷广告,一经发现,直接封号。

11 关注 分享
1***@qq.com yogic x***@163.com 55823566 短毛猫 这是谁的部将 javta ReyZhang [已删除] 来学习 套马杆的套子

要回复文章请先登录注册

听海等日落

听海等日落

回复 x***@163.com :
请问解决了吗?怎么解决的?我也有这个问题
2021-12-30 14:12
听海等日落

听海等日落

使用zip修改,图片尺寸是iphoneX的,放到11手机上下都有留白,看到有的人说需要把Safe area改成superview,这个xml改哪里?
2021-12-30 12:23
chinahappybeer

chinahappybeer

回复 DCloud_App_Array :
热更新会更新 CustomStoryboard.zip 文件里的内容吗,我看wgt 包里有包涵这个文件
2021-12-28 01:22
chinahappybeer

chinahappybeer

3.3.3.20211225 当下最新版,提交云打包都是错的。



CompileStoryboard [PackagePath]/HBuilder/Base.lproj/LaunchScreenAD.storyboard (in target 'HBuilder' from project 'HBuilder')
cd [PackagePath]
export XCODE_DEVELOPER_USR_PATH\\=/Applications/Xcode.app/Contents/Developer/usr/bin/..
/Applications/Xcode.app/Contents/Developer/usr/bin/ibtool --errors --warnings --notices --module HBuilder --output-partial-info-plist [PackagePath]/build/HBuilder.build/Release-iphoneos/HBuilder.build/Base.lproj/LaunchScreenAD-SBPartialInfo.plist --auto-activate-custom-fonts --target-device iphone --target-device ipad --minimum-deployment-target 9.0 --output-format human-readable-text --compilation-directory [PackagePath]/build/HBuilder.build/Release-iphoneos/HBuilder.build/Base.lproj [PackagePath]/HBuilder/Base.lproj/LaunchScreenAD.storyboard

CompileStoryboard [PackagePath]/HBuilder/Base.lproj/LaunchScreen.storyboard (in target 'HBuilder' from project 'HBuilder')
cd [PackagePath]
export XCODE_DEVELOPER_USR_PATH\\=/Applications/Xcode.app/Contents/Developer/usr/bin/..
/Applications/Xcode.app/Contents/Developer/usr/bin/ibtool --errors --warnings --notices --module HBuilder --output-partial-info-plist [PackagePath]/build/HBuilder.build/Release-iphoneos/HBuilder.build/Base.lproj/LaunchScreen-SBPartialInfo.plist --auto-activate-custom-fonts --target-device iphone --target-device ipad --minimum-deployment-target 9.0 --output-format human-readable-text --compilation-directory [PackagePath]/build/HBuilder.build/Release-iphoneos/HBuilder.build/Base.lproj [PackagePath]/HBuilder/Base.lproj/LaunchScreen.storyboard
/* com.apple.ibtool.errors */
[PackagePath]/HBuilder/Base.lproj/LaunchScreen.storyboard: error: Line 35: Input is not proper UTF-8, indicate encoding !
Bytes: 0xB0 0xB2 0xB6 0xA9CompileAssetCatalog [PackagePath]/build/Release-iphoneos/HBuilder.app [PackagePath]/HBuilder/Assets.xcassets (in target 'HBuilder' from project 'HBuilder')
cd [PackagePath]
/Applications/Xcode.app/Contents/Developer/usr/bin/actool --output-format human-readable-text --notices --warnings --export-dependency-info [PackagePath]/build/HBuilder.build/Release-iphoneos/HBuilder.build/assetcatalog_dependencies --output-partial-info-plist [PackagePath]/build/HBuilder.build/Release-iphoneos/HBuilder.build/assetcatalog_generated_info.plist --app-icon AppIcon --compress-pngs --enable-on-demand-resources YES --development-region en --target-device iphone --target-device ipad --minimum-deployment-target 9.0 --platform iphoneos --compile [PackagePath]/build/Release-iphoneos/HBuilder.app [PackagePath]/HBuilder/Assets.xcassets
** BUILD FAILED **The following build commands failed:
CompileStoryboard [PackagePath]/HBuilder/Base.lproj/LaunchScreen.storyboard (in target 'HBuilder' from project 'HBuilder')
(1 failure)
2021-12-27 19:10
chinahappybeer

chinahappybeer

回复 DCloud_App_Array :
最新版规则是不是改了。
2021-12-27 18:55
王奇

王奇

我直接用附件里的zip文件,项目中也设置了自定义storyboard启动界面,选择了自定义基座,重启手机,为什么就不生效呢?
2021-12-11 11:54
DCloud_App_Array

DCloud_App_Array (作者)

回复 我一笑而过 :
界面样式没有限制,不能使用违规的内容(如低俗、侵权等内容)
2021-11-20 17:44
我一笑而过

我一笑而过

回复 DCloud_App_Array :
启动界面可以配置一张花哨些的图吗?
2021-11-19 18:05
DCloud_App_Array

DCloud_App_Array (作者)

回复 我一笑而过 :
关于图标@2x和@3x的问题,文档中有说明,参考这里:https://www.jianshu.com/p/5b5f47ff87d4
2021-11-19 17:15
我一笑而过

我一笑而过

以iPhone x的尺寸设计,iPhone x设计稿尺寸1125*2436,用这个尺寸的图在ps输出@2x和@3x的图就可以吗?@ DCloud_App_Array
2021-11-19 11:17