@rage-against-the-pixel/unity-cli 1.0.0

package/dist/unity-editor.js

@@ -0,0 +1,333 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnityEditor = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const logging_1 = require("./logging");
+const utilities_1 = require("./utilities");
+const child_process_1 = require("child_process");
+class UnityEditor {
+    editorPath;
+    editorRootPath;
+    procInfo;
+    pidFile;
+    logger = logging_1.Logger.instance;
+    autoAddNoGraphics;
+    constructor(editorPath) {
+        this.editorPath = editorPath;
+        if (!fs.existsSync(editorPath)) {
+            throw new Error(`The Unity Editor path does not exist: ${editorPath}`);
+        }
+        fs.accessSync(editorPath, fs.constants.X_OK);
+        this.editorRootPath = UnityEditor.GetEditorRootPath(editorPath);
+        this.pidFile = path.join(process.env.RUNNER_TEMP || process.env.USERPROFILE || '.', '.unity', 'unity-editor-process-id.txt');
+        const match = editorPath.match(/(?<major>\d+)\.(?<minor>\d+)\.(?<patch>\d+)/);
+        if (!match) {
+            throw Error(`Invalid Unity Editor Path: ${editorPath}`);
+        }
+        const unityMajorVersion = match.groups?.major;
+        if (!unityMajorVersion) {
+            throw Error(`Invalid Unity Major Version: ${editorPath}`);
+        }
+        this.autoAddNoGraphics = parseInt(unityMajorVersion, 10) > 2018;
+    }
+    /**
+     * Get the full path to a Unity project template based on the provided template name or regex pattern.
+     * @param template The name or regex pattern of the template to find.
+     * @returns The full path to the matching template file.
+     * @throws Error if the template directory does not exist, no templates are found, or no matching template is found.
+     */
+    GetTemplatePath(template) {
+        let templateDir;
+        let editorRoot = path.dirname(this.editorPath);
+        if (process.platform === 'darwin') {
+            templateDir = path.join(path.dirname(editorRoot), 'Resources', 'PackageManager', 'ProjectTemplates');
+        }
+        else {
+            templateDir = path.join(editorRoot, 'Data', 'Resources', 'PackageManager', 'ProjectTemplates');
+        }
+        // Check if the template directory exists
+        if (!fs.existsSync(templateDir) ||
+            !fs.statSync(templateDir).isDirectory()) {
+            throw new Error(`Template directory not found: ${templateDir}`);
+        }
+        // Find all .tgz files in the template directory
+        const files = fs.readdirSync(templateDir)
+            .filter(f => f.endsWith('.tgz'))
+            .map(f => path.join(templateDir, f));
+        if (files.length === 0) {
+            throw new Error(`No templates found in ${templateDir}`);
+        }
+        this.logger.ci(`Available templates:`);
+        files.forEach(f => this.logger.ci(`  > ${path.basename(f)}`));
+        // Build a regex to match the template name and version (e.g., com.unity.template.3d.*[0-9]+\.[0-9]+\.[0-9]+\.tgz)
+        // Accepts either a full regex or a simple string
+        let regex;
+        try {
+            regex = new RegExp(template + ".*[0-9]+\\.[0-9]+\\.[0-9]+\\.tgz");
+        }
+        catch (e) {
+            throw new Error(`Invalid template regex: ${template}`);
+        }
+        // Filter files by regex
+        const matches = files.filter(f => regex.test(path.basename(f)));
+        if (matches.length === 0) {
+            throw new Error(`${template} path not found in ${templateDir}!`);
+        }
+        // Pick the longest match (as in the shell script: sort by length descending)
+        matches.sort((a, b) => b.length - a.length);
+        const templatePath = matches[0];
+        if (!templatePath) {
+            throw new Error('No matching template path found.');
+        }
+        return path.normalize(templatePath);
+    }
+    async Run(command) {
+        let isCancelled = false;
+        const onCancel = async () => {
+            isCancelled = true;
+            await this.tryKillEditorProcess();
+        };
+        process.once('SIGINT', onCancel);
+        process.once('SIGTERM', onCancel);
+        let exitCode;
+        try {
+            const commandStr = `\x1b[34m${this.editorPath} ${command.args.join(' ')}\x1b[0m`;
+            this.logger.startGroup(commandStr);
+            exitCode = await this.exec(command, pInfo => { this.procInfo = pInfo; });
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.logger.error(error.toString());
+            }
+            if (!exitCode) {
+                exitCode = 1;
+            }
+        }
+        finally {
+            this.logger.endGroup();
+            if (!isCancelled) {
+                await this.tryKillEditorProcess();
+                if (exitCode !== 0) {
+                    throw Error(`Unity failed with exit code ${exitCode}`);
+                }
+            }
+        }
+    }
+    GetLogsDirectory(projectPath) {
+        const logsDir = projectPath !== undefined
+            ? path.join(projectPath, 'Builds', 'Logs')
+            : path.join(process.env.GITHUB_WORKSPACE || process.cwd(), 'Logs');
+        try {
+            fs.accessSync(logsDir, fs.constants.R_OK);
+        }
+        catch (error) {
+            this.logger.debug(`Creating Logs Directory:\n  > "${logsDir}"`);
+            fs.mkdirSync(logsDir, { recursive: true });
+        }
+        return logsDir;
+    }
+    GenerateLogFilePath(projectPath, prefix = undefined) {
+        const logsDir = this.GetLogsDirectory(projectPath);
+        const timestamp = new Date().toISOString().replace(/[-:]/g, ``).replace(/\..+/, ``);
+        return path.join(logsDir, `${prefix ? prefix + '-' : ''}Unity-${timestamp}.log`);
+    }
+    async exec(command, onPid) {
+        if (!command.args || command.args.length === 0) {
+            throw Error('No command arguments provided for Unity execution');
+        }
+        if (!command.args.includes(`-automated`)) {
+            command.args.push(`-automated`);
+        }
+        if (!command.args.includes(`-batchmode`)) {
+            command.args.push(`-batchmode`);
+        }
+        if (this.autoAddNoGraphics &&
+            !command.args.includes(`-nographics`) &&
+            !command.args.includes(`-force-graphics`)) {
+            command.args.push(`-nographics`);
+        }
+        if (!command.args.includes('-logFile')) {
+            command.args.push('-logFile', this.GenerateLogFilePath(command.projectPath));
+        }
+        const logPath = (0, utilities_1.getArgumentValueAsString)('-logFile', command.args);
+        let unityProcess;
+        if (process.platform === 'linux' && !command.args.includes('-nographics')) {
+            unityProcess = (0, child_process_1.spawn)('xvfb-run', [this.editorPath, ...command.args], {
+                stdio: ['ignore', 'ignore', 'ignore'],
+                detached: true,
+                env: {
+                    ...process.env,
+                    DISPLAY: ':99',
+                    UNITY_THISISABUILDMACHINE: '1'
+                }
+            });
+        }
+        else {
+            unityProcess = (0, child_process_1.spawn)(this.editorPath, command.args, {
+                stdio: ['ignore', 'ignore', 'ignore'],
+                detached: true,
+                env: {
+                    ...process.env,
+                    UNITY_THISISABUILDMACHINE: '1'
+                }
+            });
+        }
+        const processId = unityProcess.pid;
+        if (!processId) {
+            throw new Error('Failed to start Unity process!');
+        }
+        onPid({ pid: processId, ppid: process.pid, name: this.editorPath });
+        this.logger.debug(`Unity process started with pid: ${processId}`);
+        // make sure the directory for the PID file exists
+        const pidDir = path.dirname(this.pidFile);
+        if (!fs.existsSync(pidDir)) {
+            fs.mkdirSync(pidDir, { recursive: true });
+        }
+        else {
+            try {
+                var existingProcInfo = await (0, utilities_1.readPidFile)(this.pidFile);
+                if (existingProcInfo) {
+                    const killedPid = await (0, utilities_1.tryKillProcess)(existingProcInfo);
+                    if (killedPid) {
+                        this.logger.warn(`Killed existing Unity process with pid: ${killedPid}`);
+                    }
+                }
+            }
+            catch {
+                // PID file does not exist, continue
+            }
+        }
+        // Write the PID to the PID file
+        fs.writeFileSync(this.pidFile, String(processId));
+        const logPollingInterval = 100; // milliseconds
+        // Wait for log file to appear
+        while (!fs.existsSync(logPath)) {
+            await new Promise(res => setTimeout(res, logPollingInterval));
+        }
+        // Start tailing the log file
+        let lastSize = 0;
+        let logEnded = false;
+        const tailLog = async () => {
+            while (!logEnded) {
+                try {
+                    const stats = fs.statSync(logPath);
+                    if (stats.size > lastSize) {
+                        const fd = fs.openSync(logPath, 'r');
+                        const buffer = Buffer.alloc(stats.size - lastSize);
+                        fs.readSync(fd, buffer, 0, buffer.length, lastSize);
+                        process.stdout.write(buffer.toString('utf8'));
+                        fs.closeSync(fd);
+                        lastSize = stats.size;
+                    }
+                }
+                catch (error) {
+                    // ignore read errors
+                }
+                await new Promise(res => setTimeout(res, logPollingInterval));
+            }
+            // Write a newline at the end of the log tail
+            // prevents appending logs from being printed on the same line
+            process.stdout.write('\n');
+        };
+        const timeout = 10000; // 10 seconds
+        // Start log tailing in background
+        const tailPromise = tailLog();
+        const exitCode = await new Promise((resolve, reject) => {
+            unityProcess.on('exit', (code) => {
+                setTimeout(() => {
+                    logEnded = true;
+                    resolve(code ?? 1);
+                }, timeout);
+            });
+            unityProcess.on('error', (error) => {
+                setTimeout(() => {
+                    logEnded = true;
+                    reject(error);
+                }, timeout);
+            });
+        });
+        // Wait for log tailing to finish
+        await tailPromise;
+        // Wait for log file to be unlocked
+        const start = Date.now();
+        let fileLocked = true;
+        while (fileLocked && Date.now() - start < timeout) {
+            try {
+                if (fs.existsSync(logPath)) {
+                    const fd = fs.openSync(logPath, 'r+');
+                    fs.closeSync(fd);
+                    fileLocked = false;
+                }
+                else {
+                    fileLocked = false;
+                }
+            }
+            catch {
+                fileLocked = true;
+                await new Promise(r => setTimeout(r, logPollingInterval));
+            }
+        }
+        return exitCode;
+    }
+    async tryKillEditorProcess() {
+        if (this.procInfo) {
+            await (0, utilities_1.tryKillProcess)(this.procInfo);
+            await (0, utilities_1.killChildProcesses)(this.procInfo);
+        }
+        else {
+            this.logger.debug('No Unity process info available to kill.');
+        }
+    }
+    static GetEditorRootPath(editorPath) {
+        let editorRootPath = editorPath;
+        switch (process.platform) {
+            case 'darwin':
+                editorRootPath = path.join(editorPath, '../../../../');
+                break;
+            case 'linux':
+                editorRootPath = path.join(editorPath, '../../');
+                break;
+            case 'win32':
+                editorRootPath = path.join(editorPath, '../../');
+                break;
+        }
+        fs.accessSync(editorRootPath, fs.constants.R_OK);
+        return editorRootPath;
+    }
+}
+exports.UnityEditor = UnityEditor;
+//# sourceMappingURL=unity-editor.js.map

