From b73998f97628aae6cc779129e8609950c441d1e2 Mon Sep 17 00:00:00 2001
From: gain <163835628+leegain1@users.noreply.github.com>
Date: Wed, 23 Sep 2026 02:21:36 +0900
Subject: [PATCH] =?UTF-8?q?chore:=20=EB=B0=B0=ED=8F=AC=20=EB=B9=8C?=
 =?UTF-8?q?=EB=93=9C=EC=9A=A9=20EAS=20=EC=84=A4=EC=A0=95=20=EC=B6=94?=
 =?UTF-8?q?=EA=B0=80=ED=95=98=EA=B3=A0=20.env.example=EC=9D=98=20=EB=A1=9C?=
 =?UTF-8?q?=EC=BB=AC=20IP=20=EC=A0=95=EB=A6=AC?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

.env.example 기본값이 특정 개발 PC의 LAN IP(192.168.0.2)였다. 클론한 사람이
그대로 복사하면 닿지 않는 주소가 기본값이 되는데, 값이 채워져 있어서 설정
문제로 보이지 않는다. localhost로 바꾸고 배포된 dev 주소를 선택지로 안내한다.

EXPO_PUBLIC_*는 빌드 시점에 번들에 박히고 .env.local은 git에 없어서 EAS
클라우드 빌드에 주소를 넘길 방법이 없었다. eas.json을 추가해 프로필별로
주입한다. development는 로컬 metro가 .env.local을 읽으므로 주입하지 않고,
preview는 dev 배포 주소를 쓴다.

production은 운영 주소가 정해지지 않아 비워 뒀다. 값 없이 빌드하면 앱이
안내 화면을 띄우므로 잘못된 주소로 조용히 나가지 않는다.
---
 .env.example              | 10 +++++++---
 README.md                 | 18 ++++++++++++++++++
 docs/local-development.md |  4 ++++
 eas.json                  | 23 +++++++++++++++++++++++
 4 files changed, 52 insertions(+), 3 deletions(-)
 create mode 100644 eas.json

diff --git a/.env.example b/.env.example
index bb825cc..1405351 100644
--- a/.env.example
+++ b/.env.example
@@ -1,12 +1,16 @@
 # 웹뷰로 띄울 stream-client-web 주소.
 # 이 파일을 .env.local로 복사한 뒤 값을 자기 환경에 맞게 채운다.
 #
-# 실행 환경마다 주소가 다르다 (docs/local-development.md 참고):
+# 웹을 직접 띄우지 않고 배포된 dev 환경을 볼 거라면 아래 주소를 그대로 쓰면 된다.
+#   https://dev.stream.billilge.site
+#
+# 웹을 로컬에서 띄운다면 실행 환경마다 주소가 다르다 (docs/local-development.md 참고):
 #   - iOS 시뮬레이터      http://localhost:5173
 #   - Android 에뮬레이터  http://10.0.2.2:5173
 #   - 실제 기기           http://{개발 PC의 LAN IP}:5173
 #
 # LAN IP 확인: ipconfig getifaddr en0
 # 실제 기기는 PC와 같은 네트워크에 있어야 하고, 웹도 pnpm dev --host로 띄워야 한다.
-# 배포 후에는 운영 URL로 바꾼다.
-EXPO_PUBLIC_WEB_URL=http://192.168.0.2:5173
+#
+# 배포 빌드(eas build)는 이 파일을 쓰지 않는다 — eas.json의 프로필별 env로 주입된다.
+EXPO_PUBLIC_WEB_URL=http://localhost:5173
diff --git a/README.md b/README.md
index 23618d9..e911d52 100644
--- a/README.md
+++ b/README.md
@@ -30,8 +30,26 @@ WebView가 띄울 주소는 `.env.local`의 `EXPO_PUBLIC_WEB_URL`로 주입한
 
 실제 기기에서는 `localhost`가 기기 자신을 가리켜 개발 PC에 닿지 않으므로 LAN IP를 써야 하고, 웹도 `pnpm dev --host`로 띄워야 한다.
 
+웹을 직접 띄우지 않고 앱만 볼 거라면 배포된 dev 환경을 가리켜도 된다 — `https://dev.stream.billilge.site`
+
 자세한 실행 방법·준비물·트러블슈팅은 **[docs/local-development.md](docs/local-development.md)** 참고.
 
+### 배포 빌드의 웹 주소
+
+`.env.local`은 로컬 실행 전용이다. `EXPO_PUBLIC_*`는 런타임이 아니라 **빌드 시점에 번들에 문자열로 박히고**, `.env.local`은 git에 올라가지 않아 EAS 클라우드 빌드에는 존재하지 않는다. 그래서 배포 빌드의 주소는 `eas.json`의 프로필별 `env`로 주입한다.
+
+| 프로필 | `EXPO_PUBLIC_WEB_URL` |
+| --- | --- |
+| `development` | 주입하지 않음 — 로컬 metro가 `.env.local`을 읽는다 |
+| `preview` | `https://dev.stream.billilge.site` |
+| `production` | **아직 비어 있음** — 운영 주소가 정해지면 채운다 |
+
+`production`을 비워 둔 값으로 빌드하면 앱이 "웹 주소가 설정되지 않았습니다" 안내 화면을 띄운다. 잘못된 주소로 조용히 배포되는 것보다 낫다고 보고 일부러 채우지 않았다.
+
+번들에 그대로 박히므로 **비밀값은 `EXPO_PUBLIC_*`에 넣지 않는다.** 웹 주소는 공개돼도 되는 값이라 `eas.json`에 평문으로 둔다.
+
+`eas build`를 실제로 돌리려면 `eas init`으로 `app.json`에 `extra.eas.projectId`가 먼저 채워져야 한다.
+
 ## 스크립트
 
 | 명령 | 설명 |
diff --git a/docs/local-development.md b/docs/local-development.md
index 5bafd17..9e1e0fc 100644
--- a/docs/local-development.md
+++ b/docs/local-development.md
@@ -20,6 +20,10 @@ cp .env.example .env.local
 | Android 에뮬레이터 | `http://10.0.2.2:5173` | `10.0.2.2`가 호스트 PC의 `localhost`에 매핑된다 |
 | 실제 기기 (Expo Go) | `http://{개발 PC의 LAN IP}:5173` | 기기와 PC가 같은 네트워크에 있어야 한다 |
 
+웹까지 직접 띄우기 번거로우면 배포된 dev 환경(`https://dev.stream.billilge.site`)을 가리켜도 된다. 이 경우 아래 "2. 웹 서버 띄우기"는 건너뛴다. 다만 웹을 고치면서 보려면 로컬 주소를 써야 한다.
+
+배포 빌드(`eas build`)는 `.env.local`이 아니라 `eas.json`의 프로필별 `env`로 주소를 주입한다 — [README](../README.md#배포-빌드의-웹-주소) 참고.
+
 LAN IP 확인:
 
 ```bash
diff --git a/eas.json b/eas.json
new file mode 100644
index 0000000..6c78890
--- /dev/null
+++ b/eas.json
@@ -0,0 +1,23 @@
+{
+  "cli": {
+    "appVersionSource": "remote"
+  },
+  "build": {
+    "development": {
+      "developmentClient": true,
+      "distribution": "internal"
+    },
+    "preview": {
+      "distribution": "internal",
+      "env": {
+        "EXPO_PUBLIC_WEB_URL": "https://dev.stream.billilge.site"
+      }
+    },
+    "production": {
+      "autoIncrement": true
+    }
+  },
+  "submit": {
+    "production": {}
+  }
+}