appmigrationkit

Migrate app resources from Android to iOS with AppMigrationKit.

Updated May 6, 2026
One-click install
npx skills add https://github.com/Roy-wonji/claude-config --skill appmigrationkit-roy-wonji
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: appmigrationkit
Source: https://github.com/Roy-wonji/claude-config/tree/main/skills/swift-ios-skills/skills/appmigrationkit
Command: npx skills add https://github.com/Roy-wonji/claude-config --skill appmigrationkit-roy-wonji

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

AppMigrationKit solves the problem of one-time cross-platform migration by transferring an app’s user data from a source device or platform (like Android) to iOS during setup or onboarding.

Core Features & Use Cases

  • Export app resources via an app extension: Package files for transfer using an AppMigrationExtension that conforms to the appropriate exporting protocols.
  • Import resources into the destination app: Receive transferred files and place them into the destination app container with progress reporting and error-aware recovery.
  • Persist migration result for first-launch UI: Check MigrationStatus.importStatus on first launch to show success/failure onboarding flows.
  • Use platform-aware migration logic: Tailor export formats based on destinationPlatform and handle sourceAppIdentifier and sourceVersion on import.
  • Validate with test-only tooling: Use AppMigrationTester in unit tests to verify export/import round trips without production usage.

Use case example: Migrate an existing user from an Android app to your Swift/iOS app by exporting account, profile, and app settings on Android, importing them on iOS during onboarding, and then showing a migration completion screen.

Quick Start

Use the app extension model to implement export and import for one-time onboarding migration, then validate the round-trip behavior with AppMigrationTester in tests.

Frequently Asked Questions about appmigrationkit

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

FAQPage Schema
How do I migrate app data from Android to iOS during onboarding?

Migrate app data from Android to iOS by implementing an AppMigrationExtension that exports resources from the source platform and imports them into the destination iOS app container, preserving user data continuity during device setup.

What is the best way to track cross-platform data migration progress in an iOS app?

Track cross-platform data migration progress by applying defensive import handling with progress updates and error recovery within your AppMigrationExtension. Stream exported items incrementally with ResourcesArchiver to monitor transfer status.

How do I show a migration success or failure screen on first launch in iOS?

Show a migration success or failure screen by checking MigrationStatus.importStatus on first launch. After presenting the appropriate onboarding flow, clear the importStatus to complete the first-launch UX.

Does cross-platform app migration require a special entitlement for data-container access?

Yes, cross-platform app migration requires using the AppMigrationKit entitlement for data-container access. This grants your AppMigrationExtension permission to securely export and import user resources.

How can I test resource export and import round trips without production usage?

Test resource export and import round trips by using AppMigrationTester in unit tests. This test-only tooling validates migration behavior and verifies transfer logic without affecting production usage.

How do I handle different source app versions when importing migration data to iOS?

Handle different source app versions by checking the sourceAppIdentifier and sourceVersion during the import process. Tailor export formats based on destinationPlatform to ensure cross-platform data compatibility.