dylancaicoding / longan

Probably the best Kotlin utils library for Android. (可能是最好用的 Kotlin 工具库)

一个兴趣使然的程序“工匠”。有代码洁癖，喜欢封装，对封装有一定的个人见解，有不少个人原创的封装思路。以下是个人封装的开源库，用于搭建开发框架。

UI 相关：

• ViewBindingKTX，最全面的 ViewBinding 工具，支持各种姿势使用 ViewBinding，替代 ButterKnife 或 KAE，可适配 BRVAH。
• LoadingStateView，深度解耦标题栏，解耦加载中、加载失败、空布局等缺省页，支持两行代码集成到基类。

工具类相关：

• Longan，可能是最好用的 Kotlin 工具库，目前有超过 500 个好用的方法和属性。

KV 存储相关：

• MMKV-KTX，最好用的 MMKV 工具，可以确保类型安全，无需声明 key 常量。
• DataStoreKTX，最好用的 DataStore 工具，可以确保类型安全，无需声明 key 常量。

埋点相关：

• Tracker，基于西瓜视频的责任链埋点思路实现的轻量级埋点框架。

---

在掘金有对应讲解封装思路的文章：

• 《如何利用 Kotlin 特性封装 DataStore》
• 《如何更简洁地实现富文本 Span》
• 《手把手带你实现西瓜视频的责任链埋点框架》
• 《优雅地结合 Kotlin 特性深度解耦标题栏》
• 《如何更好地使用 Kotlin 语法糖封装工具类》
• 《Kotlin 委托的本质以及 MMKV 的应用》
• 《优雅地封装和使用 ViewBinding，该替代 Kotlin synthetic 和 ButterKnife 了》
• 《ViewBinding 巧妙的封装思路，还能这样适配 BRVAH》
• 《更多 ViewBinding 的封装思路，适配 BRVAH 竟如此简单》
• 《优雅地处理后台返回的骚数据》

longan's Issues

doOnClick方法

大佬clickIntervals有默认值么？每次都要传500

Failed to resolve: com.github.DylanCaiCoding.Longan:longan:1.1.1

Android Studio Dolphin 版本

pluginManagement {
repositories {

    maven { url 'https://maven.aliyun.com/repository/google' }
    maven { url 'https://maven.aliyun.com/repository/public' }
    maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }

    maven { url 'https://www.jitpack.io' }

    gradlePluginPortal()
    google()
    mavenCentral()
}

plugins {
    id 'com.android.application' version '7.3.0'
    id 'com.android.library' version '7.3.0'
    id 'org.jetbrains.kotlin.android' version '1.7.10'
}

}
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
google()
mavenCentral()
}
}
rootProject.name = "FreeSearch"
include ':app'

选择单个图片方法在未选择图片时返回报空指针异常

registerForPickContentResult
java.lang.NullPointerException: Parameter specified as non-null is null: method com.camera.CameraPreviewActivity.albumLauncher$lambda$0, parameter uri

希望log工具类，可以将log保存到本地，并且可以设置有效期

希望log工具类，可以将log保存到本地，并且可以设置有效期

toast调用的系统toast，希望能自定义toast，取消Android13系统toast包含应用图标的优化

如题

finishAllActivitiesExceptNewest 方法不能达到 “结束除了最新以外的所有 Activity” 预期效果

问题：finishAllActivitiesExceptNewest 方法不能达到 “结束除了最新以外的所有 Activity” 预期效果
描述：如果 同一个的activity 打开多次 再调用此方法 并未关闭之前 同名的activity 例如 :A1->B->A2 在A2调用此方法 B是结束了，但A1并未结束

doOnLifecycle 不执行回调

//AppCompatActivity
//调用
lifecycleOwner.lifecycle.addObserver(object :DefaultLifecycleObserver{
    override fun onResume(owner: LifecycleOwner) {
        logError("11111:onResume")
    }
})

//不调用
doOnLifecycle(onResume = {
    logError("11111:onResume")
}, onPause = {
    logError("11111:onPause")
})

求解？？？

菜鸟有一个疑问，为什么activityCache不用stack

建议：补全一些工具类，例如Spanutil

我列举一些我开发常用的，如 Spanutil，Gsonutil，imageUtil，permissionUtil， TimeUtil加一下最好，不太想多引个包进来。感谢作者

希望log工具能增加tag参数

tag参数增加起来容易，全部用默认的tag不方便过滤和查看

调用ActivityResult 的拍照API报错

kotlin.UninitializedPropertyAccessException: lateinit property fileProviderAuthority has not been initialized
at com.dylanc.longan.UriKt.getFileProviderAuthority(Uri.kt:42)
at com.dylanc.longan.UriKt.toUri$default(Uri.kt:57)
at com.dylanc.longan.activityresult.SaveToUriLauncher.launchAndSaveToCache(ActivityResultLauncher.kt:68)

已经配置FILE_PROVIDER

请问longan这个一定要使用com.squareup.okio:okio:3.0.0这个版本吗，比这个版本低行不行？

请问longan这个一定要使用com.squareup.okio:okio:3.0.0这个版本吗，比这个版本低行不行？

checkPermission返回值意义有争议

ActivityCompat.checkSelfPermission(this, permission) != PackageManager.PERMISSION_GRANTED
代表没有权限为为true，但仅看checkPermission，惯性思维应该是true为有权限吧

能否进行修改呢？thk

mmkv bug

调用了 removeValueForKey 之后再获取对于的属性，还是之前存的值，因为属性代理做了缓存处理

startActivity打开页面和原生的写法要慢1-2s左右 很神奇

在recyclelerview中的adapter点击事件里面跳转
// startActivity()
startActivity(Intent(context, xxActivity::class.java))

用封装的startActivity打开有明显的延迟 用原生的明显快一些 搞不懂了 看了代码只是封了一层而已呀

日期时间天数星期等转换的支持

非常好用，感谢大佬。希望有时间能添加日期时间的相互转换

finishActivity

fun finishActivity(clazz: KClass): Boolean =
activityCache.removeAll {
if (it.javaClass == clazz) it.finish()
it.javaClass == clazz
}
这个函数不执行，Kclass和javaClass并不相等

SystemBars.kt 的 isLightStatusBar 无效

rt

SystemBarKt中immerseStatusBar 方法为什么要增加底部导航栏的padding

SpannableString里的appendClickable点击事件没有效果

给文字和图片添加点击事件都没效果

startIntentSenderLauncher.launch(intentSender) 使用方法

文档中使用方法如下：

val startIntentSenderLauncher = startIntentSenderLauncher {
  if (it.resultCode == Result_OK) {
    // 处理结果
  }
}

startIntentSenderLauncher.launch(intentSender) 

但实际写startIntentSenderLauncher.launch(intentSender) 报错，
Not enough information to infer type variable T
因为这个launch方法是这样的：launch<T:Activity>(intentSender)
很让人疑惑，请指教

keyboardHeight

keyboardHeight 一直是0

Activity跳转问题

看的有点懵，不知道怎么用。
现在我想从A带参数跳到B然后在从B带参数返回A并且finish调B，是怎么使用呢？这样写么？大佬求助
A里：

private val id: String by safeIntentExtras(name")
startActivity<A>("id" to `5)

B里：

private val id: String by safeIntentExtras("id")
finishWithResult("name"` to name)

希望加入一些功能

比如判断图片类型、保存图片到图库等功能
我这边有个颜色的ext, 希望可以加进去
val String.color: Int
get() = try {
Color.parseColor(this)
} catch (e: Exception) {
Color.WHITE
}

Wiki {xxx}.kt 链接失效

如：点击 Activity.kt方便的可以更新一下方便查看