Kotlin-常用扩展函数

扩展函数是什么这里就不过多解释了，总结了一下项目中常用的一些扩展函数如果有需要的可以在这里下载
https://github.com/shiweibsw/Android-kotlin-extend-utils

使用方式

选择你需要的扩展函数类，将对应的.kt文件拷贝到项目中即可。

1 ImageView的扩展

目前的项目中大多数使用Glide作为图片加载框架，所以以下的这些扩展也是通过Glide完成的，如果你正在使用其他图片加载框架请替换函数中Glide相关的代码即可，注适用于Glide版本为4.+

名称	描述
loadImage	加载图片
loadCircleImage	加载圆形图片
loadRoundCornerImage	加载圆角图片
loadImageByProportion	按照图片的宽高比加载
loadClear	取消加载

/**
 * 加载图片
 */
fun ImageView.loadImage(context: Context, path: String, placeholder: Int = R.mipmap.ic_launcher, useCache: Boolean =false) {
    var options = getOptions(placeholder, useCache)
    Glide.with(context).load(path).apply(options).into(this)
}

/**
 * 加载圆形图片
 */
fun ImageView.loadCircleImage(context: Context, path: String, placeholder: Int = R.mipmap.ic_launcher, useCache: Boolean = false) {
    var options = getOptions(placeholder, useCache)
    options.circleCrop()
    Glide.with(context).load(path).apply(options).into(this)
}

/**
 * 加载圆角图片
 */
fun ImageView.loadRoundCornerImage(context: Context, path: String, roundingRadius: Int = 32, placeholder: Int = R.mipmap.ic_launcher, useCache: Boolean = false) {
    var options = getOptions(placeholder, useCache)
    Glide.with(context).load(path).apply(RequestOptions.bitmapTransform(RoundedCorners(roundingRadius))).apply(options).into(this)
}

参数placeholder 及useCache 均为可选参数
使用前可以提前设置好placeholder

说一下loadImageByProportion这个扩展函数的用法
在项目开发汇总经常会遇到这样的界面比如网易新闻中

image

图中红色框的图片设计的同学标注为宽度为屏宽的1/3，宽高比为16:9，对于这种按比例显示的图片我们怎么办，首先不可能写死宽高值，这样的话适配是个大麻烦。第二种办法是通过自定义ImageView实现，宽度可以先获取屏幕宽度在赋值给ImageView的测量宽度，对于16:9宽高比可以复写onMeasure()

override fun onMeasure(widthMeasureSpec: Int, heightMeasureSpec: Int) {
    super.onMeasure(widthMeasureSpec, heightMeasureSpec)
    val width = View.getDefaultSize(0, widthMeasureSpec)
    setMeasuredDimension(width, width * 9 / 16)
}

两种办法实现起来都比较麻烦。
loadImageByProportion（widthProportion: Float, heightProportion: Float） 扩展函数就是专门解决这个问题的
解释一下两个参数：

widthProportion：相对于屏幕宽度的比例取值范围为0.0f-1.0f，当widthProportion=1.0时，ImageView的宽度为屏幕宽度

heightProportion：相对于图片宽度的显示比例

对于上图的解决办法可以采用如下设置即可

imageView.loadImageByProportion(1/3f, 9/16f)

imageView为普通的ImageView控件

注意：imageView在xml布局中的width及height属性必须为WRAP_CONTENT

2 TextView的扩展

名称	描述
setColor	设置颜色
setDrawableLeft	左侧Drawable
setDrawableTop	上部Drawable
setDrawableRight	右侧Drawable
setDrawableBottom	下部Drawable

/**
 * 设置颜色直接使用colors.xml中定义的颜色即可
 */
fun TextView.setColor(resId: Int) {
    this.setTextColor(resources.getColor(resId))
}

fun TextView.setDrawableLeft(resId: Int) {
    var drawable = this.context.resources.getDrawable(resId)
    drawable.setBounds(0, 0, drawable.minimumWidth, drawable.minimumHeight)
    this.setCompoundDrawables(drawable, null, null, null)
}

setColor 适用于程序中动态修改字体颜色，不用每次都写resources.getColor(resId)这样的代码
setDrawableLeft(resId: Int)适用于动态修改设置在textView周围的drawable。

image

举个例子比如这个界面的布局通常我们会使用TextView 并设置drawableTop属性来完成，那么如果我想在点击红色框按钮后改变其上部图片怎么办？改变图片的代码如下

 var drawable = this.context.resources.getDrawable(resId)
drawable.setBounds(0, 0, drawable.minimumWidth, drawable.minimumHeight)
this.setCompoundDrawables(null, drawable, null, null)

我们把这段代码封装起来就成了TextView的扩展函数setDrawableTop(resId: Int)

其他类的一些扩展这里就不细说了，有需要的请下载源码并将相应的扩展类导入到项目中即可。

3.ViewExtends

名称	描述
view2Bitmap	View 转 bitmap
bottomMargin	底部Margin
leftMargin	左侧Margin
topMargin	上部Margin
rightMargin	右侧Margin

4.ContextExtends

名称	描述
toast	展示toast
centerToast	中心展示toast
dp2px	dp转px
px2dp	px转dp
sp2px	sp转px
px2sp	px转sp
getScreenWidth	屏幕宽度
getScreenHeight	屏幕高度
openWirelessSettings	打开网络设置界面
isConnected	网络是否连接
isMobileData	判断网络是否是移动数据

5.ActivityExtends

名称	描述
screenShot	屏幕截图
isPortrait	是否竖屏
isLandscape	是否横屏
setPortrait	设置竖屏
setLandscape	设置横屏
setFullScreen	设置全屏
showKeyboard	显示软键盘
hideKeyboard	隐藏软键盘

6.BitmapExtends

名称	描述
scale	bitmap 缩放

7.FileExtends

名称	描述
getBitmap	file 转 bitmap

这里感谢一下这位大神写的常用工具类库，从中参考了很多函数的实现方式。

https://github.com/Blankj/AndroidUtilCode

这套代码还在不断的加入新的扩展函数，如果你也有比较实用的扩展函数欢迎提交PR。

https://github.com/shiweibsw/Android-kotlin-extend-utils
欢迎fork和start。