启动屏幕在 iOS 14 和 Xcode 12 上不起作用

Question

I am very frustrated now. I upgraded Xcode to version 12 and tested my app on iOS 14. Now the problem is, that my launch screen is just showing in black. I tested it with an iOS 13.5 device and it is still working as expected. I tried to remove the launchscreen.storyboard approach and added the Launch Screen key in the info.plist, but then the image is scaled to full size.

Now I tested a little bit with the launchscreen.storyboard and I found a few things.

• If I remove the Image view, the launch screen is showing as expected. I added just a label and that would work.
• If I use an image from the system in the image view, it is working as well. It is just not working when I am using an image from the project.

Did you experience issues with iOS 14 and the storyboard approach?

If yes, how did you fix it?

Answer 1

A work around that seems to be working for me:

For a strange reason if I am downsizing the image then it is working fine . I had a full size image of dimension 2732x2732 and it didn't work. Reducing the dimension of the same image to 2400x2400 is working fine. I have tried with 2500x2500 and 2600x2600 but none worked.

Most importantly, every time I change the image I had to restart the simulator to reflect the updated image.

It didn't work on the real device yet. Like the simulator, I had to restart the device and then only it worked.

Not sure if it is something with the dimension/size of the image or with the reboot.

Further updates:

I uploaded the same build (with smaller image) to TestFlight and installed it on my device (basically updated from the previous version having large size image) and unfortunately the issue persisted :(

Now what I did is uninstalled the app and reinstalled it again from TestFlight. Issue still persisted.

Finally I had to delete the app , reboot my device and install the app again. This is when it worked fine.

Answer 2

So here are a lot of good ideas, but I was able to finally solve the issue - it is more like a workaround. I needed to store the picture outside the Images.xcassets folder and then it started to work again. This is a very weird issue.

Answer 3

A workaround is to use a button with an image instead of an imageview in the launch storyboard. It works like a charm!!

Answer 4

The only workaround that works for me was to add the images outside Images.xcassets folder. After modified this and rebuild the app, it worked expected.

Some issue it's happening on the iOS 14 or XCode 12.

Answer 5

Had the same problem. The issue was the .png image used in the launch screen storyboard. This lead to the whole launch screen just being black.

What fixed it in our case was:

• Choose a smaller image
• Delete App from device/simulator
• Restart device/simulator

I found that the image was the source of error by replacing the image with an other one in our app. It immediately worked with a different image (no restarting or else required).

Answer 6

I encountered this problem

when using LaunchScreen.storyboard and used the image on Assets.xcassets, not working on iOS 14 with Xcode 12.

I solved it by try put change 3x image 2436×1125,and set 2x image 828×1792.

Finally I had to delete the app, reboot my device and install the app again. This is when it worked fine.

Answer 7

I had this, too. Pretty infuriating. My launch screen is merely a background image (2048x2048 PNG) and a graphic (2048x2048 PNG) in the middle.

The fix for me was to have a smaller middle graphic (720x720 PNG), remove the images from any assets catalogs, and add them into the project.

The images didn't show on the Simulator until I restarted it. When built and installed to my iPhone, I didn't have to restart it.

Answer 8

One reason might be the size of the images. Since iOS 14 images for launch screen are limited to 25 MB as stated in Apples Human Interface Guidelines .

An image with 2.400x2.400 pixel will result in a memory size about 22 MB. With 2.500x2.500 we reach the 25 MB.

We had the same problem where the full screen image in LaunchScreen.storyboard was black on all @3x devices like iPhone 12. Reducing the size of only the @3x launch image from 3.072x3.072 to 2.400x2.400 solved this problem.

A square image is the easy way to support landscape and portrait orientation. But it should also work to have different images for each orientation, where one image in total is less than 25 MB.

Answer 9

I have a similar issue with XCode12 / iOS14 and React project: The launchscreen.storyboard was working fine in previous versions. Since update to XCode12 it shows as following:

• Lauching into a black screen (2-3 seconds)
• Then showing the Launchscreen correctly

If I try to use the new "Launch Screen" dictionary in Info.plist I have the follwing issues (same in another Xamarin App):

• Image is zoomed in / not showing completely
• Background color setting is completely ignored (tried RGB and Color.xcasset)

This is just completely bugged since Xcode 12 !

Answer 10

So I've had this bugged with Apple via their feedback system since June 26th 2020 - FB7795777.

I've provided my project and many diagnostic reports and they've never come back with a fix.

However, today, I fixed it.

Basically, there has been some change in the iOS/iPadOS SDK about how it's support .PNG and .JPG files (size or dimensions are the problems I think) in the Launch screen process.

The solution:

Open your .PNG file in Photoshop and re-export it with the 'Smaller File - 8-bit' option checked. It shrunk it down to less than half the size, and it worked first time.

Answer 11

In my case following did the job:-

1. Remove Launch screen file from Project -> General -> App Icons and Launch Imagees -> Launch screen file.

2. Go to info.plist file and open as source code.

3. Add following code there and change the image name:-

   <key>UILaunchScreen</key> <dict> <key>UIImageName</key> <string>splash(This is your image name)</string> </dict>

4. In iOS 14 this new key was released (UILaunchScreen). So take care from next time. If you get error then check info.plist file.

5. Happy coding :)

