build-time-tracker-plugin

Gradle plugin to continuously track and report your build times

  • 所有者: passy/build-time-tracker-plugin
  • 平台:
  • 許可證: Apache License 2.0
  • 分類:
  • 主題:
  • 喜歡:
    0
      比較:

Github星跟蹤圖

Build Time Tracker

Build Status
Maven Version
Stories in Ready

How much time do you spend each day waiting for Gradle? Now you know!

Features

  • Sortable bar chart summaries
  • CSV output
  • Daily and total summary

Screenshot

Screenshot

Usage

Apply the plugin in your build.gradle. On Gradle >2.1 you can do this
using the Plugin DSL Syntax:

plugins {
  id "net.rdrei.android.buildtimetracker" version "0.11.0"
}

Otherwise, use it as classpath dependency:

buildscript {
  repositories {
    mavenCentral()
  }

  dependencies {
    classpath "net.rdrei.android.buildtimetracker:gradle-plugin:0.11.+"
  }
}

apply plugin: "build-time-tracker"

Configure the plugin:

buildtimetracker {
  reporters {
    csv {
      output "build/times.csv"
      append true
      header false
    }

    summary {
      ordered false
      threshold 50
      barstyle "unicode"
    }

    csvSummary {
      csv "build/times.csv"
    }
  }
}

Using the SNAPSHOT release:

buildscript {
  repositories {
    maven { url "https://oss.sonatype.org/content/repositories/snapshots/" }
  }

  dependencies {
    classpath "net.rdrei.android.buildtimetracker:gradle-plugin:0.12.0-SNAPSHOT"
  }
}

Difference to --profile

You may wonder why you would want to use this plugin when gradle has
a built-in build
profiler
.
The quick version is, that if you just want to quickly check what it is that's
slowing down your build, --profile will be all you need. However, if you want
to continuously monitor your build and find bottlenecks that develop over time,
this plugin may be the right fit for you. build-time-tracker writes a
continuous log that is monoidal and can be collected from various different
machines to run statistical analyses. Importantly, the written files contain
identifying information about the machine the build happened on so you can
compare apples with apples.

Reporters

CSVReporter

The csv reporter takes the following options:

  • output: CSV output file location relative to Gradle execution.
  • append: When set to true the CSV output file is not truncated. This is
    useful for collecting a series of build time profiles in a single CSV.
  • header: When set to false the CSV output does not include a prepended
    header row with column names. Is desirable in conjunction with append.

A basic R Markdown script, report.Rmd is
included for ploting and analysing build times using CSV output.

CSVSummaryReporter

The csvSummary displays the accumulated total build time from a CSV file.
The reporter takes the following option:

  • csv: Path (relative to the gradle file or absolute) to a CSV file created
    with the above reporter and the options append = true and header = false.

SummaryReporter

The summary reporter gives you an overview of your tasks at the end of the
build. It has the following options:

  • threshold: (default: 50) Minimum time in milliseconds to display a task.
  • ordered: (default: false) Whether or not to sort the output in ascending
    order by time spent.
  • barstyle: (default: "unicode") Supports "unicode", "ascii" and "none" for
    displaying a bar chart of the relative times spent on each task.
  • successOutput: (default: "true") Redisplay build success or failure message
    so you don't miss it if the summary output is long.
  • shortenTaskNames: (default: "true") Shortens long tasks names.

Note This plugin only measures the task times that constitute a build.
Specifically, it does not measure the time in configuration at the start
of a Gradle run. This means that the time to execute a build with very fast
tasks is not accurately represented in output because it is dominated by
the time in configuration instead.

Developing

This project is built and tested by Travis at
passy/build-time-tracker-plugin.

Acknowledgements

Thanks to Sindre Sorhus for contributing the
wonderful logo!

License

Copyright 2014 Pascal Hartig

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.

主要指標

概覽
名稱與所有者passy/build-time-tracker-plugin
主編程語言Groovy
編程語言Groovy (語言數: 2)
平台
許可證Apache License 2.0
所有者活动
創建於2014-07-29 10:04:48
推送於2019-05-28 13:34:49
最后一次提交2018-08-14 19:37:56
發布數20
最新版本名稱v0.11.1 (發布於 2018-08-14 19:37:43)
第一版名稱v0.1.0 (發布於 2014-08-01 18:24:48)
用户参与
星數1.2k
關注者數18
派生數67
提交數209
已啟用問題?
問題數53
打開的問題數20
拉請求數45
打開的拉請求數1
關閉的拉請求數4
项目设置
已啟用Wiki?
已存檔?
是復刻?
已鎖定?
是鏡像?
是私有?