@zsukim/ctv-run 1.0.0 → 1.0.2

package/README.md

@@ -1,4 +1,4 @@
-# 📺 ctv-run
+# ctv-run
 
 > React, Vue 등 **웹 기술로 만든 TV 앱**을 Vizio, LG webOS, Fire TV, Samsung Tizen에 배포하고 실행하는 CLI 도구입니다.
 
@@ -22,7 +22,7 @@
 
 | 모드 | 옵션 | 설명 |
 |------|------|------|
-| **Live Mode** | (기본값) | 개발 서버 URL을 TV에 주입. HMR 지원 |
+| **Live Mode** | (기본값) | TV가 로드할 URL을 TV에 주입. HMR 지원 |
 | **Static Mode** | `--target=dist` | 빌드 결과물을 TV에 직접 설치 |
 
 > **Vizio**는 구조상 항상 URL이 필요하므로 Live Mode만 지원합니다.
@@ -31,31 +31,16 @@
 
 ## ctv.config.json
 
-프로젝트 루트에 생성하면 CLI 옵션을 생략할 수 있습니다. CLI 옵션이 항상 우선합니다.
+프로젝트 루트에 생성하면 CLI 옵션을 생략할 수 있습니다. 사용하는 플랫폼의 설정만 추가하면 됩니다. CLI 옵션이 항상 우선합니다.
 
 ```json
 {
   "vizio": {
-    "ip": "192.168.11.27",
-    "url": "http://192.168.11.10:3300"
-  },
-  "fire": {
-    "ip": "192.168.11.20",
-    "package": "com.example.tvapp",
-    "url": "http://192.168.11.10:3300",
-    "adbPath": "/usr/local/bin/adb",
-    "androidAssetsPath": "/path/to/android/app/src/main/assets"
+    "ip": "192.168.x.x",
+    "url": "http://192.168.x.x:3300"
   },
   "tizen": {
-    "ip": "192.168.11.30",
-    "appId": "A123456789.MyApp"
-  },
-  "webos": {
-    "deviceName": "my-lg-tv",
-    "appId": "com.example.tvapp"
-  },
-  "common": {
-    "devServerPort": 3300
+    "ip": "192.168.x.x"
   }
 }
 ```
@@ -66,16 +51,19 @@
 
 | Field | 필수 | Description |
 |-------|------|-------------|
-| `ip` | ✅ | Vizio TV 로컬 IP |
-| `url` | | TV에서 로드할 개발 서버 URL |
+| `ip` | ✅ | TV 로컬 IP |
+| `url` | | TV가 로드할 URL |
+| `port` | | TV가 로드할 URL의 포트 |
 
 **Fire TV**
 
 | Field | 필수 | Description |
 |-------|------|-------------|
-| `ip` | ✅ | Fire TV 로컬 IP |
+| `ip` | ✅ | TV 로컬 IP |
 | `package` | ✅ | Android 앱 패키지명 |
-| `url` | | Live Mode에서 주입할 개발 서버 URL |
+| `url` | | TV가 로드할 URL |
+| `port` | | TV가 로드할 URL의 포트 |
+| `activity` | | 실행할 Activity (기본값: `.MainActivity`) |
 | `adbPath` | | adb 실행 경로 (기본값: `adb`) |
 | `androidAssetsPath` | Static Mode 시 ✅ | dist 파일이 복사될 Android `assets` 폴더 절대 경로 |
 
@@ -83,7 +71,9 @@
 
 | Field | 필수 | Description |
 |-------|------|-------------|
-| `ip` | ✅ | Samsung Tizen TV 로컬 IP |
+| `ip` | ✅ | TV 로컬 IP |
+| `url` | | TV가 로드할 URL |
+| `port` | | TV가 로드할 URL의 포트 |
 | `appId` | | Tizen 앱 고유 ID (없으면 자동 생성) |
 
 **WebOS**
