README.md
1
2
3[](https://jitpack.io/#PhilJay/MPAndroidChart)
4[](https://android-arsenal.com/api?level=14)
5[](http://android-arsenal.com/details/1/741)
6[](https://gitter.im/PhilJay/MPAndroidChart?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=body_badge)
7[](http://twitter.com/mpandroidchart)
8
9:zap: A powerful & easy to use chart library for Android :zap:
10
11[**Charts**](https://github.com/danielgindi/Charts) is the iOS version of this library
12
13## Table of Contents
141. [Quick Start](#quick-start)
15 1. [Gradle](#gradle-setup)
16 1. [Maven](#maven-setup)
171. [Documentation](#documentation)
181. [Examples](#examples)
191. [Questions](#report)
201. [Donate](#donate)
211. [Social Media](#social)
221. [More Examples](#more-examples)
231. [License](#licence)
241. [Creators](#creators)
25
26### Gradle Setup
27
28```gradle
29repositories {
30 maven { url 'https://jitpack.io' }
31}
32
33dependencies {
34 implementation 'com.github.PhilJay:MPAndroidChart:v3.1.0'
35}
36```
37
38### Maven Setup
39
40```xml
41<!-- <repositories> section of pom.xml -->
42<repository>
43 <id>jitpack.io</id>
44 <url>https://jitpack.io</url>
45</repository>
46
47<!-- <dependencies> section of pom.xml -->
48<dependency>
49 <groupId>com.github.PhilJay</groupId>
50 <artifactId>MPAndroidChart</artifactId>
51 <version>v3.1.0</version>
52</dependency>
53```
54
55<br/>
56
57<h2 id="documentation">Documentation :notebook_with_decorative_cover:</h2>
58
59See the [**documentation**](https://weeklycoding.com/mpandroidchart/) for examples and general use of MPAndroidChart.
60
61See the [**javadocs**](https://jitpack.io/com/github/PhilJay/MPAndroidChart/v3.1.0/javadoc/) for more advanced documentation.
62
63<br/>
64
65<h2 id="examples">Examples :eyes:</h2>
66
67Download the [MPAndroidChart Example App](https://play.google.com/store/apps/details?id=com.xxmassdeveloper.mpchartexample) or look at the [source code](https://github.com/PhilJay/MPAndroidChart/tree/master/MPChartExample).
68
69[](https://www.youtube.com/watch?v=ufaK_Hd6BpI)
70
71<br/>
72
73<h2 id="report">Questions & Issues :thinking:</h2>
74
75This repository's issue tracker is only for bugs and feature requests. The maintainers ask that you refrain from asking questions about how to use MPAndroidChart through the issue tracker.
76
77Please read the [**documentation**](https://weeklycoding.com/mpandroidchart/) first, then ask all your questions on [stackoverflow.com](https://stackoverflow.com/questions/tagged/mpandroidchart) for the fastest answer.
78
79<br/>
80
81<h2 id="donate">Donations :heart:</h2>
82
83**This project needs you!** If you would like to support this project's further development, the creator of this project or the continuous maintenance of this project, **feel free to donate**. Your donation is highly appreciated (and I love food, coffee and beer). Thank you!
84
85**PayPal**
86
87- [**Donate 5 $**](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=7G52RA87ED8NY): Thank's for creating this project, here's a coffee (or some beer) for you!
88- [**Donate 10 $**](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=4C9TPE67F5PUQ): Wow, I am stunned. Let me take you to the movies!
89- [**Donate 15 $**](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=YKMPTFMVK3JMC): I really appreciate your work, let's grab some lunch!
90- [**Donate 25 $**](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=H9JA4QX7UHXCY): That's some awesome stuff you did right there, dinner is on me!
91- Or you can also [**choose what you want to donate**](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=EGBENAC5XBCKS), all donations are awesome!
92
93<br/>
94
95<h2 id="social">Social Media :fire:</h2>
96
97If you like this library, please tell others about it :two_hearts: :two_hearts:
98
99[](https://twitter.com/intent/tweet?text=Check%20out%20the%20awesome%20MPAndroidChart%20library%20on%20Github:%20https://github.com/PhilJay/MPAndroidChart)
100[](https://plus.google.com/share?url=https://github.com/PhilJay/MPAndroidChart)
101[](https://www.facebook.com/sharer/sharer.php?u=https://github.com/PhilJay/MPAndroidChart)
102
103If you like, you can follow me on Twitter [**@PhilippJahoda**](https://twitter.com/PhilippJahoda).
104
105<br/>
106
107<h2 id="more-examples">More Examples :+1:</h2>
108
109<br/>
110
111**LineChart (with legend, simple design)**
112
113
114<br/><br/>
115
116**LineChart (with legend, simple design)**
117
118
119<br/><br/>
120
121**LineChart (cubic lines)**
122
123
124<br/><br/>
125
126**LineChart (gradient fill)**
127
128
129<br/><br/>
130
131**BarChart (with legend, simple design)**
132
133
134<br/><br/>
135
136**BarChart (grouped DataSets)**
137
138
139<br/><br/>
140
141**Horizontal-BarChart**
142
143
144<br/><br/>
145
146**Combined-Chart (bar- and linechart in this case)**
147
148
149<br/><br/>
150
151**PieChart (with selection, ...)**
152
153
154<br/><br/>
155
156**ScatterChart** (with squares, triangles, circles, ... and more)
157
158
159<br/><br/>
160
161**CandleStickChart** (for financial data)
162
163
164<br/><br/>
165
166**BubbleChart** (area covered by bubbles indicates the yValue)
167
168
169<br/><br/>
170
171**RadarChart** (spider web chart)
172
173
174
175<br/>
176
177<h1 id="license">License :page_facing_up:</h1>
178
179Copyright 2020 Philipp Jahoda
180
181Licensed under the Apache License, Version 2.0 (the "License");
182you may not use this file except in compliance with the License.
183You may obtain a copy of the License at
184
185> http://www.apache.org/licenses/LICENSE-2.0
186
187Unless required by applicable law or agreed to in writing, software
188distributed under the License is distributed on an "AS IS" BASIS,
189WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
190See the License for the specific language governing permissions and
191limitations under the License.
192
193<br/>
194
195<h2 id="creators">Special Thanks :heart:</h2>
196
197These people rock!
198
199- [danielgindi](https://github.com/danielgindi) - Daniel Gindi
200- [mikegr](https://github.com/mikegr) - Michael Greifeneder
201- [tony](https://github.com/tonypatino-monoclesociety) - Tony
202- [almic](https://github.com/almic) - Mick A.
203- [jitpack.io](https://github.com/jitpack-io) - JitPack.io
204