如何为Kotlin Multiplatform项目中的iOS模块创建并添加应用图标？

步骤1：创建标准的Asset Catalog目录结构 #

• 在你的iOS模块根目录（即iosApp文件夹内）新建Assets.xcassets文件夹
• 进入Assets.xcassets，再创建AppIcon.appiconset子文件夹（苹果规定应用图标必须放在这个命名的文件夹下）
• 在AppIcon.appiconset里新建Contents.json文件——这是核心配置文件，之前只放PNG没配这个才导致图标不生效

步骤2：准备图标并配置Contents.json #

• 准备苹果要求的全尺寸应用图标：覆盖iPhone、iPad、通知栏、设置页等场景，每个基础尺寸要对应@1x、@2x、@3x版本（比如20x20@2x对应40x40像素，@3x对应60x60像素）
• 把所有图标文件放到AppIcon.appiconset里，命名建议清晰，比如app-icon-20@2x.png
• 编辑Contents.json，填入以下示例配置（替换成你的实际文件名）：

{
  "images" : [
    {
      "idiom" : "iphone",
      "size" : "20x20",
      "scale" : "2x",
      "filename" : "app-icon-20@2x.png"
    },
    {
      "idiom" : "iphone",
      "size" : "20x20",
      "scale" : "3x",
      "filename" : "app-icon-20@3x.png"
    },
    {
      "idiom" : "iphone",
      "size" : "29x29",
      "scale" : "2x",
      "filename" : "app-icon-29@2x.png"
    },
    {
      "idiom" : "iphone",
      "size" : "29x29",
      "scale" : "3x",
      "filename" : "app-icon-29@3x.png"
    },
    {
      "idiom" : "iphone",
      "size" : "60x60",
      "scale" : "2x",
      "filename" : "app-icon-60@2x.png"
    },
    {
      "idiom" : "iphone",
      "size" : "60x60",
      "scale" : "3x",
      "filename" : "app-icon-60@3x.png"
    },
    {
      "idiom" : "ipad",
      "size" : "20x20",
      "scale" : "1x",
      "filename" : "app-icon-20@1x.png"
    },
    {
      "idiom" : "ipad",
      "size" : "20x20",
      "scale" : "2x",
      "filename" : "app-icon-20@2x.png"
    },
    {
      "idiom" : "ipad",
      "size" : "29x29",
      "scale" : "1x",
      "filename" : "app-icon-29@1x.png"
    },
    {
      "idiom" : "ipad",
      "size" : "29x29",
      "scale" : "2x",
      "filename" : "app-icon-29@2x.png"
    },
    {
      "idiom" : "ipad",
      "size" : "76x76",
      "scale" : "1x",
      "filename" : "app-icon-76@1x.png"
    },
    {
      "idiom" : "ipad",
      "size" : "76x76",
      "scale" : "2x",
      "filename" : "app-icon-76@2x.png"
    },
    {
      "idiom" : "ipad",
      "size" : "83.5x83.5",
      "scale" : "2x",
      "filename" : "app-icon-83.5@2x.png"
    }
  ],
  "info" : {
    "version" : 1,
    "author" : "xcode"
  }
}

步骤3：在Xcode中关联Asset Catalog到项目 #

• 打开iOS模块里的.xcodeproj文件（比如iosApp.xcodeproj）
• 选中顶部的项目名称，切换到Build Settings标签，搜索Asset Catalogs（在Asset Catalog Compiler - Options分类下）
• 点击输入框，添加Assets.xcassets的路径（如果是在模块根目录，直接填Assets.xcassets即可）
• 再切换到General标签，找到App Icons and Launch Images区域，在App Icon Source下拉菜单里选择AppIcon（就是我们刚创建的图标集）

步骤4：验证图标生效 #

• 先清理Xcode缓存：菜单栏选择Product > Clean Build Folder
• 运行项目到模拟器或真机，就能看到应用图标正常显示了

注意事项 #

• 图标尺寸必须严格符合苹果要求，否则可能不显示或被拉伸变形
• Contents.json里的filename要和实际图标文件名完全一致，大小写也要对应
• 如果是Linux环境下操作（无法打开Xcode），可以手动编辑.xcodeproj里的project.pbxproj文件添加Asset Catalog引用，但操作较复杂，建议尽量在Mac上用Xcode完成配置

内容的提问来源于stack exchange，提问作者HendrikFrans