Release Notes

Feed URL: https://docs.gamebench.net/docs/sdk/relnotes/index.xml

• Injector:
  • Better handling when Apple ID belongs to multiple dev teams
  • Improved UX for Apple Code-Signing issues
• Android & iOS:
  • Restored ability to capture multiple screenshot sizes
  • Session stop now closes any unclosed marker periods
• Android:
  • Support for Adreno 800 series GPUs
  • Added ‘prefab’ declarations for easier integration with native lib
  • Fix for “missing class” Java exception on Android 7
• iOS:
  • Fixed misaligned UI when app is landscape
  • Overlays now appear on non-Metal apps
  • Updated frame counter logic to include non-Metal apps.

• New web-based control interface (on port 8080) for the use of lazily-bound test scripts.
• Added getSessionId() C API.
• API names synchronised across C, C#, and Java
• Injector: New command-line interface to replace gbtool.jar. (Run with “–help” to see options.)
• Injector/Android: ApkToolLib now always uses its internal android-framework.jar. This fixes issues caused by incompatible framework versions left in the user’s home dir.
• Injector/Android: Support for keystore alias selection in password dialog (and CLI)
• Injector: Fix for slightly-lagged console output.
• Android: Screenshot support added for vkQueueSubmit()-based renderers in latest Unity & Unreal engines
• Android: Screenshots now have correct orientation in dashboard
• Android: Support for 16KB pages.
• Android: Fix for crashes on Pixels running Android 16

• Injector: Fixed iOS error: “Cannot read properties of undefined (reading ‘includes’)”
• Injector: Fixed bug whereby “Sign only” was wrongly removing the native library

• Injector: Major rework of renderer and generally trying to follow ElectronJS best practices

• Injector: Hotfix for broken automatic cert generation

• Injector: iOS now supports local code-signing (no Apple login needed)
• Android: Fixed missing FPS on older Androids (7,8,9,10,11)

• Android: Fix for Samsung A12 sometimes crashes at app startup

• FPS overlay updated to include marker start/stop
• Android: Fix to avoid Android SDK’s d8 tool crashing
• Fix for missing janks measurement
• Injector: Fix for broken API token delete

• Unity: Fixed crash due to recent C# change missing from git.

• Fix for setTag() with null tag value causing crash
• Android: Reverted compileSdk from 34 to 33, as 34 breaks build for Unity 2021 projects.
• Android: Reverted minSdk to 21

• Android: Updated Android SDK & set minSdk to 24
• Android: Workaround UX unwantedly inheriting application theme

• Fix for missing setTag() implementation
• Android: Fix for disappearing FPS overlay if task dismissed in task manager

• New in-app UX accessed by tapping the FPS overlay added in 1.5.0.

• Android: Fix for missing/truncated WebRTCStats.csv
• Android: Fix for crash in Java upload callback dispatch (somehow deleted from previous release)

• Injector: iPad autoregistration bug fixed

• Android: Fixed rare black-screen issue seen in Design Home. Mixed-renderer screenshotting is now more robust.
• Android: Fixed 10-second phone hang caused by bug in Adreno 7xx GPU counters
• Injector: Added SDK .zip link on settings screen

• Injector: iOS: Fixed wildcard AppID selection and added automatic wildcard AppID registration when it’s needed.
• Android: GPU raw clock counts now recorded even when GPU max hz is unknown.
• Android: Pixel 8 & 9 family now supported.
• Android: Fixed bug in libhwcpipe that broke GPU usage for Mali-G715 and Mali-G615.
• Android: Session .zip compression now uses less RAM, less chance of OOM.
• Android: fix for crash on Android 11 or older for apps that mix GL/Vulkan and conventional UIs.

• Injector: iOS app app extensions handled properly
• Injector: iOS sign-in completely reworked
• Injector: Improved provisioning profile handling
• Injector: Latest Apple WWDR cert now automatically installed
• iOS: Screenshots improved and now work for rare 16bpp case
• Android: fix for GL API error causing abort() on Galaxy Note 9
• Android: fix for all-black screenshots iif Android 8 + Vulkan rendering + not first session after process start

