iOS Custom Launch Screen / Storyboard Setup

Development Platform & Builds
, ,
1

Hi,

I’m building an application targeting iOS devices (iPhones and iPads). I have set the icons via XCode and now I’m trying to replace the default (unreal) launch screen with a custom one. I am following the following guide to set it up Setting Up iOS Launch Storyboards in Unreal Engine Projects | Unreal Engine 5.5 Documentation | Epic Developer Community. When building and editing the project on Mac, the settings for the launch screen image and setting a custom storyboard are locked. I have followed all the previous steps to create a storyboard successfully. I have also attempted adding the bCustomLaunchScreenStoryboard=True directly in the DefaultEngine.ini file, but I’m not able to see the changes in the settings when I relaunch the editor. What would be some suggestions to fix this issue?

Many thanks,

Lefteris

2

Steps to Reproduce

3

Hi Lefteris,

The bCustomLaunchScreenStoryboard var as well as the referenced documentation is unfortunately out of date and only applies to the Legacy Xcode path. Under ‘Modernized Xcode’, UBT will search the following paths for an existing storyboard file before falling back to the default.

List<string> StoryboardPaths = new List<string>()
{
"$(Project)/Build/$(Platform)/Resources/Interface/LaunchScreen.storyboardc",
"$(Project)/Build/$(Platform)/Resources/Interface/LaunchScreen.storyboard",
"$(Project)/Build/Apple/Resources/Interface/LaunchScreen.storyboardc",
"$(Project)/Build/Apple/Resources/Interface/LaunchScreen.storyboard",
"$(Engine)/Build/$(Platform)/Resources/Interface/LaunchScreen.storyboardc",
"$(Engine)/Build/$(Platform)/Resources/Interface/LaunchScreen.storyboard",
"$(Engine)/Build/Apple/Resources/Interface/LaunchScreen.storyboardc",
"$(Engine)/Build/Apple/Resources/Interface/LaunchScreen.storyboard",
"$(Project)/Build/IOS/Resources/Interface/LaunchScreen.storyboard",
"$(Engine)/Build/IOS/Resources/Interface/LaunchScreen.storyboardc",
};

Best regards.

4

Hi Stephane,

Many thanks for your assistance above. I managed to make work, however I’m not certain it’s the optimal way. I attempted to place the raw storyboard file in the project build folder “(Project)/Build/$(Platform)/Resources/Interface/LaunchScreen.storyboard” and I also attempted the same with the compiled version, but when building it wasn’t getting picked up by the build process (I was seeing the default when launching). I managed to make it work by manually compiling the .storyboard file and replacing the default linked .storyboard file in the “(Engine)/Build/$(Platform)/Resources/Interface/LaunchScreen.storyboardc” path. If there are any guidelines to make this more efficient/modular, I would greatly appreciate them.

Thanks again,

Lefteris

5

Hi Lefteris,

Unfortunately, in 5.5, there isn’t a more efficient/modular approach. You should however, only need to repeat this when editing the LaunchScreen.

Best regards.