> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# モバイルアプリのトラブルシューティング

よくあるプレビュー、設定、ネイティブビルドの失敗をテスターに届く前に修正します。

## インストールとセットアップ

アプリがバックエンドに到達できない場合、スマートフォン上の `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 または開発ビルドと揃えてください。


## 検証とトラブルシューティング

プレビュー、サインイン、ディープリンクが対象端末で動作します。


## 次へ

[デスクトップ概要](https://supastack.dev/ja/docs/desktop.md)