Android Studio Kotlin多平台项目：Activity生成异常与Cocoapods配置问题

问题1：Activity创建路径错误 #

• 原因：Android Studio的Activity模板默认适配普通Android模块的main源集，未正确识别Kotlin多平台项目中androidMain的特殊源集结构，导致创建时自动生成到新的Main目录。
• 解决步骤：
  1. 手动在shared/src/androidMain/kotlin/[你的包路径]下创建Activity文件，可从普通Android模块的Activity模板拷贝基础代码。
  2. 检查shared/build.gradle.kts中的Android配置，确保androidMain被正确关联：

     android {
         sourceSets["main"].setRoot("src/androidMain")
         // 或确认kotlin.sourceSets.androidMain的配置指向正确路径
     }
     

  3. 若需使用模板创建，可修改Android Studio模板配置：打开Settings > Editor > File and Code Templates > Android > Activity，将模板中的src/main替换为src/androidMain。

问题2：Cocoapods版本指定无效导致Gradle同步失败 #

• 原因：KMP中Cocoapods的版本必须在kotlin.cocoapods代码块内指定，而非其他位置；另外Windows环境默认缺少Cocoapods运行依赖的Ruby环境，也会导致识别异常。
• 解决步骤：
  1. 修正shared/build.gradle.kts中的Cocoapods配置，确保版本指定在正确位置：

     kotlin {
         cocoapods {
             version = "1.0" // 必须放在该代码块内
             summary = "Shared module for Kotlin Multiplatform"
             homepage = "Link to your project homepage"
         }
     }
     

  2. 若当前不需要iOS平台支持，可直接注释或移除Cocoapods相关配置，跳过依赖检查：

     // kotlin {
     //     cocoapods {
     //         // 移除或注释所有Cocoapods配置
     //     }
     // }
     

  3. 若需要iOS支持，Windows环境需先安装依赖：
     • 用RubyInstaller安装Ruby，确保添加到系统环境变量。
     • 执行命令gem install cocoapods安装Cocoapods，完成后重新同步Gradle。

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