@zsukim/ctv-run 1.0.0 → 1.0.3

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,24 +51,30 @@
 
 | 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` 폴더 절대 경로 |
+| `androidProjectPath` | Static Mode 시 ✅ | Android 프로젝트 루트 경로 (gradlew가 있는 폴더) |
+| `moduleName` | | Android 모듈명 (기본값: `app`) |
 
 **Tizen**
 
 | Field | 필수 | Description |
 |-------|------|-------------|
-| `ip` | ✅ | Samsung Tizen TV 로컬 IP |
+| `ip` | ✅ | TV 로컬 IP |
+| `url` | | TV가 로드할 URL |
+| `port` | | TV가 로드할 URL의 포트 |
 | `appId` | | Tizen 앱 고유 ID (없으면 자동 생성) |
 
 **WebOS**
@@ -91,13 +82,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 +111,9 @@ npx playwright install chromium
 ADB가 설치되어 있어야 하며, TV에서 **개발자 옵션 → ADB 디버깅**이 활성화되어 있어야 합니다.
 
 ```bash
+# macOS — ADB 설치
+brew install --cask android-platform-tools
+
 # 연결 확인
 adb devices
 ```
@@ -186,7 +182,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 +195,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 +217,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 +241,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/firetv.js

@@ -21,7 +21,7 @@ const ip_1 = require("../utils/ip");
 const platform_1 = require("../utils/platform");
 function runFireTv() {
     return __awaiter(this, void 0, void 0, function* () {
-        var _a, _b, _c, _d, _e, _f, _g, _h;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j;
         const args = process.argv.slice(2);
         const config = (0, config_1.loadConfig)();
         const getArg = (0, platform_1.makeArgParser)(args);
@@ -31,49 +31,61 @@ function runFireTv() {
         const pkg = getArg('package') || ((_c = config.fire) === null || _c === void 0 ? void 0 : _c.package);
         const activity = getArg('activity') || ((_d = config.fire) === null || _d === void 0 ? void 0 : _d.activity) || '.MainActivity';
         const targetArg = getArg('target');
-        const androidAssetsPath = getArg('assetsPath') || ((_e = config.fire) === null || _e === void 0 ? void 0 : _e.androidAssetsPath);
+        const androidProjectPath = getArg('androidProjectPath') || ((_e = config.fire) === null || _e === void 0 ? void 0 : _e.androidProjectPath);
+        const moduleName = getArg('moduleName') || ((_f = config.fire) === null || _f === void 0 ? void 0 : _f.moduleName) || 'app';
         // 앱 URL 결정 (Live Mode 전용)
-        const userUrl = getArg('url') || ((_f = config.fire) === null || _f === void 0 ? void 0 : _f.url);
-        const port = getArg('port') || ((_g = config.fire) === null || _g === void 0 ? void 0 : _g.port) || ((_h = config.common) === null || _h === void 0 ? void 0 : _h.devServerPort) || 3000;
+        const userUrl = getArg('url') || ((_g = config.fire) === null || _g === void 0 ? void 0 : _g.url);
+        const port = getArg('port') || ((_h = config.fire) === null || _h === void 0 ? void 0 : _h.port) || ((_j = config.common) === null || _j === void 0 ? void 0 : _j.devServerPort) || 3000;
         const appUrl = userUrl || `http://${(0, ip_1.getLocalIp)()}:${port}`;
         if (!tvIp || !pkg) {
             console.error(`\n❌ Fire TV 필수 설정(ip, package)이 누락되었습니다!`);
             return;
         }
-        // Static Mode: dist를 Android assets에 복사 (Tizen/WebOS와 동일한 개념)
+        // Static Mode
         if (targetArg) {
-            if (!androidAssetsPath) {
-                console.error(`\n❌ ctv.config.json에 'androidAssetsPath'가 설정되어 있지 않습니다.`);
+            if (!androidProjectPath) {
+                console.error(`\n❌ ctv.config.json에 'androidProjectPath'가 설정되어 있지 않습니다.`);
                 return;
             }
             const distPath = path_1.default.resolve(process.cwd(), targetArg);
-            const finalAssetsPath = path_1.default.isAbsolute(androidAssetsPath)
-                ? androidAssetsPath
-                : path_1.default.resolve(process.cwd(), androidAssetsPath);
+            const assetsPath = path_1.default.join(androidProjectPath, moduleName, 'src', 'main', 'assets');
+            const apkPath = path_1.default.join(androidProjectPath, moduleName, 'build', 'outputs', 'apk', 'debug', `${moduleName}-debug.apk`);
             console.log(`-----------------------------------------`);
             console.log(`📡 Target TV IP  : ${tvIp}`);
             console.log(`📦 Package Name  : ${pkg}`);
             console.log(`🛠  ADB Binary    : ${adbBin}`);
-            console.log(`📦 Mode          : 📂 Static Mode (Assets Embedded)`);
-            console.log(`📂 Path          : ${finalAssetsPath}`);
+            console.log(`📦 Mode          : 📂 Static Mode`);
+            console.log(`📂 Project       : ${androidProjectPath}`);
             console.log(`-----------------------------------------`);
             try {
-                const parentPath = path_1.default.dirname(finalAssetsPath);
-                if (!fs_1.default.existsSync(parentPath)) {
-                    console.error(`\n❌ 경로 오류: 부모 폴더가 존재하지 않습니다. (${parentPath})`);
+                // assets 복사
+                if (!fs_1.default.existsSync(path_1.default.dirname(assetsPath))) {
+                    console.error(`\n❌ 경로 오류: Android 프로젝트를 찾을 수 없습니다. (${androidProjectPath})`);
                     return;
                 }
-                if (fs_1.default.existsSync(finalAssetsPath)) {
-                    (0, child_process_1.execSync)(`rm -rf "${finalAssetsPath}"/*`);
+                if (fs_1.default.existsSync(assetsPath)) {
+                    (0, child_process_1.execSync)(`rm -rf "${assetsPath}"/*`);
                 }
                 else {
-                    (0, child_process_1.execSync)(`mkdir -p "${finalAssetsPath}"`);
+                    (0, child_process_1.execSync)(`mkdir -p "${assetsPath}"`);
                 }
-                (0, child_process_1.execSync)(`cp -r "${distPath}"/* "${finalAssetsPath}"`);
+                (0, child_process_1.execSync)(`cp -r "${distPath}"/* "${assetsPath}"`);
                 console.log(`✅ Asset copy complete.`);
+                // APK 빌드
+                console.log(`\n🔨 Building APK...`);
+                (0, child_process_1.execSync)(`./gradlew ${moduleName}:assembleDebug`, {
+                    cwd: androidProjectPath,
+                    stdio: 'inherit',
+                });
+                // APK 설치
+                console.log(`\n📲 Installing APK...`);
+                (0, child_process_1.execSync)(`${adbBin} -s ${tvIp}:5555 install -r "${apkPath}"`, {
+                    stdio: 'inherit',
+                });
+                console.log(`✅ APK install complete.`);
             }
             catch (err) {
-                console.error(`\n❌ 파일 복사 중 에러 발생: ${err.message}`);
+                console.error(`\n❌ Static Mode 실패: ${err.message}`);
                 return;
             }
         }

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.3",
 	"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",