Version 3.1.0 - ndk support (#43)

* Crashpad support * Update CHANGELOG.md * Update README.md * Symbols upload instructions * Added automatically symbols upload and renamed crashpad_handler to libcrashpad_handler * Fixed compilation errors on Windows + added support for older version of Untiy IDE * Improved .meta files - removed different platforms from meta file that might be not supported by every Untiy instance * Android NDK Updates Clarifying rename of symbol file extensions to simply .so * Updated readme and changelog * Update README.md * Update CHANGELOG.md * Update SymbolsUpload.cs (#42) * Update SymbolsUpload.cs - MAC support * Dynamic attributes support, Crashpad https support * Readme + Changelog update * Libraries update * Version 3.1.0 * move Symbols upload token to android section Co-authored-by: jasoncdavis0 <[email protected]> Co-authored-by: Vincent Lussenburg <[email protected]>
backtrace-labs · Aug 28, 2020 · 01d36d5 · 01d36d5
1 parent 8ba4742
commit 01d36d5
Show file tree

Hide file tree

Showing 37 changed files with 830 additions and 145 deletions.
diff --git a/Android/lib.meta b/Android/lib.meta
diff --git a/Android/lib/arm64-v8a.meta b/Android/lib/arm64-v8a.meta
diff --git a/Android/lib/arm64-v8a/libbacktrace-crashpad.so b/Android/lib/arm64-v8a/libbacktrace-crashpad.so
diff --git a/Android/lib/arm64-v8a/libbacktrace-crashpad.so.meta b/Android/lib/arm64-v8a/libbacktrace-crashpad.so.meta
diff --git a/Android/lib/arm64-v8a/libcrashpad_handler.so b/Android/lib/arm64-v8a/libcrashpad_handler.so
diff --git a/Android/lib/arm64-v8a/libcrashpad_handler.so.meta b/Android/lib/arm64-v8a/libcrashpad_handler.so.meta
diff --git a/Android/lib/armeabi-v7a.meta b/Android/lib/armeabi-v7a.meta
diff --git a/Android/lib/armeabi-v7a/libbacktrace-crashpad.so b/Android/lib/armeabi-v7a/libbacktrace-crashpad.so
diff --git a/Android/lib/armeabi-v7a/libbacktrace-crashpad.so.meta b/Android/lib/armeabi-v7a/libbacktrace-crashpad.so.meta
diff --git a/Android/lib/armeabi-v7a/libcrashpad_handler.so b/Android/lib/armeabi-v7a/libcrashpad_handler.so
diff --git a/Android/lib/armeabi-v7a/libcrashpad_handler.so.meta b/Android/lib/armeabi-v7a/libcrashpad_handler.so.meta
diff --git a/Android/lib/x86.meta b/Android/lib/x86.meta
diff --git a/Android/lib/x86/libbacktrace-crashpad.so b/Android/lib/x86/libbacktrace-crashpad.so
diff --git a/Android/lib/x86/libbacktrace-crashpad.so.meta b/Android/lib/x86/libbacktrace-crashpad.so.meta
diff --git a/Android/lib/x86/libcrashpad_handler.so b/Android/lib/x86/libcrashpad_handler.so
diff --git a/Android/lib/x86/libcrashpad_handler.so.meta b/Android/lib/x86/libcrashpad_handler.so.meta
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,18 @@
 # Backtrace Unity Release Notes
 
+## Version 3.1.0
+This release adds an ability to capture native NDK crashes from Unity games deployed on Android. The Backtrace Configuration now exposes a setting for games being prepared for Android OS to choose `Capture native crashes`. When enabled, Backtrace will capture and symbolicate native stack traces from crashes impacting the Unity Engine or any Unity Engine Plugin.
+
+When develoing for Andriod, Unity users who want to debug native NDK crash report can specify a Backtrace Symbols Server Token to support the optional uploading of debug symbols from Unity Editor to Backtrace during build. Uploaded symbols are needed to generate human readable stack trace with proper function names for identifying issues. 
+
+Backtrace library now allows to set client attributes, that will be included in every report. In addition to that, Backtrace client attributes will be available in the native crashes generated by Android games.
+
+To setup client attributes you can simply type
+```csharp
+BacktraceClient["name-of-attribute"] = "value-of-attribute";
+```
+If you already have dictionary of attributes you can use `SetAttributes` method. 
+
 ## Version 3.0.4
 Preliminary Nintendo Switch support has been introduced. The offline database is not currently supported in this version, but will be included in an upcoming release.
 

diff --git a/Documentation~/images/symbols.png b/Documentation~/images/symbols.png
diff --git a/Editor/BacktraceConfigurationEditor.cs b/Editor/BacktraceConfigurationEditor.cs
@@ -42,9 +42,13 @@ public override void OnInspectorGUI()
  new GUIContent(BacktraceConfigurationLabels.LABEL_IGNORE_SSL_VALIDATION));
 #endif
 #if UNITY_ANDROID
- EditorGUILayout.PropertyField(
- serializedObject.FindProperty("HandleANR"),
- new GUIContent(BacktraceConfigurationLabels.LABEL_HANDLE_ANR));
+ EditorGUILayout.PropertyField(
+ serializedObject.FindProperty("HandleANR"),
+ new GUIContent(BacktraceConfigurationLabels.LABEL_HANDLE_ANR));
+
+ EditorGUILayout.PropertyField(
+ serializedObject.FindProperty("SymbolsUploadToken"),
+ new GUIContent(BacktraceConfigurationLabels.LABEL_SYMBOLS_UPLOAD_TOKEN));
 #endif
  EditorGUILayout.PropertyField(
  serializedObject.FindProperty("UseNormalizedExceptionMessage"),
@@ -71,7 +75,6 @@ public override void OnInspectorGUI()
  serializedObject.FindProperty("DestroyOnLoad"),
  new GUIContent(BacktraceConfigurationLabels.LABEL_DESTROY_CLIENT_ON_SCENE_LOAD));
 
-
  SerializedProperty gameObjectDepth = serializedObject.FindProperty("GameObjectDepth");
  EditorGUILayout.PropertyField(gameObjectDepth, new GUIContent(BacktraceConfigurationLabels.LABEL_GAME_OBJECT_DEPTH));
 
@@ -117,6 +120,12 @@ public override void OnInspectorGUI()
  serializedObject.FindProperty("AddUnityLogToReport"),
  new GUIContent(BacktraceConfigurationLabels.LABEL_ADD_UNITY_LOG));
 
