unity-cli@v1.6.5

- renamed `licensing-logs` command to `licensing-client-logs`
- added `licensing-audit-logs`
- added `hub-logs`

Author: StephenHodgson

README.md

@@ -15,10 +15,12 @@ A powerful command line utility for the Unity Game Engine. Automate Unity projec
       - [Activate License](#activate-license)
       - [Return License](#return-license)
       - [License Context](#license-context)
-      - [Licensing Logs](#licensing-logs)
+      - [Licensing Client Logs](#licensing-client-logs)
+      - [Licensing Audit Logs](#licensing-audit-logs)
     - [Unity Hub](#unity-hub)
       - [Hub Version](#hub-version)
       - [Hub Path](#hub-path)
+      - [Hub Logs](#hub-logs)
       - [Unity Hub Install](#unity-hub-install)
       - [Run Unity Hub Commands](#run-unity-hub-commands)
       - [Setup Unity Editor](#setup-unity-editor)
@@ -121,12 +123,20 @@ unity-cli return-license --license personal
 unity-cli license-context
 ```
 
-##### Licensing Logs
+##### Licensing Client Logs
 
-`licensing-logs`: Prints the path to the Unity Licensing Client log files.
+`licensing-client-logs`: Prints the path to the Unity Licensing Client log file.
 
 ```bash
-unity-cli licensing-logs
+unity-cli licensing-client-logs
+```
+
+##### Licensing Audit Logs
+
+`licensing-audit-logs`: Prints the path to the Unity Licensing Client audit log.
+
+```bash
+unity-cli licensing-audit-logs
 ```
 
 #### Unity Hub
@@ -147,6 +157,14 @@ unity-cli hub-version
 unity-cli hub-path
 ```
 
+##### Hub Logs
+
+`hub-logs`: Prints the path to the Unity Hub log file.
+
+```bash
+unity-cli hub-logs
+```
+
 ##### Unity Hub Install
 
 `hub-install [options]`: Install or update the Unity Hub

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rage-against-the-pixel/unity-cli",
-  "version": "1.6.4",
+  "version": "1.6.5",
   "description": "A command line utility for the Unity Game Engine.",
   "author": "RageAgainstThePixel",
   "license": "MIT",

src/cli.ts

@@ -148,11 +148,17 @@ program.command('license-context')
         process.exit(0);
     });
 
-program.command('licensing-logs')
-    .description('Prints the path to the Unity Licensing Client log files.')
+program.command('licensing-client-logs')
+    .description('Prints the path to the Unity Licensing Client log file.')
     .action(async () => {
-        const client = new LicensingClient();
-        process.stdout.write(`${client.logPath()}\n`);
+        process.stdout.write(`${LicensingClient.ClientLogPath()}\n`);
+        process.exit(0);
+    });
+
+program.command('licensing-audit-logs')
+    .description('Prints the Unity Licensing Client audit log.')
+    .action(async () => {
+        process.stdout.write(`${LicensingClient.ClientAuditLogPath()}\n`);
         process.exit(0);
     });
 
@@ -189,6 +195,13 @@ program.command('hub-path')
         process.exit(0);
     });
 
+program.command('hub-logs')
+    .description('Prints the path to the Unity Hub log file.')
+    .action(async () => {
+        process.stdout.write(`${UnityHub.LogPath()}\n`);
+        process.exit(0);
+    });
+
 program.command('hub-install')
     .description('Install the Unity Hub.')
     .option('--verbose', 'Enable verbose logging.')

src/license-client.ts

@@ -124,7 +124,7 @@ export class LicensingClient {
      * @see https://docs.unity.com/en-us/licensing-server/troubleshooting-client#logs
      * @returns The path to the log file.
      */
-    public logPath(): string {
+    public static ClientLogPath(): string {
         switch (process.platform) {
             case 'win32':
                 // $env:LOCALAPPDATA\Unity\Unity.Licensing.Client.log
@@ -140,6 +140,27 @@ export class LicensingClient {
         }
     }
 
+    /**
+     * Gets the path to the Unity Licensing Client audit log file.
+     * @see https://docs.unity.com/en-us/licensing-server/troubleshooting-client#logs
+     * @returns The path to the audit log file.
+     */
+    public static ClientAuditLogPath(): string {
+        switch (process.platform) {
+            case 'win32':
+                // $env:LOCALAPPDATA\Unity\Unity.Entitlements.Audit.log
+                return path.join(process.env.LOCALAPPDATA || '', 'Unity', 'Unity.Entitlements.Audit.log');
+            case 'darwin':
+                // ~/Library/Logs/Unity/Unity.Entitlements.Audit.log
+                return path.join(os.homedir(), 'Library', 'Logs', 'Unity', 'Unity.Entitlements.Audit.log');
+            case 'linux':
+                // ~/.config/unity3d/Unity/Unity.Entitlements.Audit.log
+                return path.join(os.homedir(), '.config', 'unity3d', 'Unity', 'Unity.Entitlements.Audit.log');
+            default:
+                throw new Error(`Unsupported platform: ${process.platform}`);
+        }
+    }
+
     /**
      * Displays the context information of the licensing client to the console.
      * @see https://docs.unity.com/en-us/licensing-server/troubleshooting-client#exit-codes

src/unity-hub.ts

@@ -1258,4 +1258,25 @@ done
 
         return moduleMap;
     }
+
+    /**
+     * Returns the path to the Unity Hub log file.
+     * @see https://docs.unity.com/en-us/licensing-server/troubleshooting-client#logs
+     * @returns The Unity Hub log file path.
+     */
+    public static LogPath(): string {
+        switch (process.platform) {
+            case 'win32':
+                // %APPDATA%\UnityHub\logs\info-log.json
+                return path.join(process.env.APPDATA || '', 'UnityHub', 'logs', 'info-log.json');
+            case 'darwin':
+                // ~/Library/Application Support/UnityHub/logs/info-log.json
+                return path.join(os.homedir(), 'Library', 'Application Support', 'UnityHub', 'logs', 'info-log.json');
+            case 'linux':
+                // ~/.config/UnityHub/logs/info-log.json
+                return path.join(os.homedir(), '.config', 'UnityHub', 'logs', 'info-log.json');
+            default:
+                throw new Error(`Unsupported platform: ${process.platform}`);
+        }
+    }
 }