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/configuration.md (or send Accept: text/markdown).
モバイルアプリを設定する
ネイティブビルドが使うバックエンドのアドレスとディープリンクスキームを設定し、受け渡しの両側を同期させます。
インストールとセットアップ
端末向けの値は apps/mobile/.env.local に置きます。Expo が読むのはこのファイルで、リポジトリ直下の .env ではありません。EXPO_PUBLIC_API_URL はスマートフォンから到達できる Web バックエンドのオリジンで、スマートフォンのブラウザで確認したものと同じ値です。EXPO_PUBLIC_APP_SCHEME はアプリのネイティブ URI スキームで、com.example.app のような逆 DNS 形式を使います。
app.json は製品名、スラッグ、バージョン、バンドル ID、プラグインを管理します。app.config.ts は EXPO_PUBLIC_APP_SCHEME からディープリンクスキームと本番オリジンを導出するため、スキームの変更には Metro の再起動ではなくネイティブの再ビルドが必要です。サーバーではアプリが使うすべてのオリジンを MOBILE_ALLOWED_ORIGINS に追加してください。両側が一致しない場合、受け渡しは安全側で失敗します。
EXPO_PUBLIC_* の値はすべてアプリにバンドルされます。プロバイダーキーはサーバーに置き、公開値はアドレスとスキームだけに使ってください。
EXPO_PUBLIC_API_URL=http://192.168.1.25:3000
EXPO_PUBLIC_APP_SCHEME=com.example.app実装ワークフロー
.env.local を変更したら Expo を再起動します。パッケージのテストと型チェックを実行し、開発ビルドで解決されたスキームを確認します。認証コールバックのリンクを開き、ブラウザではなくアプリに戻ることを確かめてください。Expo Go ではネイティブビルド固有のカスタムスキームを検証できません。
検証とトラブルシューティング
.env.local を変更したら Expo を再起動し、対象端末でプレビューを開きます。テーマを変更してアプリを再起動し、選択が残ることを確認します。次にディープリンクを発火し、ブラウザではなくアプリが処理することを確かめてください。
設定を続けるには、モバイルアプリをテストするをご覧ください。