https://github.com/hi-dhl/ktkit
KtKit 小巧而实用，用 Kotlin 语言编写的工具库（长期更新中）
https://github.com/hi-dhl/ktkit
activity fragment kotlin
Last synced: 8 months ago
JSON representation
KtKit 小巧而实用，用 Kotlin 语言编写的工具库（长期更新中）
- Host: GitHub
- URL: https://github.com/hi-dhl/ktkit
- Owner: hi-dhl
- License: apache-2.0
- Created: 2021-08-01T04:56:06.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2021-09-28T06:39:44.000Z (over 4 years ago)
- Last Synced: 2023-11-07T15:24:36.184Z (over 2 years ago)
- Topics: activity, fragment, kotlin
- Language: Kotlin
- Homepage: https://ktkit.hi-dhl.com
- Size: 262 KB
- Stars: 154
- Watchers: 5
- Forks: 17
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
#
KtKit
KtKit 小巧而实用，用 Kotlin 语言编写的工具库（长期更新中）
KtKit 在线阅读：https://ktkit.hi-dhl.com
如果图片无法查看，请点击这里查看 图例
## 关于 KtKit
KtKit 是用 Kotlin 语言编写的工具库，包含了项目中常用的一系列工具，是 Jetpack ktx 系列的补充，涉及到了很多从 Kotlin 源码、Jetpack ktx、anko 等等知名的开源项目中学习的技巧，包含了 Kotlin 委托属性、高阶函数、扩展函数、内联、注解的使用等等，再次感谢以下项目提供的思路。
* Kotlin 官方 API
* [anko](https://github.com/Kotlin/anko)
* [FlowBinding](https://github.com/ReactiveCircus/FlowBinding)
* Google Jetpack ktx
但是目前还不是很完善，正在陆续将一些常用的功能，结合着 Kotlin 的高级函数的特性，不仅让代码可读性更强，使用更加简单，而且还可以帮助我们解决项目中常见的问题。
## Download
**正式版本: 此版本包含稳定版本的 API**
[](https://search.maven.org/search?q=g:%22com.hi-dhl%22%20AND%20a:%22ktkit%22)
```
// Project 级别的 `build.gradle`
allprojects {
repositories {
mavenCentral()
}
}
// 模块级 `build.gradle`
dependencies {
implementation "com.hi-dhl:ktkit:${ktkitVersion}"
}
```
**快照版本: 此版本包含最新的 API，版本号点击 [snapshots](https://oss.sonatype.org/content/repositories/snapshots/com/hi-dhl/ktkit/) 前往查看**
```
// Project 级别的 `build.gradle`
allprojects {
repositories {
maven { url 'https://oss.sonatype.org/content/repositories/snapshots/' }
}
}
// 模块级 `build.gradle`
dependencies {
implementation "com.hi-dhl:ktkit:${ktkitVersion}"
}
```
**如果这个仓库对你有帮助，请在仓库右上角帮我 star 一下，非常感谢你的支持，同时也欢迎你提交 PR** ❤️❤️❤️
项目中引用了 spotless 插件，执行 `./gradlew spotlessApply` 会将 Java 、Kotlin 、xml 、gradle 、md 、gitignore 等等文件按照官方标准去格式化。这也是 Google 提交代码的时候，推荐的方式。
## 如何使用
**在 Activity 或者 Fragment 中获取传递过来的参数**
以下两种方式根据实际情况使用即可
```
// 方式一： 不带默认值
private val userPassword by intent(KEY_USER_PASSWORD)
// 方式二：带默认值：如果获取失败，返回一个默认值
private val userName by intent(KEY_USER_NAME) {
"公众号：ByteCode"
}
```
**Activity 之间跳转 及传递参数**
以下两种方式根据实际情况使用即可
```
// 方式一
context.startActivity {
arrayOf(
KEY_USER_NAME to "ByteCode",
KEY_USER_PASSWORD to "1024",
KEY_PEOPLE_PARCELIZE to PeopleModel("hi-dhl")
)
}
// 方式二
context.startActivity(
KEY_USER_NAME to "ByteCode",
KEY_USER_PASSWORD to "1024"
)
```
**Activity 之间跳转 及传递参数 和 回传结果**
以下两种方式根据实际情况使用即可
```
// 方式一
context.startActivityForResult(KEY_REQUEST_CODE,
KEY_USER_NAME to "ByteCode",
KEY_USER_PASSWORD to "1024",
KEY_PEOPLE_PARCELIZE to PeopleModel("hi-dhl")
)
// 方式二
context.startActivityForResult(KEY_REQUEST_CODE) {
arrayOf(
KEY_USER_NAME to "ByteCode",
KEY_USER_PASSWORD to "1024",
KEY_PEOPLE_PARCELIZE to PeopleModel("hi-dhl")
)
}
```
**回传结果**
```
// 方式一
setActivityResult(Activity.RESULT_OK) {
arrayOf(
KEY_RESULT to "success"
)
}
// 方式二
setActivityResult(
Activity.RESULT_OK,
KEY_RESULT to "success",
KEY_USER_NAME to "ByteCode"
)
```
**Fragment 跳转 及 传递参数**
```
// 方式一
fun newInstance1(): Fragment {
return LoginFragment().makeBundle(
ProfileActivity.KEY_USER_NAME to "ByteCode",
ProfileActivity.KEY_USER_PASSWORD to "1024",
ProfileActivity.KEY_PEOPLE_PARCELIZE to PeopleModel("hi-dhl")
)
}
// 方式二
fun newInstance2(): Fragment {
return LoginFragment().makeBundle {
arrayOf(
KEY_USER_NAME to "ByteCode",
KEY_USER_PASSWORD to "1024",
KEY_PEOPLE_PARCELIZE to PeopleModel("hi-dhl")
)
}
}
```
**一行代码实现点击事件，避免内存泄露**
KtKit 提供了常用的三个 API：单击事件、延迟第一次点击事件、防止多次点击
**单击事件**
```
view.click(lifecycleScope) { showShortToast("公众号：ByteCode" }
```
**延迟第一次点击事件**
```
// 默认延迟时间是 500ms
view.clickDelayed(lifecycleScope){ showShortToast("公众号：ByteCode" }
// or
view.clickDelayed(lifecycleScope, 1000){ showShortToast("公众号：ByteCode") }
```
**防止多次点击**
```
// 默认间隔时间是 500ms
view.clickTrigger(lifecycleScope){ showShortToast("公众号：ByteCode") }
// or
view.clickTrigger(lifecycleScope, 1000){ showShortToast("公众号：ByteCode") }
```
更多 API 使用方式点击这里前往查看 [在线文档](https://ktkit.hi-dhl.com)
### 联系我
* 个人微信：hi-dhl
* 公众号：ByteCode，包含 Jetpack ，Kotlin ，Android 10 系列源码，译文，LeetCode / 剑指 Offer / 多线程 / 国内外大厂算法题 等等一系列文章
---
最后推荐我一直在更新维护的项目和网站：
* 计划建立一个最全、最新的 AndroidX Jetpack 相关组件的实战项目 以及 相关组件原理分析文章，正在逐渐增加 Jetpack 新成员，仓库持续更新，欢迎前去查看：[AndroidX-Jetpack-Practice](https://github.com/hi-dhl/AndroidX-Jetpack-Practice)
* LeetCode / 剑指 offer / 国内外大厂面试题 / 多线程 题解，语言 Java 和 kotlin，包含多种解法、解题思路、时间复杂度、空间复杂度分析
* 剑指 offer 及国内外大厂面试题解：[在线阅读](https://offer.hi-dhl.com)
* LeetCode 系列题解：[在线阅读](https://leetcode.hi-dhl.com)
* 最新 Android 10 源码分析系列文章，了解系统源码，不仅有助于分析问题，在面试过程中，对我们也是非常有帮助的，仓库持续更新，欢迎前去查看 [Android10-Source-Analysis](https://github.com/hi-dhl/Android10-Source-Analysis)
* 整理和翻译一系列精选国外的技术文章，每篇文章都会有**译者思考**部分，对原文的更加深入的解读，仓库持续更新，欢迎前去查看 [Technical-Article-Translation](https://github.com/hi-dhl/Technical-Article-Translation)
* 「为互联网人而设计，国内国外名站导航」涵括新闻、体育、生活、娱乐、设计、产品、运营、前端开发、Android 开发等等网址，欢迎前去查看 [为互联网人而设计导航网站](https://site.51git.cn)
## License
