ionic-deep-links

ディープリンク（URL スキーム＋ユニバーサルリンク＋アプリリンク）

一緒に使うことが多い、ディープリンクの 3 つの種類です。

種類	形式	検証方法	使用する場面
カスタムスキーム	myapp://reset-password?token=…	なし	内部フロー、OAuth コールバック。簡単に設定できます。誰でもこのスキームを登録できます。
iOS ユニバーサルリンク	https://yourapp.com/reset-password?token=…	ドメイン上の apple-app-site-association ファイル	アプリを開くか、ウェブにフォールバックするブランド付きリンク。
Android アプリリンク	https://yourapp.com/reset-password?token=…	ドメイン上の assetlinks.json	Android でユニバーサルリンクと同じ目的に使用します。

洗練されたアプリでは、通常 3 種類すべてを使います。1 つの URL を iOS と Android の両方で使えるようにし（ユニバーサルリンク／アプリリンク）、検証済みリンクが使えない場合に備えて、カスタムスキームをフォールバックとして用意します。

参照する場面

• カスタム URL スキーム＋@capacitor/app リスナー：custom-scheme.md
• iOS ユニバーサルリンク（エンタイトルメント＋AASA ファイル）：ios-universal-links.md
• Android アプリリンク（インテントフィルター＋assetlinks.json）：android-app-links.md
• リンクからページへのルーティング：routing.md

標準 URL 形式

用途ごとにパスのプレフィックスを 1 つ選び、カスタムスキーム、ユニバーサルリンク、アプリリンク全体で一貫して使うと、同じルーターコードですべてを処理できます。

用途	カスタムスキーム	ユニバーサルリンク／アプリリンク
認証（リセット／OAuth コールバック／マジックリンク）	myapp://auth/<flow>?...	https://yourapp.com/auth/<flow>?...
招待	myapp://invite/<code>	https://yourapp.com/invite/<code>
共有	myapp://share/<id>	https://yourapp.com/share/<id>

このスキャフォールドでは、認証パスを ionic-firebase、ionic-supabase、およびパスワードリセット／OAuth コールバックのフローで共通して使用します。

• マジックリンク：https://yourapp.com/auth/finish-signin?...
• パスワードリセット：myapp://auth/reset-password?token=...
• OAuth コールバック（Supabase）：myapp://auth/callback#access_token=...

ディープリンクハンドラーのルーティングロジックは pathname.startsWith('/auth/') で判定し、適切なフローに処理を委譲します。

厳守事項

• ✅ @capacitor/app の appUrlOpen リスナーを使用してください。3 種類すべてで一貫して呼び出されます。
• ✅ AASA／assetlinks.json ファイルは、適切な Content-Type（application/json、拡張子なし）でドメインのルートに配置してください。
• ✅ xcrun simctl openurl（iOS シミュレーター）と adb shell am start -a android.intent.action.VIEW -d "<url>"（Android エミュレーター）でテストしてください。
• ❌ パスワードリセット／OAuth でカスタムスキームだけに依存しないでください。最近の OS バージョンやメールクライアントでは、カスタムスキームが抑制されるケースが増えています。
• ❌ コールドスタート時に App.getLaunchUrl() を呼び出し忘れないでください。コールドスタート時には appUrlOpen が確実に呼び出されない場合があります（多くの Capacitor バージョンでは呼び出されますが、動作はプラットフォームやバージョンによって異なります）。念には念を入れて、起動時に必ず一度 getLaunchUrl() を確認してください。

ライブラリ

npm install @capacitor/app
npx cap sync