InAppDevTools

<!-- # InAppDevTools --> <p align="center"> <img src="https://github.com/rafaco/InAppDevTools/wiki/images/social.png" width="50%"> </p> <p align="center"> <a href="https://www.android.com/" alt="Platform"> <img src="https://img.shields.io/badge/Platform-Android-green.svg?style=flat"/></a> <a href="https://github.com/rafaco/InAppDevTools/wiki/Coding-contributions-guide#project-structure" alt="Artifacts"> <img src="https://img.shields.io/badge/Artifacts-Plugin_and_libraries-purple.svg?style=flat"/></a> <a href="https://github.com/rafaco/InAppDevTools/commits" alt="Maturity"> <img src="https://img.shields.io/badge/Maturity-development-orange.svg?style=flat"/></a> </br> <a href="https://github.com/rafaco/InAppDevTools/releases" alt="Version"> <img src="https://img.shields.io/maven-metadata/v/https/jcenter.bintray.com/es/rafaco/inappdevtools/support/maven-metadata.xml.svg?colorB=blue&label=Version&style=flat"/></a> <a href="https://circleci.com/gh/rafaco/InAppDevTools/tree/master" alt="CircleCi Status"> <img src="https://circleci.com/gh/rafaco/InAppDevTools/tree/master.svg?style=shield"/></a> <a href="https://sonarcloud.io/dashboard?id=rafaco_InAppDevTools" alt="Sonar Status"> <img src="https://sonarcloud.io/api/project_badges/measure?project=rafaco_InAppDevTools&metric=alert_status"/></a> <a href="https://sonarcloud.io/dashboard?id=rafaco_InAppDevTools" alt="Sonar lines count"> <img src="https://sonarcloud.io/api/project_badges/measure?project=rafaco_InAppDevTools&metric=ncloc"/></a> </br> <a href="https://git.io/IADT" alt="ShortLink"> <img src="https://img.shields.io/badge/ShortLink-git.io%2FIADT-blueviolet.svg?style=flat&logo=github"/></a> <a href="https://www.openhub.net/p/InAppDevTools" alt="OpenHub"> <img src="https://www.openhub.net/p/InAppDevTools/widgets/project_thin_badge.gif"/></a> <!-- <a href="https://android-arsenal.com/details/1/887" alt="Android Arsenal"> <img src="https://img.shields.io/badge/Android%20Arsenal-InAppDevTools-brightgreen.svg?style=flat"/></a> <a href="https://www.openhub.net/p/InAppDevTools" alt="OpenHub"> <img src="https://www.openhub.net/p/InAppDevTools/widgets/project_thin_badge.gif"/></a>--> </p>

A library to enhance the internal compilations of any Android app, adding useful tools for their early stage users. They can get info on what they are testing, send comprehensive crash reports and deeply inspect their running app on the go. It also bring a customizable team panel and other helpful tools, all within your app.

<p align="center"> <img src="https://github.com/rafaco/InAppDevTools/wiki/Lunatic/NonDevBanners/ScreenBanner1.gif" width="24%"> <img src="https://github.com/rafaco/InAppDevTools/wiki/Lunatic/NonDevBanners/ScreenBanner2.gif" width="24%"> <img src="https://github.com/rafaco/InAppDevTools/wiki/Lunatic/NonDevBanners/ScreenBanner3.gif" width="24%"> <img src="https://github.com/rafaco/InAppDevTools/wiki/Lunatic/NonDevBanners/ScreenBanner4.gif" width="24%"> </p> <p align="center"> <img src="https://github.com/rafaco/InAppDevTools/wiki/Lunatic/Devs/Screen1.gif" width="24%"> <img src="https://github.com/rafaco/InAppDevTools/wiki/Lunatic/Devs/Screen2.gif" width="24%"> <img src="https://github.com/rafaco/InAppDevTools/wiki/Lunatic/Devs/Screen3.gif" width="24%"> <img src="https://github.com/rafaco/InAppDevTools/wiki/Lunatic/Devs/Screen4.gif" width="24%"> </p>

All your internal users (QA, managers, client, beta testers...) can get precise information on what they are testing and use an exclusive panel customized by the dev team with actions and resources. They also can send contextualized reports, which automagically include highly valuable information like repro steps, screenshots, crash details, full logs and environment info (app, build, repo status, device and OS).</p>

For developers this is conceptually similar to Chrome DevTools but packed inside your app, a revolutionary concept that enhance their daily compilations. We provide a complete set of tools to inspect, analyze and modify a running app from within it, without cable and on the go. It helps them to understand what's really happening underneath in order to highlight issues and bug causes. They also receive comprehensive reports, can customize our tools for others and can make use of some coding helpers.