package/dist/unity-editor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unity-editor.js","sourceRoot":"","sources":["../src/unity-editor.ts"],"names":[],"mappings":"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"}

package/dist/unity-hub.d.ts

@@ -0,0 +1,73 @@
+import { ExecOptions } from './utilities';
+import { UnityVersion } from './unity-version';
+export declare class UnityHub {
+    executable: string;
+    rootDirectory: string;
+    editorInstallationDirectory: string;
+    editorFileExtension: string;
+    private logger;
+    constructor();
+    /**
+     * Executes the Unity Hub command with the specified arguments.
+     * @param args Arguments to pass to the Unity Hub executable.
+     * @param silent If true, suppresses output logging.
+     * @returns The output from the command.
+     */
+    Exec(args: string[], options?: ExecOptions): Promise<string>;
+    /**
+     * Prints the installed Unity Hub version.
+     */
+    Version(): Promise<string>;
+    /**
+     * Installs or updates the Unity Hub.
+     * If the Unity Hub is already installed, it will be updated to the latest version.
+     */
+    Install(): Promise<string>;
+    private installHub;
+    private getInstalledHubVersion;
+    private getLatestHubVersion;
+    /**
+     * Returns the path where the Unity editors will be installed.
+     * @returns {Promise<string>} The install path.
+     */
+    GetInstallPath(): Promise<string>;
+    /**
+     * Sets the path where Unity editors will be installed.
+     * @param installPath The path to set.
+     */
+    SetInstallPath(installPath: string): Promise<void>;
+    /**
+     * Locate and associate an installed editor from a stipulated path.
+     * @param editorPath
+     */
+    AddEditor(editorPath: string): Promise<void>;
+    /**
+     * Attempts to find or install the specified Unity Editor version with the requested modules.
+     * @param unityVersion The Unity version to find or install.
+     * @param modules The modules to install alongside the editor.
+     * @returns The path to the Unity Editor executable.
+     */
+    GetEditor(unityVersion: UnityVersion, modules: string[]): Promise<string>;
+    /**
+     * Lists the installed Unity Editors.
+     * @returns A list of installed Unity Editor versions and their paths.
+     */
+    ListInstalledEditors(): Promise<string[]>;
+    private checkInstalledEditors;
+    private getLatestHubReleases;
+    /**
+     * Patches the Bee Backend for Unity Linux Editor.
+     * https://discussions.unity.com/t/linux-editor-stuck-on-loading-because-of-bee-backend-w-workaround/854480
+     * @param editorPath The path to the Unity Editor executable.
+     */
+    private patchBeeBackend;
+    private getEditorReleaseInfo;
+    private fallbackVersionLookup;
+    private checkEditorModules;
+    private getModulesContent;
+    private installUnity;
+    private installUnity4x;
+    static GetPlatformTargetModuleMap(): {
+        [key: string]: string;
+    };
+}