从Android Studio安装iOS应用时出现AMDeviceSecureInstallApplicationBundle失败错误

问题背景 #

通过Xcode可正常安装iOS应用，但使用Android Studio部署KMM项目的iOS端时，出现以下错误：

failed transferring /Users/Dylan/StudioProjects/kmm2/build/ios/Debug-iphoneos/iosApp.app. Reason: AMDeviceSecureInstallApplicationBundle failed with err = -402653177(The argument is invalid.)
com.jetbrains.cidr.execution.debugger.backend.DebuggerFatalException: failed transferring /Users/Dylan/StudioProjects/kmm2/build/ios/Debug-iphoneos/iosApp.app. Reason: AMDeviceSecureInstallApplicationBundle failed with err = -402653177(The argument is invalid.)

已确认Xcode与Android Studio使用同一info.plist，且未修改的KMM模板项目也触发该错误，当前环境：Android Studio 2021.2.1 Patch 2、KMM插件0.3.3、Kotlin 1.7.10、Kotlinx Coroutines 1.6.4。

解决方案 #

1. 调整架构匹配配置 #

• 打开Android Studio的运行配置（Run > Edit Configurations），选中对应的iOS运行目标，检查Architecture设置：
  • 若使用Apple Silicon Mac，切换为arm64；若为Intel Mac，选择x86_64
  • 确保项目根目录的build.gradle.kts中iOS架构配置与设备匹配：

    ios {
        binaries {
            framework {
                archs = listOf(Arm64(), X64())
            }
        }
    }
    

2. 清理全链路构建缓存 #

• 关闭Android Studio，删除项目根目录的build文件夹，以及~/.gradle/caches目录
• 打开Xcode，执行Product > Clean Build Folder（快捷键Cmd+Shift+K）
• 重启Android Studio，同步项目后重新尝试安装

3. 修改info.plist的设备能力配置 #

当前info.plist中UIRequiredDeviceCapabilities仅指定armv7，限制了新设备的兼容性，可修改为：

<key>UIRequiredDeviceCapabilities</key>
<array>
    <string>armv7</string>
    <string>arm64</string>
</array>

或直接移除该键，让系统自动适配设备架构。

4. 更新KMM插件并检查签名配置 #

• 升级KMM插件至最新版本：进入Settings > Plugins > Marketplace，搜索Kotlin Multiplatform Mobile并更新（旧版插件存在已知的iOS部署问题）
• 在运行配置的iOS Deployment Target中，确认Signing选项选择了正确的开发者团队与证书，确保签名配置与Xcode一致

5. 验证安装包并排查IDE问题 #

• 手动构建iOS包：在Terminal执行./gradlew iosApp:assembleDebug
• 找到生成的.app文件，通过Xcode的Window > Devices and Simulators拖拽安装：
  • 若手动安装失败：说明构建包存在问题，需检查iOS模块的构建脚本配置
  • 若手动安装成功：重置Android Studio配置（File > Manage IDE Settings > Restore Default Settings）后重试

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