用途:为 Ionic Capacitor 应用配置三类深度链接,让同一套路由代码同时处理自定义 scheme、iOS Universal Links 和 Android App Links。
主要能力:自定义 scheme(如 myapp://reset-password?token=…)无需验证,适合内部流程与 OAuth 回调;iOS Universal Link 与 Android App Link 使用 https://yourapp.com/... 形式,分别通过域名上的 apple-app-site-association 文件和 assetlinks.json 验证,可在未安装应用时回退到网页。资料建议三者配合使用。
使用方式:安装依赖并同步:npm install @capacitor/app 与 npx cap sync。使用 @capacitor/app 的 appUrlOpen 监听器统一接收三种链接;冷启动时还需调用 App.getLaunchUrl(),因为 appUrlOpen 在冷启动下是否触发取决于平台与版本。将 AASA 与 assetlinks.json 放在域名根目录,Content-Type 为 application/json 且不带扩展名。建议为每类用途固定一个路径前缀(如 /auth/、/invite/、/share/),使自定义 scheme 与 Universal/App Link 共用同一路由逻辑,例如按 pathname.startsWith('/auth/') 分发。
适用场景:密码重置、OAuth 回调、magic link、邀请码与分享链接等。
限制与注意:不要仅依赖自定义 scheme 处理密码重置或 OAuth,现代系统与邮件客户端会越来越多地屏蔽它们。测试可用 xcrun simctl openurl(iOS 模拟器)和 adb shell am start -a android.intent.action.VIEW -d "<url>"(Android 模拟器)。资料未提供具体价格、平台版本要求等更多信息。