xCode5
iOS7
launch image error
app development
troubleshooting

I get an error None of the input catalogs contained a matching launch image in xCode5-iOS7

Master System Design with Codemia

Enhance your system design skills with over 120 practice problems, detailed solutions, and hands-on exercises.

Understanding the Error: "None of the input catalogs contained a matching launch image" in Xcode 5 and iOS 7

When developing applications with Xcode 5 targeting iOS 7, you might encounter the error message: "None of the input catalogs contained a matching launch image". This issue arises during application verification or submitting the app to the App Store, stemming from misconfigured or missing launch images. In this article, we'll delve into the technical details behind launch images, how they function, and the steps to resolve this error.

What are Launch Images?

Launch images, known as splash screens, provide users with a visual indicator that the app is starting. They give the application time to load its initial interface. These images must adhere to specific requirements based on the device's display and orientation:

  • Launch image dimensions: Must match the screen size of the device.
  • Orientation: Should correspond to the orientation supported by the app (portrait or landscape).
  • Resolution: Must cater to both standard and Retina displays accordingly.

Technical Explanation

Launch images are stored in an `xcassets` catalog within the project. iOS expects these images to be named and formatted precisely. In iOS 7, the expected naming conventions include:

  • iPhone Portrait (non-Retina): `Default~iphone.png`
  • iPhone Portrait (Retina 4-inch): `[email protected]`
  • iPad Portrait (non-Retina): `Default-Portrait~ipad.png`
  • iPad Landscape (non-Retina): `Default-Landscape~ipad.png`

iOS verifies whether these images exist for supported devices and orientations. If an essential image is missing, the error is triggered.

Resolving the Error

To address this issue, follow these steps:

  1. Inspect Your Asset Catalog:
    • Open the `Images.xcassets` file within your project.
    • Confirm that launch images for all required device dimensions and orientations are present.
  2. Correct Naming and Configuration:
    • Check if images are correctly named and placed in their respective slots.
    • Ensure that image properties match the required dimensions and resolutions.
  3. Configure Info.plist:
    • Add or verify the `UILaunchImages` entry in your `Info.plist`. Each entry should specify an image size, scale, and image file name. For example:
    • Check the target’s supported interface orientations in the project settings. This setting dictates the required launch images.

Course illustration
Course illustration

All Rights Reserved.