启动屏幕 storyboard 不显示图像

Question

I'm trying to get an image to display as the launch screen from my Launch Screen.storyboard file, however the image never displays. I have labels that show up fine, but the image doesn't appear.

This is how the launch screen looks in the Launch Screen.storyboard file:

However when I run the app on the simulator (as well as on the physical device) this is what shows up:

As you can see, the label "Test" shows up fine, however the image does not display. I'm really not sure why this is happening and nothing I try seems to work. If anyone has any ideas of how to fix this it would be greatly appreciated.

Answer 1

After restarting Xcode, cleaning the build and a number of the other suggestions on SO about this problem. What actually fixed it for me was a hard reboot of the device. (I wasted over an hour on this)

I suppose it just goes to show that the old saying have you turned it off and on again is still true for the latest gadgets!

How to reboot iPhone XS or iPhone XS Max

1. Quickly press and release the Volume Up button
2. Quickly press and release the Volume Down button
3. Press and hold the Side Button until the Apple logo appears

Answer 2

I was messing around with this for hours too. But i found the solution now. You need to add the image to your project and also to the assets.xcassets via drag and drop.

Answer 3

有同样的问题，将图像添加到“构建阶段 - > 复制捆绑资源”为我修复了它。

Answer 4

Follow below steps,

1. Remove application from the device
2. Restart device
3. Build again

If not working, delete derived data. Xcode Preference->Locationtab->Derived data. Then do follow above steps.

Answer 5

It happened to me and makes me crazy, beyond get me lose some minutes 'til I figure it out.

So, like was said before:

1. Import the desired image to your Xcode project (just drag and drop it)
2. Change its Constraints and Alignment
3. Update frames resolving Auto Layout issues
4. In the Attributes inspector tab menu (generally in right corner menu xCode), on Image view > Image, remove image extension (.png or .jpg) - that's the trick

On the design screen, it will not appear, but when you run your app, it will be shown.

I hope it can help!

Answer 6

Very frustrating. Solution that finally worked:

1. Do hard reboot of device

2. Delete app

3. Install app from Xcode

Answer 7

At last, restart the phone works for me!!

I have spent hours on this issue. Had tried change the images name, delete the whole image assets, modify info.plist, restart Xcode and even tried to set all the attributes of the images(which you can tell how desperate I was).

Answer 8

I faced the same problem.

1. Add an new imageset to XcodeAssets.
2. Add images to to the imageset.
3. Add image view to launch screen and set your imageset as image
4. On Imageview's attributes inspector, uncheck 'clears graphics context'
5. Clean the build folder and run again.

Answer 9

After invested a lot of time, I got the solution:-

Step 1:- Quit Xcode
Step 2:- Delete the app from device/simulator
Step 3:- Restart your device (if you are using simulator then you have to quit simulator)
Step 4:- Clear all derived data 
Step 5:- Clear Bin
Step 6:- Open Xcode and relaunch the app, it will work 

Answer 10

此问题与Assets.xcassets相关以修复它您必须将图像添加为资源但不在xcassets文件夹中，然后应该可以正常工作

Answer 11

就我而言，重置模拟器的内容和设置解决了这个问题。

Answer 12

It seems there is some problem with resource caching in xCode. Had the same problem, restarted xCode and everything works fine after that.

Answer 13

重新启动您的设备并清除 x-code 派生数据

Answer 14

After trying everything on several StackOverflow threads, here's what worked for me:

• Use a .png
• Do not include it in your Assets catalog. Add it to your project's hierarchy directly, as you would add any source file.
• In the image view, load the image including its extension. Example: launch_app_image.png

