BaseFramework 6.5.5.1版本更新报告

6.5.5.1版本更新日志

v6.5.5.1:

  • 警告:因命名冲突,6.5.5版本起,跳转回调参数 OnResponseListener 改名为 OnJumpResponseListener;
  • 可以使用bigLog(...)打印更长的日志了;
  • dip2px和px2dip不再需要context参数;
  • 显示/关闭键盘的方法setIMMStatus(...)将被更名为showIME(...),目前新旧方法都可以使用;
  • 更新getNavbarHeight()方法,可以获取到更为准确的底栏高度;
  • 新增getRootHeight()方法,可以获取准确真正的屏幕高度(含底栏和状态栏);
  • 新增BaseActivity注解 @FullScreen(true)可以直接使Activity全屏;
  • 修正了 @NavigationBarBackgroundColor(a,r,g,b)的默认值;
  • jump支持了共享元素,只需要在原参数末尾增加共享元素view,例如jump(Class<?> cls, View transitionView);

一些需要注意的事项

BaseFramework 框架一直以来致力于打造一款方便易用、符合直觉的 Android 适配框架,在此目标的基础上,我会不断的对之前不好用的功能、方法进行修改,此次版本更新牵扯到的修改比较多,也会对之前的一些方法产生影响,因此我有必要发布一篇针对此版本的更新报告,用于详细解析此版本的更新内容。

① 6.5.5 版本起,跳转回调参数 OnResponseListener 改名为 OnJumpResponseListener

由于 BaseOkHttp 框架(https://github.com/kongzue/BaseOkHttp)采用了同名的回到方法用以返回网络请求的数据,此处出现命名冲突,因此从 6.5.5 版本起,BaseFramework 中的回调参数 OnResponseListener 改名为 OnJumpResponseListener,其他保持不变,您可以使用全局替换功能直接替换此监听器名即可;

② 可以使用bigLog(...)打印更长的日志了

Android 自带的 Log 方法对打印是护具长度是有限制的,这对于我们需要打印长篇日志并不友好,有时我们可能需要打印更大篇幅的日志数据,从 6.5.5 版本起,可以使用 bigLog(...) 方法打印长篇日志,效果如下:

BIGLOG.start=================================
这里是你的日志
BIGLOG.end=================================

当然了,bigLog 依然受限于 BaseActivity.DEBUGMODE 的开关,若此开关处于关闭状态(默认也是关闭的)则无法打印任何数据,这也是为了保证你可以在发布正式版本时一键关闭所有的日志打印。

③ dip2px和px2dip不再需要context参数

在此之前,位于 BaseActivity 和 BaseFragment 中提供的 dp 和 px 转换工具 dip2px 和 px2dip 是 static 静态的,且需要额外的参数 context,从 6.5.5 版本起,它们将不再是静态的了,且不再需要额外的 context 参数,这是为了更加有效率的进行开发而做出的修改。

④ 显示/关闭键盘的方法setIMMStatus(...)将被更名为showIME(...),目前新旧方法都可以使用

更为符合直觉的命名方式一直是我对此框架进行的优化方向,方法 setIMMStatus(...) 将被更名为 showIME(...) 也是基于此目的进行的修改,但我依然保留了旧方法供使用,这也是为了减轻升级到此版本的工作量;

⑤ 关于所有屏幕高度、宽度获取的方法

Android 平台适配的一大难度在于分辨率的适配,老的方法我们可能无法精确的获取到状态栏、底部导航栏的高度、以及屏幕的具体准确高度和安全高度,从 6.5.5 版本起,对旧的方法进行了修改,以及额外的提供了新的方法以获取这些值:

//获取屏幕安全高度:
getDisplayHeight();
//获取屏幕安全宽度:
getDisplayWidth();
//获取屏幕完整高度:
getRootHeight();
//获取状态栏高度:
getStatusBarHeight();
//获取底部导航栏高度:
getNavbarHeight();

⑥共享元素的支持

之前版本的 jump(...) 方法提供了基础的界面跳转功能,但在 Android 5 开始,Android 提供了共享元素动画,可以方便的完成上一个界面到下一个界面的过度,只需要将两个界面中需要共享元素的 View 设置好以下属性即可:

android:transitionName="共享元素名称"

但默认的写法有些麻烦,还需要判断 Android 版本,从 6.5.5 版本起,您可以直接使用 jump(...) 来进行共享元素跳转,方法很简单,就是在之前的 jump(...) 方法最后加上一个要共享的元素 View 即可。

结尾

本次更新对之前的一些方法做了变更,更新至此版本可能需要有一定的额外的工作量,建议仔细阅读此更新报告以了解为什么进行这些修改,也请相信,所有修改都是进过深思熟虑的,且我们的目的,永远是为了打造一款方便易用、符合直觉的 Android 适配框架。

额外的

BaseFramework 框架地址: https://github.com/kongzue/BaseFramework
欢迎 Fork & Star!

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,417评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,921评论 3 387
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 158,850评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,945评论 1 285
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,069评论 6 385
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,188评论 1 291
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,239评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,994评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,409评论 1 304
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,735评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,898评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,578评论 4 336
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,205评论 3 317
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,916评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,156评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,722评论 2 363
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,781评论 2 351