GitHub - young508/AndroidKTX: Some very useful kotlin extensions for android developping！好用到爆的Kotlin扩展，加速你的Android开发！

AndroidKTX

Some very useful kotlin extensions for android developping!

一系列非常有用的Kotlin扩展，目标提高Android开发速度和替换所有的工具类！注意这个不是官方的AndroidKTX，部分内容借鉴了AndroidUtilCode的代码！

Gradle

implementation 'com.lxj:androidktx:latest release'

Usage

初始化

使用之前需要先初始化，初始化的作用是初始默认配置和注入Context。

// 简单注册，保持默认配置
AndroidKtxConfig.init(this)
// 也可以详细注册，自定义配置
AndroidKtxConfig.init(context = this,
        isDebug = BuildConfig.DEBUG,
        defaultLogTag = "logTag",
        sharedPrefName = "spName")

Hash相关

我们使用hash的时候，大都是对字符串操作，所以给String增加了扩展方法，用法如下：

"123456".md5()  // E10ADC3949BA59ABBE56E057F20F883E
"123456".sha1()  // 7C4A8D09CA3762AF61E59520943DC26494F8941B
"123456".sha256()  // 8D969EEF6ECAD3C29A3A629280E686CF0C3F5D5A86AFF3CA12020C923ADC6C92
"123456".sha512()  // BA3253876AED6BC22D4A6FF53D8406C6AD864195ED144AB5C87621B6C233B548BAEAE6956DF346EC8C17F5EA10F35EE3CBC514797ED7DDD3145464E2A0BAB413
// 随机数增强哈希
"123456".md5Hmac(salt)  // 4270C88B36C8D232DC2098FE0287A490
"123456".sha1Hmac(salt)  // E3DDE36BBDF2CA05A96DBE11BDE696FEF00C4299
"123456".sha256Hmac(salt)  // 12FC58997EA2FBD1861E1FBD4AFD5D69321A122BAB6FBD1695A2820B42D7F7B8

// 对称加密解密
//DES的key必须是8位
"123456".encryptDES("aaaabbbb")  //TQEoRuLPiHo=
"TQEoRuLPiHo=".decryptDES("aaaabbbb")  //123456
//AES的key必须是16位
"123456".encryptAES("aaaabbbbaaaabbbb")  //3FiQmdsD3GCuAManeaW/yg==
"3FiQmdsD3GCuAManeaW/yg==".decryptAES("aaaabbbbaaaabbbb")  //123456

Log相关

我们输出的log大都是字符串，所以也是给String增加扩展方法，用法如下：

"我是测试".v()
"我是测试".i()
"我是测试".w()
"我是测试".d()
"我是测试".e()

Log的默认tag和开关配置在AndroidKtxConfig类中，可动态配置。

Span相关

封装了颜色，大小，背景色，删除线和点击等常用的文本装饰，使用对象是TextView和String。用法如下：

val str = "我是测试文字"
tvSizeResult.sizeSpan(str, 0..2)
tvSizeResult.sizeSpan(str, 0..2, scale = .7f) //改变scale可以控制放大或缩小，scale默认是1.5

tvColorResult.colorSpan(str,2..6)

tvBgColorResult.backgroundColorSpan(str,2..6)

tvStrikethrougthResult.strikeThrougthSpan(str,2..6)

tvClickResult.clickSpan(str = str, range = 2..6, color = Color.BLUE, clickListener = View.OnClickListener {
    toast("哈哈我被点击了".toColorSpan(0..2))
})

View相关

