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

# モバイルアプリを5分で起動

電話またはシミュレーターで Expo アプリを開き、デバイスが到達できる API アドレスを構成し、UI プレビューと実際のサインインおよびネイティブ購入を区別します。

## 1. コンピューター、電話、バックエンドを準備する

開始してエディターでモバイル リポジトリまたはすべてのプラットフォームのモノリポジトリを開く前に完了してください。リポジトリ ルートの [ターミナル] → [新しいターミナル] で、以下のインストール コマンドを実行します。完了するまで待ちます。以下にリンクされている公式 Expo ページを使用して、Expo Go を携帯電話にインストールします。そのバージョンは、apps/mobile/package.json. に記録されている Expo SDK バージョンをサポートする必要があります

バックエンドは、サインイン、ワークスペース データ、AI リクエストを処理する Web サーバーです。チェックアウトに apps/web が含まれている場合は、まず別の端末で Web セットアップを実行し、そのサーバーを実行したままにしてください。ネイティブ サインアップまたはサインインを試す前に、Postgres セットアップを完了してください。モバイル専用チェックアウトには apps/web が含まれていません。代わりに、実行中の個別に提供されるバックエンドに接続してください。 Expo を起動すると、バックエンドではなく、画面プレビュー サーバーが起動します。

携帯電話とコンピュータを同じ Wi-Fi に接続します。 VPN がローカル接続をブロックする場合は、一時的に切断します。電話機の localhost は電話機自体を意味します。物理的な電話または Android デバイスには、コンピュータのプライベート ネットワーク アドレスを使用します。同じ Mac 上の iOS シミュレーターは http://localhost:3000, を使用でき、Android エミュレーターは通常 http://10.0.2.2:3000. を使用します。

[ツールをインストールしてコードを取得](https://supastack.dev/ja/docs/web/before-you-start.md)

[コマンドの実行方法とファイルの編集方法を学ぶ](https://supastack.dev/ja/docs/web/terminal-basics.md)

[Webバックエンドの起動](https://supastack.dev/ja/docs/web/ship-in-5-minutes.md)

[プロジェクトと互換性のある Expo Go バージョンをインストールしてください](https://expo.dev/go)

```
corepack pnpm install
```


## 2. バックエンドアドレスを見つけてテストする

Windows では、新しい PowerShell ターミナルで ipconfig を実行し、アクティブな Wi-Fi アダプターを見つけて、IPv4 アドレスを読み取ります。 macOS では、システム設定 → Wi-Fi → 詳細 → TCP/IP を開き、IP アドレスを読み取ります。 Linux では、ネットワーク設定を開き、IPv4 アドレスを読み取ります。アドレスは 192.168.1.25 のようになります。あなたのものは通常は異なるでしょう。

コンピュータのアドレスが 192.168.1.25 の場合は、Web サーバーの実行中に電話機のブラウザで http://192.168.1.25:3000 を開きます。実際の住所に置き換えてください。続行する前にホームページを読み込む必要があります。 Windows ファイアウォールから要求された場合は、プライベート ネットワーク上の Node アプリを許可します。ロードされない場合は、アドレス、Wi-Fi、ファイアウォール、実行中の Web サーバーを確認してください。 Expo トンネルはプレビュー バンドルのみを伝送し、別の API に到達可能にすることはありません。

```
# Windows PowerShell only:
ipconfig
```


## 3. モバイルアプリの設定ファイルを作成する

エディターのエクスプローラーで、「アプリ」→「モバイル」を展開し、.env.local という名前の新しいファイルを作成し、そのファイルに以下の構成を貼り付けます。 192.168.1.25 を先ほどテストしたアドレスに置き換えるか、指定した HTTPS バックエンド アドレスを使用します。ファイルを保存します。そのフルパスは apps/mobile/.env.local です。 root .env は、Expo によって自動的に読み取られません。

最初のプレビューでは、携帯電話の購入設定をオフのままにしておきます。 EXPO_PUBLIC_ は、設定が電話アプリに含まれていることを意味するため、これらの値にはパブリック URL、スキーム、およびパブリック クライアント設定のみを含める必要があります。 AI プロバイダー、データベース、または請求の秘密をここに貼り付けないでください。 Web サーバーには独自の apps/web/.env.local があります。 Mobile ファイルを変更してもサーバーは変更されません。

```
EXPO_PUBLIC_API_URL=http://192.168.1.25:3000
EXPO_PUBLIC_APP_SCHEME=supastack
EXPO_PUBLIC_MOBILE_PURCHASES_PROVIDER=off
```


## 4. Expoを起動し、プレビューを開きます

リポジトリのルートから、以下のコマンドを実行します。 QR コードと Metro 待機メッセージが表示されるまで待ちます。このターミナルとバックエンドターミナルを開いたままにしておきます。 Android では、Expo Go を開いて QR コードをスキャンします。 iPhone ではカメラを使用し、コードをスキャンして Expo Go で開きます。 QR コードは、バックエンドのホームページではなく、開発アプリを開きます。

成功すると、デバイス上でアプリのサインイン画面が開きます。購入をオフにした場合、これは UI プレビューです。サインイン、保存されたワークスペース、またはチャットをテストする前に、データベースに基づく Web 認証のセットアップを完了してください。インストールされているシミュレーターがターゲットの場合は、Android の場合は Expo ターミナルで a を押し、iOS の場合は i を押します。 iOS シミュレーターには macOS と Xcode が必要です。 Windows では実行できません。

```
corepack pnpm --filter @supastack/mobile start
```


## 5. プレビューエラーから回復し、実際のフローをテストする

Expo Go が互換性のないプロジェクトを報告した場合は、サポートされている SDK と apps/mobile/package.json を比較し、公式 Expo ページから互換性のあるバージョンを使用してください。メッセージを無視するためだけにキットの依存関係のバージョンをアップグレードしないでください。必要なネイティブ モジュールが利用できない場合は、モバイル ビルドに従って、そのモジュールを含む開発ビルドを実行します。

ネットワーク エラーでサインインが失敗した場合は、まず電話機のブラウザでバックエンド URL を再試行します。 URL は動作するが、サインインが失敗する場合は、バックエンド端末を検査し、Postgres と移行を確認します。ローカルの /dashboard デモ セッションでは、電話ではサインインしません。構成が古いと思われる場合は、Expo ターミナルで Ctrl + C を押し、以下の再起動コマンドを実行してプレビューを再度開きます。

Expo Go は、実際の StoreKit または Play Billing の購入/復元行動を証明できません。アプリ内購入とモバイル ビルドに従って、EAS 開発ビルドとストア テスト アカウントを取得します。初めてのネイティブ ビルドとアカウント登録には 5 分以上かかる場合があります。このプレビューを停止するには、Expo 端末で Ctrl + C を押します。終了したらバックエンドを個別に停止します。

[ネイティブ サインインのセットアップとテスト](https://supastack.dev/ja/docs/mobile/authentication.md)

[ネイティブ開発ビルドの作成](https://supastack.dev/ja/docs/mobile/builds.md)

[ネイティブの購入と復元を構成する](https://supastack.dev/ja/docs/mobile/revenuecat.md)

```
corepack pnpm --filter @supastack/mobile start --clear
```


## 次へ

[モバイルアプリを実行する](https://supastack.dev/ja/docs/mobile/local-setup.md)