Add DISABLE_BETAHUB_LOGGER

Author: genail

Documentation.html

@@ -114,6 +114,29 @@ <h2>IL2CPP Support and FFmpeg Video Recording</h2>
         </ul>
     </div>
 
+    <div class="warning">
+        <h2>Performance: Disabling Logger</h2>
+        <p><strong>If you need to disable BetaHub's logging system for performance reasons or production builds:</strong></p>
+        <ul>
+            <li>Define the scripting symbol <code>DISABLE_BETAHUB_LOGGER</code> in Player Settings > Scripting Define Symbols</li>
+            <li>This prevents the logger from capturing Unity logs, which can cause:
+                <ul>
+                    <li>File I/O operations every time Unity logs a message</li>
+                    <li>CPU overhead from continuous disk writes</li>
+                    <li>File access violations when multiple Unity instances run simultaneously</li>
+                </ul>
+            </li>
+            <li>Bug reports will still work, but won't include captured Unity logs</li>
+            <li>A warning will be displayed when BugReportUI starts with logging disabled</li>
+        </ul>
+        <p><strong>When to use:</strong></p>
+        <ul>
+            <li>Production builds where logging overhead impacts performance</li>
+            <li>Multi-instance Unity scenarios (automated testing, CI/CD)</li>
+            <li>Projects with high-frequency logging that causes file access issues</li>
+        </ul>
+    </div>
+
     <h3>Quick Start</h3>
 
     <div class="note">

README.md

@@ -63,3 +63,20 @@ Join our [Discord server](https://discord.gg/g2wpRtG) for support, feedback, and
 - For IL2CPP: define `ENABLE_BETAHUB_FFMPEG` and ensure the native library is present.
 - For Mono/.NET: no special action is needed.
 
+## ⚠️ Performance: Disabling Logger
+
+**If you need to disable BetaHub's logging system for performance reasons or production builds:**
+
+- Define the scripting symbol `DISABLE_BETAHUB_LOGGER` in Player Settings > Scripting Define Symbols
+- This prevents the logger from capturing Unity logs, which can cause:
+  - File I/O operations every time Unity logs a message
+  - CPU overhead from continuous disk writes
+  - File access violations when multiple Unity instances run simultaneously
+- Bug reports will still work, but won't include captured Unity logs
+- A warning will be displayed when BugReportUI starts with logging disabled
+
+**When to use:**
+- Production builds where logging overhead impacts performance
+- Multi-instance Unity scenarios (automated testing, CI/CD)
+- Projects with high-frequency logging that causes file access issues
+

Runtime/Scripts/BugReportUI.cs

@@ -122,11 +122,13 @@ public class BugReportUI : MonoBehaviour
 
         private bool _uiWasVisible = false;
 
+#if !DISABLE_BETAHUB_LOGGER
         [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.SubsystemRegistration)]
         private static void InitializeLogger()
         {
             _logger = new Logger();
         }
+#endif
 
         void Awake()
         {
@@ -178,6 +180,10 @@ void Start()
                 Debug.LogError("Project ID is not set. I won't be able to submit bug reports.");
             }
 
+#if DISABLE_BETAHUB_LOGGER
+            Debug.LogWarning("DISABLE_BETAHUB_LOGGER is enabled. Player logs will not be captured for bug reports. Remove this scripting define symbol to enable logging.");
+#endif
+
             // Check for auth token if not using device auth
             if (string.IsNullOrEmpty(AuthToken))
             {
@@ -361,7 +367,7 @@ void SubmitBugReport()
                 logFiles = new List<Issue.LogFileReference>(_logFiles);
 
                 // Add logger log file if it exists
-                if (IncludePlayerLog && !string.IsNullOrEmpty(_logger.LogPath) && File.Exists(_logger.LogPath))
+                if (IncludePlayerLog && _logger != null && !string.IsNullOrEmpty(_logger.LogPath) && File.Exists(_logger.LogPath))
                 {
                     // skip if size over 200MB
                     if (new FileInfo(_logger.LogPath).Length < 200 * 1024 * 1024)