view.width(100)           // 设置View的宽度为100
view.widthAndHeight(100)  // 改变View的宽度和高度为100
view.animateWidthAndHeight(600,900) //带有动画
view.animateWidth(600,900, action = { //监听动画进度，执行可选操作 }) //带有动画
view.margin(leftMargin = 100)  // 设置View左边距为100
view.click { toast("aa") }    // 设置点击监听，已实现事件节流，350毫秒内只能点击一次
view.longClick {             // 设置长按监听
    toast("long click")
    true
}
view.gone()
view.visible()
view.invisible()
view.isGone  // 属性
view.isVisible // 属性
view.isInvisible // 属性
view.toggleVisibility() // 切换可见性
view.toBitmap()           // 获取View的截图，支持RecyclerView长列表截图

ImageView相关

// 底层是封装Glide来加载图片
imageView.load(url)
imageView.load(url, placeholder = R.mipmap.ic_launcher, isCircle = true)
imageView.load(url, placeholder = R.mipmap.ic_launcher, roundRadius = 20)

SharedPref相关

使用范围：Context

// 便捷处理
sp().getString("a", "default")
sp().getBoolean("b", false)
sp(name = "xxx.cfg").getBoolean("b", false)
//...

// 批处理
sp().edit {
    putString("a", "1")
    putBoolean("b", true)
}
// 清除
sp().clear()

MMKV集成

MMKV是微信开源的跨平台KV存储方案，支持跨进程。经过微信的长期实践和优化是目前Android平台性能最高，最成熟稳定的KV存储方案。完全可以替代SharedPreference。 MMKV的API本身已经被设计得很简洁，我也只是简单集成下。

使用范围：Any

mmkv(id = "user").putString("b", "cc")
mmkv().putString("a", "1231")
mmkv().getFloat("f", 123f)
mmkv().clearAll()
// 其他略过

Activity相关

使用范围：Activity和Fragment，以及Context对象，会自动检测Context是否为Activity，并自动添加FLAG_ACTIVITY_NEW_TASK

startActivity<MainActivity>()
// 启动Activity并传参
startActivity<MainActivity>(flag = Intent.FLAG_ACTIVITY_CLEAR_TOP, bundle = arrayOf(
        "a" to 1,
        "b" to "lala"
))
// 在Fragment中启动Activity
fragment.startActivity<MainActivity>()
// 使用非Activity的Context启动，内部会自动检测并添加FLAG_ACTIVITY_NEW_TASK，不会导致崩溃
applicitionCtx.startActivity<MainActivity>(bundle = arrayOf(
        "a" to 1,
        "b" to "lala"
))
// 在View中启动
view.startActivity<MainActivity>()

Fragment相关

使用范围：Activity和Fragment

//替换一个Fragment不传参
replace(R.id.frame1, TempFragment())
//替换一个Fragment并传参数
replace(R.id.frame1, TempFragment(), arrayOf(
                TempFragment.Key1 to "我是第一个Fragment",
                TempFragment.Key2 to "床前明月光"
        ))
//添加Fragment
add(R.id.frame1, AFragment())
//其他方法，show, hide, remove略过

字符串处理相关

使用范围：String对象

"13899990000".isPhone()  // 是否是电话号码
"aaa@aas.com".isEmail()  // 是否是邮箱地址
"41282119900909337z".isIDCard()   // 是否是身份证号码
"洒水".isChinese()      // 是否是汉字

时间日期处理

// 默认格式：yyyy-MM-dd HH:mm:ss
"2018-12-07 17:28:39".toDateMills()  // 字符串日期转毫秒
(1544174919000L).toDateString()      // 毫秒转字符串日期

// 自定义格式
"2018-12-07".toDateMills(format = "yyyy-MM-dd")
(1544174919000L).toDateString(format = "yyyy-MM-dd")

RecyclerView相关

recyclerView.divider(color)   // 给RecyclerView添加分割线，解决了在某些情况下颜色不生效的问题

通用扩展

toast相关

ctx/fragment/view.toast("测试短吐司")
ctx/fragment/view.longToast("测试长吐司")

dp和px转换：

ctx/fragment/view.dp2px(100)
ctx/fragment/view.px2dp(100)

Json转换相关：

User("李晓俊", 25).toJson()   // {"age":25,"name":"李晓俊"}
// 底层是Gson解析，但是不用传class或者TypeToken了，得益于Kotlin的reified功能
"{\"age\":25,\"name\":\"李晓俊\"}".toBean<User>()
// 集合类型需要这样写
"[{\"age\":25,\"name\":\"李晓俊\"}]".toBean<List<User>>()

Resource获取相关

context/fragment/view.string(R.string.app_name) // 获取字符串
context/fragment/view.stringArray(R.array.array) // 获取字符串数组
context/fragment/view.color(R.id.color)    //获取颜色
context/fragment/view.drawable(R.mipmap.ic_launcher) // 获取图片
context/fragment/view.dimenPx(R.dimen.abc) // 获取dp值

网络相关

isNetworkConnected()  // 当前是否有网络连接
isWifiConnected()     // 当前是否是WIFI连接
isMobileConnected()   // 当前是否是移动数据连接

window相关

ctx/fragment/view.windowWidth()
ctx/fragment/view.windowHeight()

OkHttp极简封装

对OkHttpUtils和OkGo都不满意，于是造了一个。

请求示例

//Get请求
val user = "http://192.168.1.103:3000/json".http().get<User>().await()
//Post请求，传递header和params
val user = "http://192.168.1.103:3000/json".http()
                .headers("device" to "HuaWeiMate20", ...)
                .params("token" to "188sas9cf99a9d",
                    "file" to file,  //上传文件
                     ...)
                .post<User>().await()

上面的示例需要在协程中使用；也是我最喜欢和最推荐的方式。如果你不用协程，则可以用callback style：

"http://192.168.1.103:3000/json".http().get(object : HttpCallback<String> {
        override fun onSuccess(t: String) {
        }
        override fun onFail(e: IOException) {
            super.onFail(e)
        }
    })

Http日志

内置了简洁实用的Http日志打印器，效果如下：

其他

// 设置自定义的Client
OkWrapper.setClient(...)
// 设置全局header
OkWrapper.headers("header1" to "a", "header2" to "b", ...)
// 设置拦截器
OkWrapper.interceptors(...)
// 取消请求
"http://192.168.1.103:3000/json".http(tag = "abc").get<String>() //需要先指定tag
OkWrapper.cancel("abc")

LiveDataBus相关

基于LiveData的事件总线，好处是：轻量，无内存泄露，自动解注册。

// 接收消息
LiveDataBus.with<String>("key1").observe(this, observer = Observer {
    it?.v()
})
// 发送消息
LiveDataBus.with<String>("key1").setValue("message1")

注意事项

为了覆盖各种使用场景，该库对常用类库进行了封装，因此依赖了很多三方库。依赖的所有三方库如下：

implementation "com.github.bumptech.glide:glide:4.8.0"
implementation 'com.google.code.gson:gson:2.8.5'
implementation "com.squareup.okhttp3:okhttp:3.12.0"
implementation "org.jetbrains.kotlinx:kotlinx-coroutines-core:1.1.0"
implementation "android.arch.lifecycle:extensions:1.1.1"

由于我依赖的三方库都是最新版本，可能与您当前项目中的类库版本不一致，有可能导致因为API变化而编译失败。此时需要排除我这个库中的依赖，假设我的Glide版本与你项目中的不一致，则需要在gradle中配置如下：

implementation ('com.lxj:androidktx:latest release version') {
        exclude group: 'com.github.bumptech.glide'
}

TODO

其他常用方法集成

意见收集

为了让这个库更好用，更快地加速Android开发，请到Issue中提出您宝贵的意见或建议。我将对其进行评估，如果合适，立即采用。

联系方式

QQ: 16167479

Email: 16167479@qq.com

Name		Name	Last commit message	Last commit date
Latest commit History 78 Commits
app		app
gradle/wrapper		gradle/wrapper
imgs		imgs
library		library
.gitignore		.gitignore
README.md		README.md
build.gradle		build.gradle
gradle.properties		gradle.properties
gradlew		gradlew
gradlew.bat		gradlew.bat
settings.gradle		settings.gradle

young508/AndroidKTX

Folders and files

Latest commit

History

Repository files navigation