Scalpel
A surgical debugging tool for Android that visualizes view hierarchies in 3D with interactive layer inspection.
What is Scalpel?
Scalpel is an Android debugging library that visualizes view hierarchies in an interactive 3D space, allowing developers to inspect the layers beneath their app's UI. It helps identify layout issues and understand complex view structures by providing surgical precision in debugging.
Android developers who need to debug complex view hierarchies, optimize layouts, or understand the layer structure of their UI components.
Developers choose Scalpel for its unique 3D interactive visualization of Android view layers, which offers a more intuitive and surgical approach to debugging compared to traditional 2D inspectors.
Overview
A surgical debugging tool to uncover the layers under your app.
Use Cases
Best For
- Debugging overlapping or nested view issues in Android layouts
- Understanding the depth and layer structure of complex UI hierarchies
- Inspecting view IDs and relationships in a visual 3D environment
- Identifying performance issues related to view depth and rendering
- Teaching or learning about Android view hierarchy concepts visually
- Replacing or supplementing older Android layout debugging tools
Not Ideal For
- Projects using Android Studio 4.0 or newer, as the built-in layout inspector includes a live-updating 3D view
- Apps targeting Android versions below 4.4, due to known text rendering issues that Scalpel cannot fix
- Teams requiring active library maintenance or regular updates, since Scalpel is deprecated
- Developers needing automated or server-side debugging tools, as Scalpel is client-side and manual
Pros & Cons
Pros
Provides a unique, interactive 3D space to explore view hierarchies with rotation, zoom, and layer spacing adjustments via touch gestures, as shown in the sample GIF.
Can be wrapped around activity layouts only in debug builds using Gradle, ensuring it doesn't affect production code, as mentioned in the README.
Allows toggling wireframe mode, displaying view IDs, and changing chrome colors for better visibility during debugging, per the usage instructions.
Emphasizes precision in uncovering underlying view architecture, helping identify layout issues and complex structures intuitively.
Cons
Officially deprecated, as Android Studio 4.0's layout inspector now includes a live-updating 3D view, making Scalpel irrelevant for modern development.
Has known text rendering issues on Android versions prior to 4.4 that cannot be fixed, limiting its effectiveness for legacy apps, as admitted in the README.
Requires placing a ScalpelFrameLayout at the root of the hierarchy and enabling features programmatically, adding overhead compared to integrated tools.
Lacks live-updating capabilities for dynamic view changes, reducing debugging efficiency compared to Android Studio's real-time inspector.
Frequently Asked Questions
Related Projects
Facebook StethoStetho is a debug bridge for Android applications, enabling the powerful Chrome Developer Tools and much more.
Android Debug Bridge - ADBADB Usage Complete / ADB 用法大全
Android Debug DatabaseA library for debugging android databases and shared preferences - Make Debugging Great Again
PidcatColored logcat script which only shows log entries for a specific application package.
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.