@@ -91,13 +81,15 @@
 | Field | 필수 | Description |
 |-------|------|-------------|
 | `deviceName` | ✅ | ares-cli에 등록된 기기 이름 |
+| `url` | | TV가 로드할 URL |
+| `port` | | TV가 로드할 URL의 포트 |
 | `appId` | | webOS 앱 ID (기본값: `com.ctvrun.app`) |
 
 **Common**
 
 | Field | Description |
 |-------|-------------|
-| `devServerPort` | Live Mode에서 사용할 개발 서버 포트 (기본값: `3000`) |
+| `devServerPort` | 모든 플랫폼에 공통으로 적용할 포트 (기본값: `3000`) |
 
 > 💡 TV IP가 개발자마다 다를 수 있으므로 `ctv.config.json`은 `.gitignore`에 추가하고, `ctv.config.sample.json`을 저장소에 공유하는 것을 권장합니다.
 
@@ -118,6 +110,9 @@ npx playwright install chromium
 ADB가 설치되어 있어야 하며, TV에서 **개발자 옵션 → ADB 디버깅**이 활성화되어 있어야 합니다.
 
 ```bash
+# macOS — ADB 설치
+brew install --cask android-platform-tools
+
 # 연결 확인
 adb devices
 ```
@@ -186,7 +181,7 @@ ares-setup-device --list
 # URL 직접 지정
 ctv-run vizio --ip=192.168.11.27 --url=http://192.168.11.10:3300
 
-# 포트만 지정 (로컬 IP 자동 감지)
+# 포트만 지정 → http://[내 PC IP]:3300 으로 자동 조합
 ctv-run vizio --ip=192.168.11.27 --port=3300
 ```
 
@@ -199,10 +194,10 @@ Playwright로 Vizio 웹 런처를 자동 조작하여 페어링(PIN 입력) 후
 ### Fire TV
 
 ```bash
-# Live Mode — 개발 서버 URL 주입
+# URL 직접 지정
 ctv-run fire --url=http://192.168.11.10:3300
 
-# Live Mode — 포트만 지정
+# 포트만 지정 → http://[내 PC IP]:3300 으로 자동 조합
 ctv-run fire --port=3300
 
 # Static Mode — dist를 Android assets에 복사 후 로컬 실행
@@ -221,8 +216,11 @@ ctv-run fire --target=dist
 ### Tizen
 
 ```bash
-# Live Mode — 개발 서버로 리다이렉트하는 앱 설치 후 실행
-ctv-run tizen --ip=192.168.11.30
+# URL 직접 지정
+ctv-run tizen --ip=192.168.11.30 --url=http://192.168.11.10:3300
+
+# 포트만 지정 → http://[내 PC IP]:3300 으로 자동 조합
+ctv-run tizen --ip=192.168.11.30 --port=3300
 
 # Static Mode — dist를 .wgt로 패키징하여 TV에 설치
 ctv-run tizen --ip=192.168.11.30 --target=dist
@@ -242,8 +240,11 @@ ctv-run tizen --ip=192.168.11.30 --target=dist
 ### WebOS
 
 ```bash
-# Live Mode — 개발 서버로 리다이렉트하는 앱 설치 후 실행
-ctv-run webos --device=my-lg-tv
+# URL 직접 지정
+ctv-run webos --device=my-lg-tv --url=http://192.168.11.10:3300
+
+# 포트만 지정 → http://[내 PC IP]:3300 으로 자동 조합
+ctv-run webos --device=my-lg-tv --port=3300
 
 # Static Mode — dist를 .ipk로 패키징하여 TV에 설치
 ctv-run webos --device=my-lg-tv --target=dist

package/dist/platforms/tizen.js

