launch-unity 0.1.0 → 0.2.0

package/README.ja.md

@@ -21,6 +21,11 @@ npx launch-unity /path Android -- -executeMethod My.Build.Entry
 launch-unity
 launch-unity /path/to/MyUnityProject Android
 launch-unity . -- -buildTarget iOS -projectPath . # 上書きも可能
+
+# プロジェクトを開いている Unity を終了
+quit-unity                 # カレントディレクトリのプロジェクトの Unity を終了
+quit-unity /path/to/Proj   # 指定プロジェクトの Unity を終了
+quit-unity . --timeout 20000 --force
 ```
 
 指定した Unity プロジェクトの `ProjectSettings/ProjectVersion.txt` から必要な Unity Editor のバージョンを読み取り、
@@ -46,5 +51,16 @@ Unity Hub でインストール済みの該当バージョンを起動する mac
 - macOS / Windows: Unity Hub のデフォルトインストールパスを前提にサポート。
 - Linux: 未対応です。対応 PR を歓迎します。
 
+## quit-unity 使い方（詳細）
+```bash
+# 基本構文
+quit-unity [PROJECT_PATH] [--timeout <ms>] [--force]
+
+# フラグ
+# -t, --timeout <ms>  正常終了を待つ時間（既定: 15000ms）
+# -f, --force         タイムアウト後に強制終了
+# -h, --help          ヘルプ
+```
+
 ## ライセンス
 - MIT。詳細は `LICENSE` を参照してください。

package/README.md

@@ -21,6 +21,11 @@ npx launch-unity /path Android -- -executeMethod My.Build.Entry
 launch-unity
 launch-unity /path/to/MyUnityProject Android
 launch-unity . -- -buildTarget iOS -projectPath . # You can override
+
+# Quit the Unity instance holding a project open
+quit-unity                 # Quit Unity for current directory project
+quit-unity /path/to/Proj   # Quit Unity for a specific project
+quit-unity . --timeout 20000 --force
 ```
 
 A TypeScript CLI for macOS and Windows that reads the required Unity Editor version from
@@ -58,6 +63,14 @@ launch-unity [PROJECT_PATH] [PLATFORM]
 
 # Flags
 # -h, --help  Show help
