kotlin-tooling-cocoapods-spm-migration

Migrate Kotlin Multiplatform projects from CocoaPods to Swift Package Manager.

Updated Jul 6, 2026
One-click install
npx skills add https://github.com/shirulot/codex-skill --skill kotlin-tooling-cocoapods-spm-migration-shirulot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kotlin-tooling-cocoapods-spm-migration
Source: https://github.com/shirulot/codex-skill/tree/main/kotlin-tooling-cocoapods-spm-migration
Command: npx skills add https://github.com/shirulot/codex-skill --skill kotlin-tooling-cocoapods-spm-migration-shirulot

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill automates the complex migration of Kotlin Multiplatform projects from the deprecated CocoaPods plugin to the modern Swift Package Manager (SwiftPM) integration, preventing build errors and linkage conflicts.

Core Features & Use Cases

  • Automated Configuration: Safely transitions Gradle build files from native.cocoapods to swiftPMDependencies DSL.
  • Dependency Mapping: Provides a structured path for mapping existing CocoaPods dependencies to their SwiftPM equivalents.
  • Use Case: A developer needs to modernize a large KMP project using Firebase and Google Maps; this skill guides them through the multi-phase process of reconfiguring Xcode build phases, updating Kotlin imports, and cleaning up legacy CocoaPods artifacts.

Quick Start

Run the migration tool to analyze the current project structure and generate the necessary Gradle configuration changes for SwiftPM.

Frequently Asked Questions about kotlin-tooling-cocoapods-spm-migration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate a Kotlin Multiplatform project from CocoaPods to SwiftPM?

Migrating a Kotlin Multiplatform project from CocoaPods to SwiftPM requires transitioning Gradle build files from the native.cocoapods plugin to the swiftPMDependencies DSL. This process also involves updating Kotlin import namespaces and reconfiguring Xcode project build phases to maintain build integrity.

What is the process for replacing CocoaPods dependencies with SwiftPM packages in KMP?

Replacing CocoaPods dependencies with SwiftPM packages in KMP involves a structured dependency mapping to transition existing configurations to their SwiftPM equivalents. It ensures compatibility with modern KMP tooling by safely replacing legacy dependencies while preventing linkage conflicts.

Why do I need to update Kotlin import namespaces when moving from CocoaPods to SwiftPM?

Updating Kotlin import namespaces when moving from CocoaPods to SwiftPM ensures your code correctly references the new SwiftPM package structures. This transformation is a core part of the migration process that guarantees your Kotlin Multiplatform project maintains build integrity.

Can I use SwiftPM integration with complex KMP dependencies like Firebase and Google Maps?

Yes, you can integrate SwiftPM with complex KMP dependencies like Firebase and Google Maps. The migration provides a multi-phase process that guides you through reconfiguring Xcode build phases and mapping these specific dependencies to their SwiftPM equivalents safely.

How do I clean up legacy CocoaPods artifacts after migrating to SwiftPM in Xcode?

Cleaning up legacy CocoaPods artifacts after migrating to SwiftPM involves removing obsolete configurations from your Gradle build files and Xcode project build phases. This step is necessary to prevent build errors and linkage conflicts once the SwiftPM dependencies are fully active.

What are the limitations of migrating KMP projects from CocoaPods to SwiftPM?

The limitations of migrating KMP projects from CocoaPods to SwiftPM center around potential build errors and linkage conflicts if the Gradle configuration and Xcode build phases are not transformed completely. Properly mapping legacy CocoaPods dependencies to SwiftPM packages is required to avoid these issues.