@@ -21,7 +21,7 @@ const ip_1 = require("../utils/ip");
 const platform_1 = require("../utils/platform");
 function runTizen() {
     return __awaiter(this, void 0, void 0, function* () {
-        var _a, _b, _c;
+        var _a, _b, _c, _d, _e;
         const config = (0, config_1.loadConfig)();
         const args = process.argv.slice(2);
         const getArg = (0, platform_1.makeArgParser)(args);
@@ -32,8 +32,10 @@ function runTizen() {
         }
         const targetArg = getArg('target');
         const isLiveMode = !targetArg;
+        const port = getArg('port') || ((_b = config.tizen) === null || _b === void 0 ? void 0 : _b.port) || ((_c = config.common) === null || _c === void 0 ? void 0 : _c.devServerPort) || 3000;
         const appUrl = getArg('url') ||
-            `http://${(0, ip_1.getLocalIp)()}:${((_b = config.common) === null || _b === void 0 ? void 0 : _b.devServerPort) || 3000}`;
+            ((_d = config.tizen) === null || _d === void 0 ? void 0 : _d.url) ||
+            `http://${(0, ip_1.getLocalIp)()}:${port}`;
         const tempAppDir = path_1.default.resolve(process.cwd(), '.ctv-run-tizen');
         if (fs_extra_1.default.existsSync(tempAppDir))
             fs_extra_1.default.removeSync(tempAppDir);
@@ -66,7 +68,7 @@ function runTizen() {
                 xmlInfo = getInfoFromXml(process.cwd());
             const appId = getArg('appId') ||
                 (xmlInfo === null || xmlInfo === void 0 ? void 0 : xmlInfo.appId) ||
-                ((_c = config.tizen) === null || _c === void 0 ? void 0 : _c.appId) ||
+                ((_e = config.tizen) === null || _e === void 0 ? void 0 : _e.appId) ||
                 'A123456789.CtvRunApp';
             const safeAppName = ((xmlInfo === null || xmlInfo === void 0 ? void 0 : xmlInfo.appName) || 'CtvRunApp').replace(/\s+/g, '');
             // config.xml 없으면 생성

package/dist/platforms/webos.js

@@ -21,7 +21,7 @@ const ip_1 = require("../utils/ip");
 const platform_1 = require("../utils/platform");
 function runWebOS() {
     return __awaiter(this, void 0, void 0, function* () {
-        var _a, _b, _c;
+        var _a, _b, _c, _d, _e;
         const config = (0, config_1.loadConfig)();
         const args = process.argv.slice(2);
         const getArg = (0, platform_1.makeArgParser)(args);
@@ -29,8 +29,10 @@ function runWebOS() {
         const deviceName = getArg('device') || ((_a = config.webos) === null || _a === void 0 ? void 0 : _a.deviceName);
         const appId = getArg('appId') || ((_b = config.webos) === null || _b === void 0 ? void 0 : _b.appId) || 'com.ctvrun.app';
         const targetArg = getArg('target');
+        const port = getArg('port') || ((_c = config.webos) === null || _c === void 0 ? void 0 : _c.port) || ((_d = config.common) === null || _d === void 0 ? void 0 : _d.devServerPort) || 3000;
         const appUrl = getArg('url') ||
-            `http://${(0, ip_1.getLocalIp)()}:${((_c = config.common) === null || _c === void 0 ? void 0 : _c.devServerPort) || 3000}`;
+            ((_e = config.webos) === null || _e === void 0 ? void 0 : _e.url) ||
+            `http://${(0, ip_1.getLocalIp)()}:${port}`;
         // 등록된 기기가 없는 경우
         if (!deviceName) {
             console.log('\n📺 연결된 WebOS TV 정보가 없습니다.');

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@zsukim/ctv-run",
-	"version": "1.0.0",
+	"version": "1.0.2",
 	"description": "Smart TV deployment CLI for Vizio, LG webOS, Fire TV, and Samsung Tizen",
 	"keywords": [
 		"ctv",
@@ -27,7 +27,7 @@
 	"scripts": {
 		"build": "tsc",
 		"watch": "tsc -w",
-		"prepublishOnly": "tsc && cp src/README.md README.md"
+		"prepublishOnly": "tsc"
 	},
 	"dependencies": {
 		"fs-extra": "^11.3.4",