Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

iOS: Added LaunchScreen.storyboard to support full screen on iPad Pro #2418

wants to merge 1 commit into from


Copy link

andshrew commented Aug 20, 2020

Apple requires an iOS app to use a Launch Screen storyboard - instead of a LaunchImage - to enable the app to run in full screen on devices like an iPad Pro. The Launch Screen file I have created just replicates what was in the current LaunchImage file (ie. centered ScummVM logo, orange background)

When run on an iPad Pro the app currently looks like this:- note black borders on either side
Screen Shot 2020-08-19 at 13 57 24

With a Launch Screen storyboard added the app can now display in full screen:
Screen Shot 2020-08-19 at 13 59 36

The procedure for updating create_project so that this new file was properly included in the Xcode project it creates is not entirely clear, so how I have implemented here was the only way I was able to reliably get the file included in the project and properly assigned to the iOS target only. This was done by adding the new file path in xcode.cpp so that it is included in the project, and naming it with an _ios suffix so that it is only assigned the iOS target (ios7_ prefix does not seem to work correctly, with the file assigned to both the iOS and macOS targets).

Tested on an iPad Pro 13.6.1, Xcode 11.6 (no jailbreak), following build instructions from


@@ -806,6 +806,7 @@ XcodeProvider::ValueList& XcodeProvider::getResourceFiles() const {

This comment has been minimized.


mgerhardy Aug 21, 2020 Contributor

This is not correctly indented - use tabs, not spaces

This comment has been minimized.


andshrew Aug 21, 2020 Author Contributor

Thanks, I have changed that to tabs.

@andshrew andshrew force-pushed the andshrew:ios-fullscreen branch from b194887 to 35d4e91 Aug 21, 2020
Copy link

criezy commented Aug 24, 2020

There are two ways to build ScummVM for iOS, one is with create_project and Xcode, and the other is using make on the command line. This PR only updates create_project currently, and will need to be modified to also handle the make process.

I am not really familiar with create_project, but I will have a look at the change in the next few days to see if there is a better way to handle this.

For the make process, the ios7bundle target in the file needs to be updated. Do you want to take a look at this? Otherwise I can do it myself.

Copy link
Contributor Author

andshrew commented Aug 24, 2020

Thanks for your reply. I can certainly give modifying the file a go but would appreciate your assistance if I get stuck as I'm not overly familiar with that (in particular ensuring it actually builds from the command line once the file has been updated as I've only used Xcode for iOS development so far).

Copy link
Contributor Author

andshrew commented Aug 28, 2020

I have had a look at amending this so that it can be built via make from the command line as well as via the Xcode project, but I need a bit of assistance from someone with more experience.

The first issue is that the instructions for building from the command line seem to be a bit out of date. I can follow it down to ./ which then fails to download as it no longer exists.

The second issue is that the ios-toolchain-based-on-clang-for-linux seems to suggest that it is unable to compile storyboard files so it may not work even if I were able to follow the above steps. Given its age I'm unsure if there is another alternative that should now be used.

NOTE: storyboard and xib files can not be compiled by this toolchain, since the format of these files is closed and undocumented, only nibtool shipped with xcode can handle these files and we had no chance to port it.

As the code in this PR currently stands (from testing in Xcode only on a non-jailbroken device), if you compile it without the storyboard file then when the app is first launched you will get a blackscreen for a moment before it loads (instead of the usual ScummVM logo on orange screen). The only way I can think of which would keep the launch screen correct on builds from both Xcode and make (while maintaining the new full screen support on builds from Xcode) would be to create a separate Info.plist for each build option so that the one for make builds omits references to the storyboard launch screen - unless anyone can see another solution to this?

Copy link

criezy commented Aug 29, 2020

So it looks like we might indeed want to exclude the storyboard when doing cross-compilation. One way to do that without duplicating the Info.plist would be to add a sed command in the ios7bundle target in to strip the UILaunchStoryboardName and following value in the Info.plist file.

Copy link

criezy commented Sep 6, 2020

I have manually merged this with a small change (the Info.plist file is generated from the file, so we actually need to make the change to the file).

I have also added a commit to remove the UILaunchStoryboardName from the Info.plist while when running the ios7bundle make target.

Thanks again for your contribution.

@criezy criezy closed this Sep 6, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
None yet
Linked issues

Successfully merging this pull request may close these issues.

None yet

3 participants
You can’t perform that action at this time.