• Injector: Apple sign-in fix (non-SSO)
• Injector: fix for wrong SDK version shown on label after upgrade

• Uploader bug fixes
• Injector: Initial Apple SSO support

• Android 15 now supported.
• Upload callback now runs even when no uploads attempted.

• Android: GPU usage metric support for Motorola E13, 4x OPPOs, & Realme RMX3263.
• Injector: In-app notification for new builds.
• Injector: Minor tweaks.

• Injector: Google Cloud Identity-Aware Proxy (IAP) support added
• Injector: Minor fixes
• Android: Fix for screenshot hang on Xclipse GPUs.
• Android: Fix for missing GPU details in web dashboard.
• iOS: OpenGL renderer support

• Frame times encoder bug fixed
• Injector: Network security config file properly handled (if used)
• Injector: Blank app icon bug fixed

• Injector: Output app is automatically permissioned for cleartext HTTP when GameBench server is plain old HTTP url.
• Android/iOS: Removed BAT metric (its now part of POW)
• Android/iOS: Added Frame Times support
• Android: Added support for European S24’s GPU

• Injector: Remove reference to SDK

• Android: Memory metric updated to match Pro
• iOS: Fix for pink/corrupted screenshots
• Injector: Fix for 2GB .ipa limit

• iOS: Removed more iOS-private selector usage

• iOS: New FPS overlay (off by default normally, on by default in Performance Injector app)
• Android: upgraded libhwcpipe for better ARM Mali support
• iOS: Fix for negative timestamps when device sleeps between sessions
• iOS: Removed usage of iOS-private selectors which triggered warnings in TestFlight
• Unity: Deprecated API warnings fixed
• Injector: Support for SSO.

• iOS: Fix for missing FPS and screenshots on Unity 2022+

• Introduced the ‘App Injector’ - a desktop GUI app injects the SDK into pre-built mobile apps and is now the easiest way to use the SDK. No developers required! The injector is a separate download because it’s built in ElectronJS and is ~400MB.
• Android: fixed crash when retrying uploads.
• Android: Overlay added (on by default for Injector builds, off by default for normal integrations)
• Android: Status bar notification added (off unless explicitly opted into in Settings app)
• Android: Fix for negative timestamps in dashboard (triggered by device sleeping)

• Added GPU usage support for Galaxy S23.

• Support for session start/stop coordination with ProNet
• Galaxy S23 added to internal device db

• Fixed excessive WebRTC logging
• Upload status toast enabled for WebRTC apps

• Android 14 now supported
• Android: disabled dangerous hooks on future OS versions

• Android: 32-bit specific crash fix

• 5G cell info recording update
• C# upload callbacks work again
• Android: Crash fixes.

• Android: Cell network info collection enabled
• Android: Added frame size to WebRTC stats
• Android: Fixed crash when themed activity starts

• Android: WebRTC stats collection enabled

• Android: WebRTC fixes

• Android: fix occasional silent crash during large session upload

• Temporary disabling of HTTP interception.

• Android: New & renderer-independent screenshot technique.
• Android: Added new GPUs to the internal db.
• Initial Lua scripting support.
• Initial Production Mode support.

• iOS: New technique for network interception
• iOS: GBTool now handles .app as well as .ipa
• Android: fix for GL-related crash specific to Samsung’s Android 8.0.x
• Android: fix for device-specific crash
• Android: improved network monitoring

• iOS: Fix for stalled network connections

• Thermal throttle tracking on both iOS & Android
• iOS: Fix for crash in network metric collection
• iOS: Device type now reported directly
• iOS: Fix for out-of-scope memory usage picked up by lint

• Android: logcat capture now supported
• Unity: Restored the Reset() API removed in 1.0.0.
• Android: app Activity churn caused by config changes no longer triggers auto session stop+start
• GBTool reimplemented in Java.
• Android: Numerous important fixes as a result of latest round of Play Store app testing.
• Android: Fixed occasionally corrupted screenshots in GL apps.
• Android: Fixed memory leak.
• iOS: Fixed memory leak.
• iOS: Fixed missing battery consumption metric.