+#endif
+
+#if UNITY_ANDROID
+ EditorGUILayout.PropertyField(
+ serializedObject.FindProperty("CaptureNativeCrashes"),
+ new GUIContent(BacktraceConfigurationLabels.CAPTURE_NATIVE_CRASHES));
 #endif
  EditorGUILayout.PropertyField(
  serializedObject.FindProperty("AutoSendMode"),

diff --git a/Editor/BacktraceConfigurationLabels.cs b/Editor/BacktraceConfigurationLabels.cs
@@ -9,13 +9,15 @@ internal static class BacktraceConfigurationLabels
 
  internal static string LABEL_DESTROY_CLIENT_ON_SCENE_LOAD = "Destroy client on new scene load (false - Backtrace managed)";
  internal static string LABEL_HANDLE_ANR = "Handle ANR (Application not responding)";
+ internal static string CAPTURE_NATIVE_CRASHES = "Capture native crashes";
  internal static string LABEL_REPORT_FILTER = "Filter reports";
  internal static string LABEL_NUMBER_OF_LOGS = "Collect last n game logs";
  internal static string LABEL_GAME_OBJECT_DEPTH = "Game object depth limit";
  internal static string LABEL_IGNORE_SSL_VALIDATION = "Ignore SSL validation";
  internal static string LABEL_SEND_UNHANDLED_GAME_CRASHES_ON_STARTUP= "Send unhandled native game crashes on startup";
  internal static string LABEL_USE_NORMALIZED_EXCEPTION_MESSAGE = "Use normalized exception message";
  internal static string LABEL_PERFORMANCE_STATISTICS = "Enable performance statistics";
+ internal static string LABEL_SYMBOLS_UPLOAD_TOKEN = "Symbols upload token";
 
  // database labels
  internal static string LABEL_ENABLE_DATABASE = "Enable Database";