Answer 12

In my case, the ViewController property, "Is Initial View Controller" was not checked. Also, be sure to set the color of the view to an actual color and not a system color, otherwise you can run into issues with the device theme settings. That is, if you like to show a specific color.

Also, to access that setting make sure you click on the actual View Controller object in the drop down panel.

Answer 13

That worked for me was:

1. Put xxx.pdf image into Assets.xcassets and set "scale" to Single Scale

2. In Launch Screen.storyboard, set the imageView's image is xxx , then set imageView 's width , height , centerX and Bottom to View

Then worked for me

Xcode 12.5.1, iPhone 7 Plus, iOS 14.6

Answer 14

In my own case , I solved the problem in these few steps:

1. Image must be 1024px, then
2. Add to assets

-> A workaround in case you have a much bigger image, use these simple steps:

1. Generate your app icon
2. Go to the app icon folder
3. Copy the 1024 px of that image and appicon image
4. Then add to assets. Both methods works perfectly.

Answer 15

This may help others so I am adding it here.

I use Cordova for my hybrid app, and then I load my image assets that are generated by Asset Catalog Creator (which is a great little product).

This was working perfectly until I updated to Xcode 12 and tried to run it under iOS 14.

What I discovered is that Cordova was adding a "CDVLaunchScreen.storyboard", and they had a "LaunchStoryboard.imageset" (directory) in their asset catalog, which contained just a contents.json file.

I simply copied this into my asset catalog, and when I drag and drop this into my updated project (newly generated each time by Cordova), my Launch Image displays again.

Don't ask my how or why Xcode magically wires this stuff together, but it worked for me.

I can pass along the contents.json that worked with my asset catalog if it will help.

BTW, my General settings screen does NOT have a Launch Screen File selected, but Xcode seems to find the required files.

Answer 16

I've got yet another potential solution to this, as none of the existing solutions worked for me.

I use PDF vectors in my Asset file, and this normally works great. But it turns out that it doesn't work on the launch screen - it just shows skips the launch screen entirely if it contains a PDF image.

Swapped it for a large PNG, problem solved.

Answer 17

The only thing that worked for me was:

1. Delete the existing LaunchScreen.storyboard & create a new one
2. Check " Use as Launch Screen "

3. Check " Is Initial View Controller "

4. Make sure the image your using is NOT located under Assets.xcassets folder. I put my image in the root of the project
5. Delete the app, restart the simulator, and run the application

BINGO!!!

Answer 18

What worked for me:

• Use smaller images like @Darkpaw suggested. Launch storyboards are, after all, intended to be indicative of the coming UI, not artwork based.
• Use PNG image (not PDF) and don't put it in an assets catalog like suggested by @Sylber

Just noting separately as I had black/broken launch mages until I did BOTH steps.

Answer 19

You might be seeing this issue if your @1x, @2x, @3x images are blank in your image xcassets folder.

Make sure you have images for each.

You can also select your 1 image, and set Scales as "Single Scale" in the Attributes inspector (on the right hand side)

Answer 20

In Xcode 13 launch screen was not displaying rather a black screen was coming.

But this worked for me Project -> General -> App Icons and Launch Images -> Launch screen file -> change Main to Launchscreen.

Answer 21

Most answers mentioned here are workarounds, the issue i noticed is that when you modify the launch screen assets, do check the item file name too.

Assets -> Show in folder

Then check the launchscreen items folder and make sure that the item inside the folder has the same name as folder.

Answer 22

To expand on Thorsten Stark's answer above...

Since iOS 14 images for launch screen are limited to 25 MB

For me it appeared to be an accumulated size of assets on my Launch Screen storyboard file. When I removed a number of them I no longer saw the black screen.

I ended up just using one image 2778 x 1284 which was 600kb in size. This solved the problem.

To further test, I duplicated the image to make 3 copies on my Launch Screen storyboard file, and sure enough, black screen again.

Answer 23

The best solution to me in 2022...

reduce sizes of your images, in my case: splash.png (256x256) splash@x2.png (512x512) splash@x3.png (768x768)

only doing this and put them in Resources folder then reference in ImageView work like charm....

alternative: use Button in place of ImageView works too

Answer 24

I am very frustrated now. I upgraded Xcode to version 12 and tested my app on iOS 14. Now the problem is, that my launch screen is just showing in black. I tested it with an iOS 13.5 device and it is still working as expected. I tried to remove the launchscreen.storyboard approach and added the Launch Screen key in the info.plist, but then the image is scaled to full size.

Now I tested a little bit with the launchscreen.storyboard and I found a few things.

• If I remove the Image view, the launch screen is showing as expected. I added just a label and that would work.
• If I use an image from the system in the image view, it is working as well. It is just not working when I am using an image from the project.

Did you experience issues with iOS 14 and the storyboard approach?

If yes, how did you fix it?