Hyperion - App Inspection Tool
What is it?
Hyperion is a hidden plugin drawer that can easily be integrated into any app. The drawer sits discreetly
Please see our annoucement blog post for a feature showcase.
Be one of the first to create a third-party plugin. The plugin creation guide is a work in progress, but if you are feeling ambitious you can reference the plugins we have already created.
To create your own plugin, implement the Plugin interface and expose the implementation as a service. The plugins made available in this repository leverage Google's AutoService annotation processor to generate the service metadata and simplify the process.
How To Show Hyperion Plugin List
Once Hyperion is integrated into your app, simply shake your phone to activate. If you are running your app on an emulator, you can manually open the menu by calling
Hyperion.open(Activity activity). You can also open the menu by selecting the foreground notification that appears while the client app is in the foreground.
Want to learn how to use Hyperion? The sample app will teach you!
Build the example project by cloning the repo, run
./gradlew assemble from the root directory, then open in Android Studio and run.
min SDK 15
Download via Maven:
<dependency> <groupId>com.willowtreeapps.hyperion</groupId> <artifactId>hyperion-core</artifactId> <version>0.9.24</version> </dependency>
If you reference Hyperion from your code, you should also compile the no-op artifact for release variants. For most users, this will not be necessary:
Include the core library along with any number of plugins.
debugImplementation 'com.willowtreeapps.hyperion:hyperion-core:0.9.24' debugImplementation 'com.willowtreeapps.hyperion:hyperion-attr:0.9.24' debugImplementation 'com.willowtreeapps.hyperion:hyperion-measurement:0.9.24' debugImplementation 'com.willowtreeapps.hyperion:hyperion-disk:0.9.24' debugImplementation 'com.willowtreeapps.hyperion:hyperion-recorder:0.9.24' debugImplementation 'com.willowtreeapps.hyperion:hyperion-phoenix:0.9.24' debugImplementation 'com.willowtreeapps.hyperion:hyperion-crash:0.9.24' debugImplementation 'com.willowtreeapps.hyperion:hyperion-shared-preferences:0.9.24' debugImplementation 'com.willowtreeapps.hyperion:hyperion-geiger-counter:0.9.24' debugImplementation 'com.willowtreeapps.hyperion:hyperion-timber:0.9.24' debugImplementation 'com.willowtreeapps.hyperion:hyperion-build-config:0.9.24'
Hyperion plugins need to be added into the app at build time. By default, Hyperion automatically finds every plugin that is available in the project using the Java Service Locator.
Contributing to Hyperion
Contributions are welcome. Please see the Contributing guidelines.
The following is a list of all plugins that integrate with Hyperion. Please make a pull request if you would like to see your plugin here:
Third Party Plugins
- Hyperion-Chuck - Plugin which adds a button to inspect OkHttp traffic using Chuck
- Hyperion-AppInfo - Plugin which shows screen of details about an application
- Hyperion-Simple-Item - Plugin which adds simple menus
- Hyperion-DBFlow-Manager - Plugin which adds a button in inspect DBFlow databases and apply queries on it locally.
- Hyperion-kfin-state-machine - Plugin for checking the state of registered kfin-state-machine instances.
- Hyperion-Geiger-Counter - Check animation performance by listening for dropped frames. Please turn up the media volume. Haptic feedback is also supported. Inspired by KMCGeigerCounter.
- Hyperion-Timber - View Timber recorded log messages.
- Hyperion-Shared-Preferences - View and edit your app's key-value storage.
- Hyperion-Build-Config - View application BuildConfig values.
Hyperion is available under the MIT license. See the LICENSE file for more info.
We build apps, responsive sites, bots—any digital product that lives on a screen—for the world’s leading companies. Our elite teams challenge themselves to build extraordinary experiences by bridging the latest strategy and design thinking with enterprise-grade software development.
Interested in working on more unique projects like Hyperion? Check out our careers page.