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/local-setup.md (or send Accept: text/markdown).
モバイルアプリを実行する
Expo を到達可能な開発 API に接続する。
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. を使用します。
corepack pnpm install2. バックエンドアドレスを見つけてテストする
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:
ipconfig3. モバイルアプリの設定ファイルを作成する
エディターのエクスプローラーで、「アプリ」→「モバイル」を展開し、.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=off4. 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 start5. プレビューエラーから回復し、実際のフローをテストする
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 を押します。終了したらバックエンドを個別に停止します。
corepack pnpm --filter @supastack/mobile start --clear設定を続けるには、ネイティブ認証をご覧ください。