> ## 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

# モバイルアプリを設定する

ネイティブビルドが使うバックエンドのアドレスとディープリンクスキームを設定し、受け渡しの両側を同期させます。

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

端末向けの値は `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 を再起動し、対象端末でプレビューを開きます。テーマを変更してアプリを再起動し、選択が残ることを確認します。次にディープリンクを発火し、ブラウザではなくアプリが処理することを確かめてください。


設定を続けるには、[モバイルアプリをテストする](https://supastack.dev/ja/docs/mobile/testing.md)をご覧ください。


## 次へ

[モバイルアプリをテストする](https://supastack.dev/ja/docs/mobile/testing.md)