推荐一款第三方的日历框架------CalendarView

简介

Android上一个优雅、高度自定义、性能高效的日历控件，完美支持周视图，支持标记、自定义颜色、农历等，任意控制月视图显示、任意日期拦截条件、自定义周起始等。Canvas绘制，极速性能、占用内存低，支持简单定制即可实现任意自定义布局、自定义UI，支持收缩展开、性能非常高效， 这个控件内存和效率优势相当明显，而且真正做到收缩+展开，适配多种场景，支持同时多种颜色标记日历事务，支持多点触控，你真的想不到日历还可以如此优雅！

与其他日历框架对比

日历控件定制是移动开发平台上比较常见的而且比较难的需求，一般会遇到以下问题：

• 性能差，加载速度慢，原因是各种基于GridView或RecyclerView等ViewGroup实现的日历，控件数太多，假设一个月视图界面有42个item，每个item里面分别就有2个子TextView：天数、农历数和本身3个控件，这样一个月视图就有42 * 3+1（RecyclerView or GridView），清楚ViewPager特性的开发者就会明白，一般ViewPager持有3个item，那么一个日历控件持有的View控件数的数量将达到 1（ViewPager）+ 3(RecyclerView or GridView) + 3 * 42 * 3 = 382，如果用1个View来代替RecyclerView等，用Canvas来代替各种TextView，那View的数量瞬间将下降360+，内存和性能优势将相当明显了
• 难定制 一般日历框架发布的同时也将UI风格确定下来了，假如人人都使用这个日历框架，那么将会千篇一律，难以突出自己的风格，要么就得改源码，成本太大，不太实际
• 功能性不足 例如无法自定义周起始、无法更改选择模式、动态设置UI等等
• 无法满足产品经理提出的变态需求 今天产品经历说我们要这样的实现、明天跟你说这里得改、后天说我们得限制一些日期…

但现在有了全新的 CalendarView 控件，它解锁了各种姿势，而且你可以任意定制，直到你满足为止…

插拔式设计

插拔式设计：好比插座一样，插上灯泡就会亮，插上风扇就会转，看用户需求什么而不是看插座有什么，只要是电器即可。此框架使用插拔式，既可以在编译时指定年月日视图，如：app:month_view=“xxx.xxx.MonthView.class”，也可在运行时动态更换年月日视图，如：CalendarView.setMonthViewClass(MonthView.Class)，从而达到UI即插即用的效果，相当于框架不提供UI实现，让UI都由客户端实现，不至于日历UI都千篇一律，只需遵守插拔式接口即可随意定制，自由化程度非常高。

CalendarView 的特性

• 基于Canvas绘制，极速性能
• 热插拔思想，任意定制周视图、月视图，即插即用！
• 支持单选、多选、范围选择、国内手机日历默认自动选择等选择模式
• 支持静态、动态设置周起始，一行代码搞定
• 支持静态、动态设置日历项高度、日历填充模式
• 支持设置任意日期范围、任意拦截日期
• 支持多点触控、手指平滑切换过渡，拒绝界面抖动
• 类NestedScrolling特性，嵌套滚动
• 既然这么多支持，那一定支持英语、繁体、简体，任意定制实现

注意： 框架本身只是实现各自逻辑，不实现UI，UI如同一张白纸，任凭客户端自行通过Canvas绘制实现，如果不熟悉Canvas的，请自行了解各自Canvas.drawXXX方法，UI都靠Canvas实现，坐标都已经计算好了，因此怎么隐藏农历，怎么换某些日期的字，这些都不属于框架范畴，只要你想换，都能随便换。

引用依赖

AndroidStudio v3.5+

support版本使用

implementation 'com.haibin:calendarview:3.6.8

Androidx版本使用

implementation 'com.haibin:calendarview:3.7.1'

<dependency>
  <groupId>com.haibin</groupId>
  <artifactId>calendarview</artifactId>
  <version>3.7.0</version>
  <type>pom</type>
</dependency>

混淆proguard-rules

-keepclasseswithmembers class * {
    public <init>(android.content.Context);
}

或者针对性的使用混淆，请自行配置测试！

-keep class your project path.MonthView {
    public <init>(android.content.Context);
}
-keep class your project path.WeekBar {
    public <init>(android.content.Context);
}
-keep class your project path.WeekView {
    public <init>(android.content.Context);
}
-keep class your project path.YearView {
    public <init>(android.content.Context);
}

使用方法

特别的，请注意不要复制这三个路径，自行替换您自己的自定义路径

app:month_view="com.haibin.calendarviewproject.simple.SimpleMonthView"
app:week_view="com.haibin.calendarviewproject.simple.SimpleWeekView"
app:week_bar_view="com.haibin.calendarviewproject.EnglishWeekBar"

 <com.haibin.calendarview.CalendarLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical"
        app:default_status="shrink"
        app:calendar_show_mode="only_week_view"
        app:calendar_content_view_id="@+id/recyclerView">

        <com.haibin.calendarview.CalendarView
             android:id="@+id/calendarView"
             android:layout_width="match_parent"
             android:layout_height="wrap_content"
             android:background="#fff"
             app:month_view="com.haibin.calendarviewproject.simple.SimpleCalendarCardView"
             app:week_view="com.haibin.calendarviewproject.simple.SimpleWeekView"
             app:week_bar_view="com.haibin.calendarviewproject.EnglishWeekBar"
             app:calendar_height="50dp"
             app:current_month_text_color="#333333"
             app:current_month_lunar_text_color="#CFCFCF"
             app:min_year="2004"
             app:other_month_text_color="#e1e1e1"
             app:scheme_text=