+
+# Quit syntax
+quit-unity [PROJECT_PATH] [--timeout <ms>] [--force]
+
+# Flags (quit-unity)
+# -t, --timeout <ms>  Time to wait for graceful quit (default: 15000)
+# -f, --force         Force kill if not exited within timeout
+# -h, --help          Show help
 ```
 
 

package/dist/quit.js

@@ -0,0 +1,166 @@
+#!/usr/bin/env node
+/*
+  quit-unity: Quit the Unity Editor instance that has the specified project open.
+  Platforms: macOS, Windows
+*/
+import { existsSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+function parseArgs(argv) {
+    const defaultProjectPath = process.cwd();
+    const args = argv.slice(2);
+    let projectPath = defaultProjectPath;
+    let timeoutMs = 15000;
+    let force = false;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i] ?? "";
+        if (arg === "--help" || arg === "-h") {
+            printHelp();
+            process.exit(0);
+        }
+        if (arg === "--force" || arg === "-f") {
+            force = true;
+            continue;
+        }
+        if (arg === "--timeout" || arg === "-t") {
+            const value = args[i + 1];
+            if (!value || value.startsWith("-")) {
+                console.error("Error: --timeout requires a millisecond value");
+                process.exit(1);
+            }
+            const parsed = Number(value);
+            if (!Number.isFinite(parsed) || parsed < 0) {
+                console.error("Error: --timeout must be a non-negative number (milliseconds)");
+                process.exit(1);
+            }
+            timeoutMs = parsed;
+            i++;
+            continue;
+        }
+        if (arg.startsWith("-")) {
+            // Unknown flags are ignored to keep CLI permissive
+            continue;
+        }
+        // First positional = project path
+        projectPath = resolve(arg);
+    }
+    return { projectPath, timeoutMs, force };
+}
+function printHelp() {
+    const help = `
+Usage: quit-unity [PROJECT_PATH] [--timeout <ms>] [--force]
+
+Quit the Unity Editor instance that has PROJECT_PATH open.
+
+Arguments:
+  PROJECT_PATH        Optional. Defaults to current directory
+
+Flags:
+  -t, --timeout <ms>  Time to wait for graceful quit (default: 15000)
+  -f, --force         Force kill if not exited within timeout
+  -h, --help          Show this help message
+`;
+    process.stdout.write(help);
+}
+function ensureProjectPath(projectPath) {
+    if (!existsSync(projectPath)) {
+        console.error(`Error: Project directory not found: ${projectPath}`);
+        process.exit(1);
+    }
+}
+function readPidFromEditorInstance(projectPath) {
+    const editorInstancePath = join(projectPath, "Library", "EditorInstance.json");
+    if (!existsSync(editorInstancePath))
+        return null;
+    try {
+        const content = readFileSync(editorInstancePath, "utf8");
+        const data = JSON.parse(content);
+        const candidateKeys = [
+            "process_id",
+            "processId",
+            "processID",
+            "pid",
+            "PID",
+        ];
+        for (const key of candidateKeys) {
+            const value = data[key];
+            if (typeof value === "number" && Number.isFinite(value))
+                return value;
+            if (typeof value === "string" && /^\d+$/.test(value))
+                return Number(value);
+        }
+    }
+    catch {
+        // fallthrough
+    }
+    return null;
+}
+function isProcessAlive(pid) {
+    try {
+        // signal 0: does not actually send a signal, just tests for existence/permissions
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function waitForExit(pid, timeoutMs) {
+    const start = Date.now();
+    const stepMs = 200;
+    while (Date.now() - start < timeoutMs) {
+        if (!isProcessAlive(pid))
+            return true;
+        await new Promise((r) => setTimeout(r, stepMs));
+    }
+    return !isProcessAlive(pid);
+}
+async function quitByPid(pid, force, timeoutMs) {
+    // Try graceful first
+    try {
+        process.kill(pid, "SIGTERM");
+    }
+    catch (error) {
+        // If process already exited, consider it success
+        if (!isProcessAlive(pid))
+            return true;
+        // If we cannot send the signal and the process is alive, escalate when force is true
+        if (!force)
+            return false;
+    }
+    const graceful = await waitForExit(pid, timeoutMs);
+    if (graceful)
+        return true;
+    if (!force)
+        return false;
+    // Force kill
+    try {
+        process.kill(pid, "SIGKILL");
+    }
+    catch {
+        // ignore
+    }
+    // Give a short moment after force
+    return await waitForExit(pid, 2000);
+}
+async function main() {
+    const options = parseArgs(process.argv);
+    ensureProjectPath(options.projectPath);
+    const pid = readPidFromEditorInstance(options.projectPath);
+    if (pid === null) {
+        console.error("Error: Could not find Unity PID. Is this project currently open in Unity? (Missing Library/EditorInstance.json)");
+        process.exit(1);
+        return;
+    }
+    console.log(`Attempting to quit Unity (pid: ${pid}) for project: ${options.projectPath}`);
+    const ok = await quitByPid(pid, options.force, options.timeoutMs);
+    if (!ok) {
+        console.error(`Failed to quit Unity (pid: ${pid}) within ${options.timeoutMs}ms.${options.force ? "" : " Try --force."}`);
+        process.exit(1);
+        return;
+    }
+    console.log("Unity has exited.");
+}
+main().catch((error) => {
+    console.error(error);
+    process.exit(1);
+});

package/package.json

@@ -1,15 +1,16 @@
 {
   "name": "launch-unity",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Open a Unity project with the matching Editor version (macOS/Windows)",
   "type": "module",
-  "main": "dist/cli.js",
+  "main": "dist/launch.js",
   "bin": {
-    "launch-unity": "dist/cli.js"
+    "launch-unity": "dist/launch.js",
+    "quit-unity": "dist/quit.js"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "start": "node dist/cli.js",
+    "start": "node dist/launch.js",
     "lint": "eslint . --ext .ts,.js",
     "lint:fix": "eslint . --ext .ts,.js --fix",
     "format": "prettier --write .",