README.md

android-kline

基于MPAndroidChart的专业K线图

简介

android-kline是Android平台的金融图表库，包括分时图和K线图。本项目通过继承的方式定制了最新版本的MPAndroidChart，解决了下面的问题：

• 解决了多图表手势同步的问题
• 解决多图表highlight联动的问题
• 使用简单，两行代码就可以实现专业K线效果

Demo

也可以点击这里下载

What's new

• 增加了MACD、KDJ指标的显示和切换
• 增加了五日的分时图
• 优化图表的缩放，可以进行放大和缩小操作（之前只支持在初始状态下的放大操作）
• 拼接图表的缩放功能（之前如果一个手指在K线图，另一个手指在交易量图的时候，图表是不可以缩放的）
• 全屏模式的示例
• 分时图增加涨跌幅的坐标，并且涨跌幅为0%时竖直居中显示
• K线图增加最大/最小值的显示

配置

在项目build.gradle中添加依赖：

 allprojects {
        repositories {
            jcenter()
            maven { url "https://jitpack.io" }
        }
   }
   dependencies {
        compile com.github.gzw19931217:android-kline:1.0.2'
   }

##快速开始

mTimeLineView = new TimeLineView(getContext());  //初始化分时图
mTimeLineView.setDateFormat("HH:mm");  // 设置x轴时间的格式
List<HisData> hisData =  ...  // 初始化数据，一般通过网络获取数据
mTimeLineView.setLastClose(hisData.get(0).getClose());  // 设置昨收价
mTimeLineView.initData(hisData);  // 初始化图表数据

xml

    <com.guoziwei.klinelib.chart.KLineView
        android:id="@+id/kline"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

    <com.guoziwei.klinelib.chart.TimeLineView
        android:id="@+id/timeline"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

java

       KLineView  K线图控件
       public void showKdj() 显示kdj指标
       public void showMacd() 显示macd指标
       public void showVolume() 显示交易量指标
       public void initData(List<HisData> hisDatas) 初始化数据，获取到数据后调用
       public void addData(HisData hisData) 图表末尾增加一个数据
       public void refreshData(float price) 刷新最后一个点的价格（不增加数据）
       
       
       TimeLineView 分时图控件
       public void initData(List<HisData> hisDatas) 初始化数据，获取到数据后调用
       public void addData(HisData hisData) 图表末尾增加一个数据
       public void refreshData(float price) 刷新最后一个点的价格（不增加数据）
       public void initDatas(List<HisData>... hisDatas) 初始化多日的数据，比如说5日的数据，就传5个list过去
       public void setLastClose(double lastClose)  设置昨天的收盘价，用于计算涨跌幅的坐标
       
       两个类共同的api：
       public void setCount(int init, int max, int min) 设置图标的可见个数，分别是初始值，最大值，最小值。比如(100,300,50)就是开始的时候100个点，最小可以缩放到300个点，最大可以放大到50个点
       public void setDateFormat(String format) 设置x轴时间的格式
       public void setLastClose(douhle lastClose) 设置昨收价格，用于计算涨跌幅
       

注意： 这里需要接收一个HisData的List，HisData需要如下的几个数据（开盘、收盘、最高、最低、买卖量、时间），其他的指标会根据公式计算出来

在本项目中，时间戳date相当于唯一的id，如果重复的话无法将这个date添加到图表中

  public HisData(double open, double close, double high, double low,  long vol, long date)

个性化：如果需要配置颜色，可以到colors.xml中重写颜色的值。

反馈

欢迎各位提issues和PRs！

联系方式

qq群: 629878453

email: [email protected]

License

Copyright gzw19931217 [email protected]

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.