Production users get neither any of our features nor apk size increase. They get a spotless app thoroughly polished in an agile development process, enhanced by our tools :)

Tools

Auto-logger, repro step generator, logcat viewer, crash handler, reports, source browser, layout inspector, component browser, storage editor, network activity, info panels (apk , build, repo, device and os), coding helpers and much more.

Characteristics

• Usable everywhere without cable, our UI overlap your app.
• Easy to install, just add our dependencies to your Gradle files.
• Careful with your releases, where everything will be auto disabled by default.
• Flexible to configure via Gradle extension.
• Handy integrations available to improve the experience of your testers and to assist your developers.

Features

<table border="0"> <tr><td width="2%" align="center" valign="top"><img src="https://github.com/rafaco/InAppDevTools/wiki/screenshots/Animated/Screenshots_Info.gif"></td><td>

App and device info
Get detailed information about what are you testing and where. The build process (variant, type, date, machine, user, gradle versions, dependencies,...), the sources used (remote repo status, local repo, commits and change diffs...), the resulting app (manifest, version, namespace, signing, installation...), the device where is running (model, hardware, battery, sensors...) and their operative system (version, status, memory, storage, installed apps...).

</td></tr> <tr><td width="20%" align="center" valign="top"><img src="https://github.com/rafaco/InAppDevTools/wiki/screenshots/Animated/Screenshots_Team.gif"></td><td>

Team resources and reports
Provide your own resources for your internal users via Gradle configuration (team name, description, build notes, external links and action buttons. Your users can easily send report directly to the development team. Reports can include a zip with all gathered data (environment info, logs, screenshots, crash details, network request, logic snapshot...).

</td></tr> <tr><td width="20%" align="center" valign="top"><img src="https://github.com/rafaco/InAppDevTools/wiki/screenshots/Animated/Screenshots_Crash.gif"></td><td>

Crash visualization and report
We intercept any exception and show details immediately, on the same screen where it happen. These details include app status, current activity, logs, screenshots and graphic stacktrace with navigation to causing source lines. Crashes can be reported via email and we will include a zip with all gathered details.

</td></tr> <tr><td width="20%" align="center" valign="top"><img src="https://github.com/rafaco/InAppDevTools/wiki/screenshots/Animated/Screenshots_Logs.gif"></td><td>

Logs, reproduction steps and advance events
Browse the standard logcat output from your sessions as you use your app. They are surrounded by our auto generated events to give you more context. Our event cover from basic reproduction steps (user interaction, navigation, network activity...) to advanced entries (lifecycle events, crashes, ANRs, device events...).

</td></tr> <tr><td width="20%" align="center" valign="top"><img src="https://github.com/rafaco/InAppDevTools/wiki/screenshots/Animated/Screenshots_UI.gif"></td><td>

View inspector
Navigate through your current layout components by touching elements or by browsing your hierarchy. Modify xml properties straight away and see the results in your screen. Browse you current components and their sources (tasks, activity and fragments), zoom your screen, measure elements and take screenshots.

</td></tr> <tr><td width="20%" align="center" valign="top"><img src="https://github.com/rafaco/InAppDevTools/wiki/screenshots/Animated/Screenshots_Logic.gif"></td><td>

Logic and network inspector
Get details about your running logic components (processes, threads, services, content providers and broadcast receivers) and inspect the network request/responses between your backend and your app. Browse and edit your storages (databases, shared preferences and files) and edit their values.

</td></tr> </table>

Setup <a name="setup"/>

You only need to modify 2 gradle files. On your root build.gradle file:

buidscript {...}

plugins {
    id "es.rafaco.inappdevtools" version "0.0.58" apply false           // 1.
}

allprojects {
    repositories {
        maven { url "https://jitpack.io"}                               // 2.
    }
}

<details><summary align="center">Show details</summary><p>

1. Add our plugin in your plugins closure, which should be just before buildscript.
2. Add JitPack to allprojects, repositories.

</br></p></details>

On your app module build.gradle file:

apply plugin: 'com.android.application'
apply plugin: 'es.rafaco.inappdevtools'                                 // 1.

android {
    ...
}

dependencies {
    releaseImplementation 'es.rafaco.inappdevtools:noop:0.0.58'         // 2.
    
    debugImplementation 'es.rafaco.inappdevtools:support:0.0.58'        // 3.
    //debugImplementation 'es.rafaco.inappdevtools:androidx:0.0.58'
}

inappdevtools {                                                         // 4.
    enabled = true
    teamName = 'YourTeam'
    teamEmail = 'youremail@yourdomain.com'
    notes = 'First build note, replace me on the next ones.'
}

<details><summary align="center">Show details</summary><p>

1. Apply our plugin
2. Add our noop for your release builds
3. Choose between androidx or support for your debug builds, according to the Android libraries in your proje