For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ja/docs/mobile/troubleshooting.md (or send Accept: text/markdown).
モバイルアプリのトラブルシューティング
よくあるプレビュー、設定、ネイティブビルドの失敗をテスターに届く前に修正します。
インストールとセットアップ
アプリがバックエンドに到達できない場合、スマートフォン上の localhost はスマートフォン自身を指すことを思い出してください。コンピューターの LAN アドレス、Android エミュレーターなら 10.0.2.2、または HTTPS のステージング URL を使います。まずそのアドレスをスマートフォンのブラウザで開き、コードを変える前に Wi-Fi、ファイアウォール、VPN を確認してください。Expo トンネルが運ぶのは画面のバンドルであり、API ではありません。
EXPO_PUBLIC_API_URL の欠落や誤りは、サインイン前に設定エラーとして現れます。コールバックが拒否される場合は通常、ビルドのスキームとサーバーの MOBILE_ALLOWED_ORIGINS が一致していないか、ネイティブビルドではなく Expo Go でコールバックが実行されています。
実装ワークフロー
ネイティブ依存関係やスキームを変更したら、Metro を停止し、キャッシュを消去し、開発クライアントを再ビルドしてアプリを再インストールします。JavaScript だけを変更した場合はプレビューの再読み込みで十分です。アプリの Expo SDK バージョンを、端末に入っている Expo Go または開発ビルドと揃えてください。
検証とトラブルシューティング
プレビュー、サインイン、ディープリンクが対象端末で動作します。