ios-icon-fix

专门处理 iOS 应用图标中的透明通道问题,将带 alpha 的 PNG 图标统一合成到白色背景上并移除透明度,确保符合 App Store 对图标无透明像素的强制要求,适用于构建发布前的自动化校验与修复流程。

快捷安装

在终端运行此命令,即可一键安装该 Skill 到您的 Claude 中

npx skills add decentpaste/decentpaste --skill "ios-icon-fix"

iOS Icon Fix

Remove alpha channel from iOS app icons to comply with Apple App Store requirements.

When to Use

  • Before uploading to App Store Connect / TestFlight
  • After regenerating iOS app icons
  • When you see error: “Invalid large app icon… can’t be transparent or contain an alpha channel”

Usage

Run the script:

python3 .claude/skills/ios-icon-fix/scripts/remove_alpha.py

Or specify a custom path:

python3 .claude/skills/ios-icon-fix/scripts/remove_alpha.py path/to/AppIcon.appiconset

What It Does

  1. Finds all PNG icons in the appiconset directory
  2. For each icon with alpha channel:
    • Creates white background
    • Composites the icon onto it
    • Saves without alpha
  3. Verifies all icons have no transparency

Requirements

  • Python 3
  • Pillow: pip install Pillow

Default Icon Location

decentpaste-app/src-tauri/gen/apple/Assets.xcassets/AppIcon.appiconset/