AndroidDevMetrics Runtime

Performance metrics library for Android development

License

License

Categories

Categories

Metrics Application Testing & Monitoring Monitoring
GroupId

GroupId

com.frogermcs.androiddevmetrics
ArtifactId

ArtifactId

androiddevmetrics-runtime
Last Version

Last Version

0.6
Release Date

Release Date

Type

Type

aar
Description

Description

AndroidDevMetrics Runtime
Performance metrics library for Android development
Project URL

Project URL

https://github.com/frogermcs/androiddevmetrics
Source Code Management

Source Code Management

https://github.com/frogermcs/androiddevmetrics

Download androiddevmetrics-runtime

How to add to project

<!-- https://jarcasting.com/artifacts/com.frogermcs.androiddevmetrics/androiddevmetrics-runtime/ -->
<dependency>
    <groupId>com.frogermcs.androiddevmetrics</groupId>
    <artifactId>androiddevmetrics-runtime</artifactId>
    <version>0.6</version>
    <type>aar</type>
</dependency>
// https://jarcasting.com/artifacts/com.frogermcs.androiddevmetrics/androiddevmetrics-runtime/
implementation 'com.frogermcs.androiddevmetrics:androiddevmetrics-runtime:0.6'
// https://jarcasting.com/artifacts/com.frogermcs.androiddevmetrics/androiddevmetrics-runtime/
implementation ("com.frogermcs.androiddevmetrics:androiddevmetrics-runtime:0.6")
'com.frogermcs.androiddevmetrics:androiddevmetrics-runtime:aar:0.6'
<dependency org="com.frogermcs.androiddevmetrics" name="androiddevmetrics-runtime" rev="0.6">
  <artifact name="androiddevmetrics-runtime" type="aar" />
</dependency>
@Grapes(
@Grab(group='com.frogermcs.androiddevmetrics', module='androiddevmetrics-runtime', version='0.6')
)
libraryDependencies += "com.frogermcs.androiddevmetrics" % "androiddevmetrics-runtime" % "0.6"
[com.frogermcs.androiddevmetrics/androiddevmetrics-runtime "0.6"]

Dependencies

compile (3)

Group / Artifact Type Version
org.aspectj : aspectjrt jar 1.8.8
com.android.support » support-compat jar 26.1.0
com.android.support » appcompat-v7 jar 26.1.0

Project Modules

There are no modules declared in this project.

AndroidDevMetrics

(formerly dagger2metrics)

Performance metrics library for Android development.

Android Arsenal

The problem with performance is that it often decreases slowly so in day-by-day development it's hard to notice that our app (or Activity or any other view) launches 50ms longer. And another 150ms longer, and another 100ms...

With AndroidDevMetrics you will be able to see how performant are the most common operations like object initialization (in Dagger 2 graph), or Activity lifecycle methods (onCreate(), onStart(), onResume()).

It won't show you exact reason of performance issues or bottlenecks (yet!) but it can point out where you should start looking first.

AndroidDevMetrics currently includes:

  • Activity lifecycle metrics - metrics for lifecycle methods execution (onCreate(), onStart(), onResume())
  • Activity lifecycle methods tracing without app recompiling
  • Frame rate drops - metrics for fps drops for each of screens (activity)
  • Dagger 2 metrics - metrics for objects initialization in Dagger 2

screenshot1.png

screenshot.png

Getting started

Script below shows how to enable all available metrics.

In your build.gradle:

 buildscript {
  repositories {
    jcenter()
  }

  dependencies {
    classpath 'com.frogermcs.androiddevmetrics:androiddevmetrics-plugin:0.7'
  }
}

apply plugin: 'com.android.application'
apply plugin: 'com.frogermcs.androiddevmetrics'

In your Application class:

public class ExampleApplication extends Application {

 @Override
 public void onCreate() {
     super.onCreate();
     //Use it only in debug builds
     if (BuildConfig.DEBUG) {
         AndroidDevMetrics.initWith(this);
     }
  }
 }

How does it work?

Detailed description how it works under the hood can be found on wiki pages:

I found performance issue, what should I do next?

There is no silver bullet for performance issues but here are a couple steps which can help you with potential bugs hunting.

If measured time of object initialization or method execution looks suspicious you should definitely give a try to TraceView. This tool logs method execution over time and shows execution data, per-thread timelines, and call stacks. Practical example of TraceView usage can be found in this blog post: Measuring Dagger 2 graph creation performance.


If it seems that layout or view can be a reason of performance issue you should start with those links from official Android documentation:


Finally, if you want to understand where most of performance issues come from, here is a collection of videos focused entirely on helping developers write faster, more performant Android Applications.

Example app

You can check GithubClient - example Android app which shows how to use Dagger 2. Most recent version uses AndroidDevMetrics for measuring performance.

Building AndroidDevMetrics

Build AndroidDevMetrics plugin with [./gradlew clean build]. The tests can be run with ./gradlew clean test. To install the plugin in your local maven repository (usually located at ~/.m2/repository) use ./gradlew clean install. You can change VERSION_NAME value in gradle.properties to easily recognise your version.

License

Copyright 2016 Miroslaw Stanek

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Versions

Version
0.6
0.3