Resolving Error ITMS-90717 in iOS App Submission: A Comprehensive Guide to Invalid App Store Icon Issues

In the iOS app development lifecycle, developers frequently need to submit applications to the App Store for review and distribution. However, various technical errors may arise during submission, with Error ITMS-90717: "Invalid App Store Icon. The App Store Icon in the asset catalog in 'YourApp.app' can't be transparent nor contain an alpha channel." being a common obstacle. This error explicitly states that the App Store icon must not contain transparent areas or alpha channels, yet the issue may persist even when developers confirm they have submitted files without transparency. This article delves into the fundamental causes of this problem and provides systematic solutions.

Root Cause Analysis

The essence of the ITMS-90717 error lies in the icon file format not complying with Apple's technical specifications. As the primary visual identifier for an app in the store, the App Store icon must adhere to strict image standards. Specifically, the icon file should use an RGB color mode without an alpha channel, meaning the image cannot have any transparent regions. While alpha channels are used in image processing to control transparency, this feature is explicitly prohibited for App Store icons as it can lead to display anomalies.

Developers may encounter situations where, even though the original icon file appears to lack transparency, certain software may retain alpha channel information by default during image editing or exporting. For instance, when viewing an image in Preview, if the Alpha option is checked in export settings, the generated file will still contain transparency data. Such hidden format issues are often difficult to detect visually but are caught by Apple's validation system during app submission.

Core Solution

To address the ITMS-90717 error, the most direct and effective solution is to re-export the icon file through the system's built-in Preview application. The specific steps are as follows: First, locate the App Store icon file (typically 1024×1024 pixels) in Finder and open it with Preview. In Preview's menu bar, select File -> Export. In the export dialog, the crucial step is to uncheck the "Alpha" channel option. This ensures the newly generated image file completely removes transparency channel information. Finally, replace the original file in the project with the newly exported icon and revalidate and upload the application.

To illustrate this process more clearly, here is a simplified code example demonstrating how to check if an image contains an alpha channel in a command-line environment:

import PIL.Image

def check_alpha_channel(image_path):
    img = PIL.Image.open(image_path)
    if img.mode in ('RGBA', 'LA', 'P'):
        return True
    else:
        return False

# Usage example
result = check_alpha_channel('icon-1024.png')
if result:
    print("Image contains alpha channel, requires processing")
else:
    print("Image format meets requirements")

This code uses Python's PIL library to open the image file and determines the presence of an alpha channel by checking the image mode. If the mode is RGBA (RGB with alpha), LA (grayscale with alpha), or P (palette mode potentially with transparency), it indicates the existence of a transparency channel requiring appropriate handling.

Operating System Compatibility Considerations

It is important to note that the above solution may have compatibility issues across different versions of macOS. Particularly in macOS High Sierra and later, the export interface in Preview might not display the Alpha channel option, or its functionality may behave inconsistently. In such cases, developers need to adopt alternative methods.

One effective alternative is using the "Duplicate" function from the File menu. The specific operation is: after opening the icon file in Preview, select File -> Duplicate, then ensure the Alpha channel is deselected when saving the new file. This method may be more reliable in certain system versions. Another approach involves directly modifying the icon file within the project structure. For example, in cross-platform development frameworks like Ionic, the App Store icon is typically located at [app name]/platforms/ios/[app name]/Images.xcassets/Appicon.appiconset/icon-1024.png. Developers can copy this file to the desktop, resave it in a format without alpha channels using image editing software, and then replace it back in the original location.

In-Depth Technical Principles

From a technical perspective, the alpha channel in digital images represents transparency information, usually stored as an additional data layer. In iOS development, app icons must adhere to specific asset catalog specifications. When an icon contains an alpha channel, it may cause inconsistent rendering across different display environments, particularly on the App Store presentation pages. Apple's requirement to remove alpha channels ensures that icons display correctly on all devices and interfaces, avoiding visual defects due to transparency.

Furthermore, image file metadata can also affect validation results. Some image editing software may embed invisible transparency information when saving files, even if there is no visual transparency effect. Therefore, simple visual inspection is insufficient to confirm file compliance. Developers need to use professional image analysis tools or code validation to ensure the file format fully meets requirements.

Preventive Measures and Best Practices

To prevent the occurrence of ITMS-90717 errors, developers should follow best practices in icon creation from the design phase. First, always use image formats that do not support transparency as the base, such as JPEG. If PNG format is necessary, ensure alpha channels are explicitly disabled in design software. Second, use command-line tools or scripts to batch-check the format of all icon files before integrating them into Xcode projects. For example, the sips command can be used to process images:

# Remove alpha channel from image
sips -s format png --deleteColorManagementProperties --deleteAlpha icon-1024.png -o icon-1024-noalpha.png

This command explicitly removes the alpha channel via the --deleteAlpha parameter, generating a new file that meets requirements. Finally, establishing automated build processes that validate and fix icon formats before app packaging can significantly reduce manual errors.

In summary, while the ITMS-90717 error may appear straightforward, it involves multiple technical aspects including image processing, operating system compatibility, and development toolchains. By deeply understanding the problem's essence, adopting systematic solutions, and incorporating preventive measures, developers can efficiently resolve this common submission obstacle, ensuring smooth app deployment to the App Store.