(Might have to clean product or derived data to update, but I didn't have to)

Answer 15

Well As of now there is retina device available and I ignored @1x image in Assets.xcassets .

In my case, I have app logo in Splash screen which is not visible when I run the application.

After wasting so much time I figured out that I only provided @2x and @3x images for that logo image.

This issue is resolved by adding @1x version of that image.

Answer 16

在将图像添加到项目并击落问题解决的设备后，我遇到了这个问题

Answer 17

Was changing the background image of the splash screen and the new image wasn't showing (react native project).

Following the answers from others.

I did all the below and it was fixed:

• Clean build.
• Remove app from simulator
• Quit simulator
• Restart XCode
• Run app again

Answer 18

You have to make sure that the file name of your image has a format like .png or .jpg at the end otherwise it will not work. Also, before adding your image, you have to make sure that the image file is in your "Assets.xcassets" folder within your project. This can be done with a simple drag and drop. Also, make sure when you've added your image to your storyboard that the image name in the top left also matches the real image file name. I would try looking into Constraints too. Hope this helps. Good luck with your App.

Answer 19

I tried so many things with this (this thread alone seems to have a million ideas and half of them are conflicting). The problem for me was that when I did things like restarting the device and Xcode, it would cause the image to show for a few sessions of the app, and then it would stop (I have no idea why, but WOW it was annoying).

After countless hours, I found that AG's answer in this thread is the correct one. The one thing I was doing wrong was that I was creating a new image set within xcassets, but I was then still using the name of the image within the UIImageView inside of the storyboard instead of using the name of the image set.

To clarify, what you would do is create a new image set and name it something like "Launch-Defaults", and then add your images to it. Then, within the UIImageView inside of the storyboard, you use the image "Launch-Default" (not including an extension since there is none since this is an image set).

When you do all of that, the image should actually appear correctly inside of your storyboard. Some people say the image will display blank if you don't use the extension (.jpg or .png), but I assume that is because they are not using the name of the image set. Others say you need to use an extension like .png or .jpg, but the key is to create the image set inside of xcassets and then use that image set inside of the storyboard. When done correctly, there should be no funkiness like an image not showing up or the Launch Screen only working some of the time (requiring a reboot).

Answer 20

Just to add my $0.02 to this question; I got this solved by using PNG images instead of JPG/JPEG images.

After converting the images to PNG and crunching them to reduce the size a little, everything worked fine.

Answer 21

In my particular case, the splash screen worked for the simulator and other devices, but stopped working for one specific device. This lead me to believe that it was some caching data kept by xcode (v10 and iPhone 7 v12.1).

I deleted the derived data at: ~/Library/Developer/Xcode/DerivedData/ only emptying the folder contents, not deleting the folder. I then rebooted the mac and the iPhone and cleaned and rebuilt the project, and now it is showing up.

I'm not sure if all of this was necessary, but didn't want to waste any more time narrowing it down, so the above sledgehammer approach worked for me. But of course it always depends on your specific situation - mine was device specific; for others it could be the actual image or launch screen layout etc.

Answer 22

My issue.

Reason: I have renamed the images after dragging into Xcode. Solution: Don't rename images after dragging into Xcode. It creates problems for understanding Xcode. Rename images before dragging/adding into Xcode.

Hope it helps you out!

Answer 23

Actually, for some heavyweight images, it isn't a good situation to add them into images.xcassets , because the app loads images.xcassets lightweight images before launch. So I put splash screen images at the first root of load and then the issue has gone:

1. Create a new Group in the root of the project
2. Drag and drop your image inside of the yellow group folder
3. Rename it to a different special name
4. Back to your xib (or storyboard) file and address the ImageView to the special name that it is in step 3 .
5. Clean and build again, then you can see your image.

Hint : You can create your ImageSet in the images.xcassets but place them in the root of the project.

Answer 24

I spent hours on this problem before finally realizing my mistake. When you add an image to a UIImageView, it will use just the name of the image. If your images are in a different folder than your storyboard, they will show up in xcode but not when running the app. You must add the appropriate file path prefix, for example, images/image.png. It will now appear as a blue question mark in xcode, but it will work in the app.

Answer 25

I faced the same issue. Tried different solutions for that but nothing proved to be helpful. I then realised that the image was not visible only when i directly installed the app into device and the app is still connected to the xcode. If i disconnect it and then open the app the image was visible as expected. It might be a xcode bug.

Answer 26

I tried cleaning the project, removing the png, removing the constraints did not work for me.

I just made one more copy of the image and renamed the copy then deleted the old image and added the new image (Same, with name changed) i just gave that image and it worked for me.

Also i am not using the Assets.xcassets, using the image in a folder.

Answer 27

My first mistake was, that I created a normal .storyboard, renamed it and defined it as launchscreen in the project settings. I this case I had image problems. It seems that some settings are missing in this case then, so I just created a new file via file->new and picked directly the "Launch Screen" and then it worked.

Also I had in mind that, that layout constraints are not supported in the launchscreen for some reason. Maybe it was like that in the beginning, not sure, but now constraints should work.

Maybe this helps anyone.

Answer 28

In my case, it was a bit more than just rebooting the device. My launch image was stored in other Assets (Other Pods).

Had to move the image to App project's Assets. And then rebooted my device. (Check simulator first, it should work). Then it worked.

Images can be in format png/pdf, single scale or not doesn't matter.

Answer 29

I was stucked into same issue thanks to the below reference I am able to resolve the issue

https://developer.apple.com/forums/thread/19759?answerId=75438022#75438022

Though it is not necessary to change the image name and removing the extension while selecting the image for imageview, I simply created one folder named resources and added my image inside that folder coz I thought it would be not good to put images directly into the root folder

Hope this would help.

Happy Debugging!

Answer 30

I just figured this out. My launch image was not showing up, I get a white screen when launching on a device (iPhone 6, 7+) or testFlight. Fix: Renamed "Landing_screen.png" to just "Landing_screen" removing .png part. The image icon in Xcode changed to white icon and in the launch screen storyboard the image appears as a question mark now. The Launch image now appears and not the white screen. My Setup: I am using Swift 3.1 with Xcode 8.3.1. In LaunchScreen.storyboard I added a simple image view and stretched the image to fit the view controller. I set auto layout constraints Top/Bottom/Leading/Trailing space to superview to 0 - see image below:

Answer 31

In my case, it turned out I had some views still linked to the view controller that was now just a basic view controller. If I control-click on the view I can see the outlets with warnings, however, the warnings did not appear in Xcode which is why I was having trouble finding them.

Answer 32

这恰好是XCode / iOS中的缓存问题，但是有一个简单的解决方法：只需在Assets.xcassets中重命名文件，就可以重新生成缓存。

Answer 33

I have face this same issue when using launch-storyboard for showing splash screen and after research i have found that the image what i have set in launch-storyboard is of different size and i have set image-view bigger than actual size of image.

So the solution i have found is either set image-view content size as aspect fit or set image-view size as image size.

Like if your image @1x size is 200X200 than image view should be of 200X200 than you will solve this issue.

As because if you set image-view size bigger than image then image will starched and this is not allowed.

If you still have any doubt please comment here and ask

Answer 34

I had launch screen file named but it didn't exist. When I removed this my launch image appeared.

Answer 35

In my case I could fix it by just unchecking "clears graphics context" from attribute inspector for all of the image views used in the Launchscreen storyboard.

For your information i had imported images in Assets.xcassets in png formats.

Answer 36

In my case I had to select two checkmarks:

• Use as Launch Screen
• Is Initial View Controller

Answer 37

Importing images as regular files worked for me. Don't add image from assets catalog!

Answer 38

There was 2 issues in my case that resolved it:

1. It seems there is a 1MB size limit for the image; not documented but when I optimized the same image from 3MB to under 1MB it worked. This would make sense since the OS wants the launch screen to be light as possible.
2. The OS does indeed cache the launch screen aggressively, To see my launch screen changes: I had to reset the simulator each time: Device > Erase All Content and Settings