移动开发

capacitor-deep-linking

Name: capacitor-deep-linking
Author: cap-go

cap-go/capgo-skills

Implements and debugs deep links in Capacitor apps - custom URL schemes, iOS Universal Links (apple-app-site-association, Associated Domains entitlement), Android App Links (assetlinks.json, autoVerify), and routing via @capacitor/app `appUrlOpen` + `App.getLaunchUrl()`. Covers the Capacitor 8.5+ UIScene change where AppDelegate `application(_:open:options:)` and `continue userActivity` stop being called and custom handling must move to SceneDelegate, plus cold vs warm launch testing. Use when links open Safari/Chrome instead of the app, `appUrlOpen` never fires, the launch URL is lost on cold start, or OAuth redirects do not return to the app. Do not use for the full UIScene migration (capacitor-uiscene-migration), push notification taps (capacitor-push-notifications), or social login plugin setup (capacitor-plugins).

1286 次安装
74 星标
收录于 2026.01.25

安装命令

$ npx skills add https://github.com/cap-go/capgo-skills --skill capacitor-deep-linking

SKILL.md

Deep Linking in Capacitor

Route custom-scheme links, iOS Universal Links, and Android App Links into the web app.

When to Use

TRIGGER when:

Adding myapp:// schemes, Universal Links, or App Links to a Capacitor app
Links open the browser instead of the app, or open the app but land on the home page
appUrlOpen fires on warm open but the URL is missing on cold launch (or the reverse)
Deep links broke after updating to Capacitor 8.5+ / adopting SceneDelegate.swift
OAuth / magic-link / payment redirects must come back into the app
adb shell pm get-app-links shows none or 1024 instead of verified

Do not use:

Full AppDelegate -> SceneDelegate migration of an app: capacitor-uiscene-migration
Notification tap routing: capacitor-push-notifications
Native log capture while debugging: ios-android-logs
Sign in with Apple / Google plugin config: capacitor-plugins

SKILL.md

Deep Linking in Capacitor

When to Use

相关 Skills