• Android: fixed graphic buffer leak in screenshot capture

• Reworked Android session uploader to use JobService
• Removed Android status bar notification

• iOS code signing fix
• Android: Fix for crash caused by clash with Mali Graphics Debugger
• iOS: Fix for rare crash on session stop
• iOS: Fix for NSURLSession KVO crash
• tvOS: Added missing .meta files

• Added Java/Kotlin bindings
• Removed unused Reset() C# API
• Fixed rare GPU-related crash
• Initial tvOS support
• Initial network connections support

• Fix for crash when run with unsupported Mali GPU.

• Vulkan screenshot fix (brief black screen on scene change)
• GPU usage metric now supports most Qualcomm GPUs
• New ‘gbtool’ for integrating SDK with prebuilt .apks

• Fix for crash on startup on some 32-bit phones

• Brought forward new screenshot impl. from 1.0

• Fix for Android O crash caused by FORTIFY parameter validation in libc’s readdir().

• Workaround for ANR on Android 6 when early (buggy) libvulkan.so in use. We avoid touching libvulkan entirely in this (very rare) config, resulting in no FPS or screenshots.

• Fixed bug where sdkEnable=false in batchmode build left SDK enabled.
• Unity Editor : Token editbox validation removed (internal request).

• Fixed no screenshots when Unity scene changes.
• Fixed missing .meta files in iOS framework.

• Appium support. Example client code in JavaScript, C#, and Java may be found in the distributed package.
• Marker APIs now have optional ‘marker group’ parameter.

• Added C# API: GetSessionID()

• Mem usage now includes swapped-out memory, to match Pro

• iOS: Bitcode is now enabled
• Disabling GameBench now results in no GameBench code in Unity builds
• Improved versioning (all binaries share same version and build ID)
• GameBench version numbers now included in session uploads
• Android: Improved detection of when app goes to background (automatic session)
• Android: Fixed FPS/screenshot loss when Vulkan renderer used with Optimized Frame Pacing

• Email validation relaxed to allow LDAP usernames

• Added support for GameBench servers behind a Google Identity-Aware Proxy (IAP).

• Android 4.x now ’tolerated’, i.e. doesn’t crash. Session capture on 4.x will be in a future release.
• Android minimum SDK lowered from 21 to 16.

• Fixed crashes in iOS network traffic measurement
• Corrected Android netstats measurement
• Added consumer ProGuard rule to prevent custom Android builds stripping out GameBench code
• Fixed for crash/hang on upload triggered when upload URL has no path

• Config file location now defaults to <project root>/ProjectSettings/GameBench.json.
• Minor C# Editor script changes for .NET 3.5 compatibility
• Removed use of ConcurrentQueue in Runtime script as it upsets commonly-used test environments
• Welcome dialog no longer tries to display in batch mode
• iOS: Injected .cpp files now use relative paths in project file

• Fixed another crash in iOS network traffic measurement
• Corrected Android netstats measurement
• Added consumer ProGuard rule to prevent custom Android builds stripping out our code
• Fixed for crash/hang on upload triggered when upload URL has no path

• Fixed a crash in iOS network traffic measurement

• iOS network traffic stats now includes socket-based IO
• Android upload UX disabled in release builds

• Fixed build break for Android-only users.

• Screenshots
• Network metrics
• Config now converted to generated source code to avoid JSON parsing on startup.
• API CHANGES:
• Tag methods are now SetTag() and RemoveTag().
• The other Config*() methods are replaced by the SetConfigItem() method.
• MetricEnable() and MetricDisable() are both replaced by SetCaptureInterval().
• There is a new CaptureNow() method for capturing metrics and screenshots in code, i.e. in response to specific in-game events instead of on a timer.
• Many smaller bugfixes

• Workaround for Unity 2018 bug re. RuntimeInitializeOnLoadMethod handling.

• Fixed compiler warning caused by unused member data.

• Fix for scripted session Upload() failing after Stop().

• Fix for a managed code stripping issue.

• Fixed omission of ‘static’ qualifiers on API methods.

• Fixed compile error if used with the in-editor player.

• First release that’s compatible with Unity Package Manager.