Merged uname.sysname

Author: konraddysput

CHANGELOG.md

@@ -3,6 +3,8 @@
 ## Version 3.2.0-release candidate
 This release adds the ability to capture native iOS crashes from Unity games deployed to iOS. The Backtrace Configuration now exposes a setting for games being prepared for iOS to choose `Capture native crashes`. When enabled, the backtrace-unity client will capture and submit native iOS crashes to the configured Backtrace instance. To generate human readable callstacks, game programmers will need to generate and upload appropriate debug symbols.
 
+- Renamed attribute uname.sysname and added default uname.sysname detection for new Unity platforms.
+
 ## Version 3.1.2
 - `BacktraceData` allows to edit list of environment variables collected by `BacktraceAnnotations`
 - `SourceCode` object description for PII purpose

README.md

@@ -361,6 +361,34 @@ Notes:
 - `BacktraceDatabase` `Count` method will return number of all records stored in database (included deduplicated records),
 - `BacktarceDatabase` `Delete` method will remove record (with multiple deduplicated records) at the same time.
 
+<<<<<<< HEAD
+=======
+# Android Specific information
+
+The backtrace-unity library includes support for capturing additional Android Native information, from underlying Android OS (Memory and process related), JNI, and NDK layers.
+
+## Native process and memory related information
+
+system.memory usage related information including memfree, swapfree, and vmalloc.used is now available. Additional VM details and voluntary / nonvountary ctxt switches are included.
+
+## ANR
+
+When configuring the backtrace-unity client for an Android deployment, programmers will have a toggle available in backtrace-unity GUI in the Unity Editor to enable or disable ANR reports. This will use the default of 5 seconds.
+
+## Symbols upload
+
+Unity allows developer to generate symbols archive called `symbols.zip` in the il2cpp build pipeline in the root directory of your game. In this archive you can find generated symbols for your game libraries. When your game crashes due to a native exception, your stack trace will contain only memory addresses instead of function name. Symbols from `symbols.zip` archive allows Backtrace to match function address to function name in your source code. 
+
+To generate `symbols.zip` archive make sure:
+* you selected il2cpp build,
+* you checked `Create symbols.zip` in the Build settings window
+![Create symbols.zip](./Documentation~/images/symbols.png)
+
+To upload symbols to Backtrace, you need to rename symbols generated by Unity end simply with a `.so` extension. By default, symbol files within the .zip will end with extension `.sym.so`. or `.dbg.so` Backtrace will only match symbols to files based on the ending with `.so` extension. Please ensure all files have a single `.so` extention before uploading the zip. To upload symbols please go to your project settings, to the `Upload an archive` tab under `Symbols` section. 
+
+Backtrace offers to upload symbols automatically from Unity Editor to your Backtrace instance. Backtrace symbols upload pipeline will be triggered after successfull build of il2cpp Android game and when Symbols upload token is available in Backtrace Client options. After successfull build, upload pipeline will confirm symbols upload.
+
+>>>>>>> feature/uname-update
 # Architecture description
 
 ## BacktraceReport <a name="architecture-BacktraceReport"></a>

Runtime/Common/SystemHelper.cs

@@ -64,7 +64,7 @@ internal static bool IsLibraryAvailable(string[] libraries)
         /// </summary>
         /// <param name="architecture">System architecture</param>
         /// <returns>System name</returns>
-        internal static string Name(string architecture)
+        internal static string Name()
         {
 #pragma warning disable CS0618 // Type or member is obsolete
             switch (Application.platform)
@@ -80,9 +80,9 @@ internal static string Name(string architecture)
                 case RuntimePlatform.OSXPlayer:
                     return "Mac OS";
                 case RuntimePlatform.PS3:
-                    return "PS3";
+                    return "ps3";
                 case RuntimePlatform.PS4:
-                    return "PS4";
+                    return "ps4";
                 case RuntimePlatform.TizenPlayer:
                 case RuntimePlatform.SamsungTVPlayer:
                     return "Samsung TV";
@@ -93,7 +93,7 @@ internal static string Name(string architecture)
                 case RuntimePlatform.WiiU:
                     return "WiiU";
                 case RuntimePlatform.Switch:
-                    return "Switch";
+                    return "switch";
                 case RuntimePlatform.WindowsEditor:
                 case RuntimePlatform.WindowsPlayer:
                 case RuntimePlatform.WSAPlayerARM:
@@ -104,7 +104,7 @@ internal static string Name(string architecture)
                 case RuntimePlatform.XboxOne:
                     return "Xbox";
                 default:
-                    return "NaCl";
+                    return Application.platform.ToString();
             }
         }
 

Runtime/Model/JsonData/BacktraceAttributes.cs

@@ -279,7 +279,7 @@ private void SetMachineAttributes(bool onlyBuiltInAttributes = false)
                 Attributes["uname.machine"] = cpuArchitecture;
             }
             //Operating system name = such as "windows"
-            Attributes["uname.sysname"] = SystemHelper.Name(cpuArchitecture);
+            Attributes["uname.sysname"] = SystemHelper.Name();
 
             //The version of the operating system
             Attributes["uname.version"] = Environment.OSVersion.Version.ToString();