强大的 Android 计时器

下载体验

本工具为弥补 Android 没有完善的计时器而生, 使用协程 Coroutine 实现计时功能, 本工具从Net中剥离单独发布仓库, 如果已经依赖 Net 无需再依赖此工具

• [x] 倒计时/正计时
• [x] 开始/暂停/继续/结束/取消/重置
• [x] 定时/结束事件
• [x] 初始间隔/每次间隔
• [x] 动态修改计数器
• [x] 生命周期自动取消
• [x] 页面不可见暂停/可见继续

使用

监听轮询器

// 自定义计数器个数的轮询器
interval = Interval(100, 1, TimeUnit.SECONDS).life(this)
// 每秒回调一次, 不会自动结束
interval = Interval(1, TimeUnit.SECONDS)
// 倒计时轮询器, 当[start]]比[end]值大, 且 end 不等于 -1 时, 即为倒计时
interval = Interval(1, 1, TimeUnit.SECONDS, 5).life(this)

interval.subscribe {
    tvFragment.text = it.toString()
}.finish {
    tvFragment.text = "计时完成" // 最后一位数时同时回调 subscribe/finish
}.start()

函数

使用的函数非常简单

Interval 方法	描述
start	开始轮询器
stop	停止
cancel	取消, 区别于 stop, 此函数执行后并不会回调 finish
pause	暂停
resume	继续
reset	重置
switch	切换开关
count	当前计数器
end	结束计数器
state	当前状态
subscribe	每次计时都会执行该回调
finish	当计时器完成时执行该回调, 执行 stop 后也会回调
life	指定生命周期自动取消轮询器
onlyResumed	当界面不可见时暂停, 当界面可见时继续

安装

添加远程仓库根据创建项目的 Android Studio 版本有所不同

Android Studio Arctic Fox 以下创建的项目 在项目根目录的 build.gradle 添加仓库

allprojects {
    repositories {
        // ...
        maven { url 'https://jitpack.io' }
    }
}

Android Studio Arctic Fox 以上创建的项目 在项目根目录的 settings.gradle 添加仓库

dependencyResolutionManagement {
    repositories {
        // ...
        maven { url 'https://jitpack.io' }
    }
}

然后在 module 的 build.gradle 添加依赖框架

implementation "org.jetbrains.kotlinx:kotlinx-coroutines-core:1.6.0" // 协程(版本自定)
implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.6.0'

implementation 'com.github.liangjingkanji:Interval:1.0.3'

License

MIT License

Copyright (c) 2023 劉強東

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.