Skip to content

docs(skills): add native v6 migration guidance#9

Draft
kherembourg wants to merge 4 commits into
mainfrom
feat/migration_v6
Draft

docs(skills): add native v6 migration guidance#9
kherembourg wants to merge 4 commits into
mainfrom
feat/migration_v6

Conversation

@kherembourg

@kherembourg kherembourg commented May 27, 2026

Copy link
Copy Markdown
Contributor

Contexte

Le skill migrate ne couvrait que la migration Android v5.x → 6.0.0 et bloquait explicitement iOS (« Do not work on iOS migration yet »). Ce travail ajoute le volet iOS (Swift), dérivé de la migration v6 réelle effectuée sur l'app de démo Shaker.

Changements

  • Nouveau purchasely/references/ios/migration-v6.md — checklist iOS v5→v6 :
    • dépendance SPM/CocoaPods → 6.0.0 + workaround package Swift local pour le snapshot develop (pas de Package.swift racine)
    • Swift 6 strict concurrency (@preconcurrency import, tests en minimal)
    • init fluent Purchasely.apiKey(...).…start { error in } (completion Error?)
    • .paywallObserver.observer, readyToOpenDeeplinkallowDeeplink, isDeeplinkHandledhandleDeeplink
    • intercepteurs typés interceptAction(.login/.navigate/.purchase/.restore) asyncPLYInterceptResult
    • pont Observer mode (iOS async → pas de suspendCancellableCoroutine, contrairement à Android)
    • fetchPresentationPLYPresentationBuilder.from(...).build().preload { }, résultat → PLYPresentationOutcome
    • embedded paywall → presentation.controller wrappé en UIViewControllerRepresentable
    • APIs inchangées + checklist de vérif xcodebuild
  • Modifié purchasely/skills/migrate/SKILL.md — description Android + iOS, suppression du gate iOS, arguments android|ios, section « Mandatory Workflow — iOS » (11 étapes).
  • Modifié purchasely/commands/migrate.mdargument-hintandroid|ios.

🤖 Generated with Claude Code


Android v6 Presentation guidance added

  • Refreshed Android API and migration references for PLYPresentation builder/preload/display.
  • Documented canonical Android screenId, PLYPresentationState, PLYPresentationOutcome, typed action interceptors, Observer-mode bridge, and optional presentation-compose.
  • Updated native Android SDK pin to 6.0.0 in sdk-versions.md.
  • Verified plugin layout with rtk npx --yes skills add . --list.

kherembourg and others added 3 commits May 22, 2026 18:19
- purchasely/skills/migrate/SKILL.md — workflow for Android v5.x -> v6.0.0 migration.
- purchasely/references/android/migration-v6.md — detailed API mapping, AGP 9 / kotlin.android conflict, Observer-mode suspend bridge, Billing v8 upgrade.
- purchasely/commands/migrate.md — /purchasely:migrate entrypoint.

Captures the Shaker PR #9 migration: Kotlin DSL Purchasely { ... } init, mavenLocal opt-in, kotlin.android removal under AGP 9, kotlinOptions removal, and the suspendCancellableCoroutine bridge to keep Observer mode working under v6's suspend interceptors.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Extend the migrate skill beyond Android: add the iOS Swift v5.x -> 6.0.0
reference, an iOS workflow section in SKILL.md, and remove the
"do not work on iOS migration yet" gate. Derived from the Shaker iOS v6
migration (fluent init, typed interceptors, PLYPresentationBuilder,
PLYPresentationOutcome, embedded UIViewControllerRepresentable).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@kherembourg kherembourg changed the title feat(skills): add iOS v5->v6 migration to migrate skill docs(skills): add native v6 migration guidance May 28, 2026
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant