Hello·World
划水湾
问道台
卷王殿
藏经阁
APP
目录
Android 进阶：在非 ComponentActivity 中实现协程自动取消

一、 背景

在 Android 开发中，由于集成第三方 SDK（如华为 HMS Scan Kit），我们有时必须继承非 ComponentActivity 的类。这类 Activity 通常未实现 LifecycleOwner，导致开发者无法直接利用 lifecycleScope。

作为一个严谨的开发者，我们不仅要修复这一功能缺失，还要提供可验证、可测试的优雅方案。本文将分享两种实现思路及其验证方法。

二、 方案一：基于接口的手动注册方案

这是最基础且通用的方案，通过定义一个 LifecycleAction 接口，依靠 ActivityLifecycleCallbacks 监听并分发事件。

1. 核心实现

该方案通过接口生命周期监听，可以在 ON_DESTROY 时自动反注册，从而有效避免内存泄漏，确保方案的严谨性。

kotlin
复制代码 

/**
 * author : A Lonely Cat
 * github : https://github.com/anjiemo/SunnyBeach
 * time   : 2024/01/26
 * desc   : 生命周期行为接口，用于非 ComponentActivity 的子类（如第三方 SDK 的 Activity）实现 LifecycleOwner
 */
interface LifecycleAction : LifecycleOwner {
  
    fun getLifecycleRegistry(): LifecycleRegistry
  
    override val lifecycle: Lifecycle get() = getLifecycleRegistry()

    fun initLifecycle(activity: Activity) {
        activity.application.registerActivityLifecycleCallbacks(object : Application.ActivityLifecycleCallbacks {
            private fun handle(targetActivity: Activity, event: Lifecycle.Event) {
                if (activity === targetActivity) {
                    getLifecycleRegistry().handleLifecycleEvent(event)
                    if (event == Lifecycle.Event.ON_DESTROY) {
                        activity.application.unregisterActivityLifecycleCallbacks(this)
                    }
                }
            }

            override fun onActivityCreated(activity: Activity, savedInstanceState: Bundle?) = handle(activity, Lifecycle.Event.ON_CREATE)
            override fun onActivityStarted(activity: Activity) = handle(activity, Lifecycle.Event.ON_START)
            override fun onActivityResumed(activity: Activity) = handle(activity, Lifecycle.Event.ON_RESUME)
            override fun onActivityPaused(activity: Activity) = handle(activity, Lifecycle.Event.ON_PAUSE)
            override fun onActivityStopped(activity: Activity) = handle(activity, Lifecycle.Event.ON_STOP)
            override fun onActivitySaveInstanceState(activity: Activity, outState: Bundle) {}
            override fun onActivityDestroyed(activity: Activity) = handle(activity, Lifecycle.Event.ON_DESTROY)
        })
    }
}

2. 验证代码与预期日志

接入完成后，我们可以通过在业务代码中埋点日志来验证方案的有效性。

测试代码：

kotlin
复制代码 
class ScanCodeActivity : ScanKitActivity(), LifecycleAction {
  
    private val mLifecycleRegistry = LifecycleRegistry(this)
  
    override fun getLifecycleRegistry() = mLifecycleRegistry

    override fun onCreate(savedInstanceState: Bundle?) {
        initLifecycle(this) // 手动初始化
        super.onCreate(savedInstanceState)
      
        // 使用 lifecycleScope 开启协程
        lifecycleScope.launch {
            Timber.tag("_Test").d("协程已启动")
            delay(5000)
            Timber.tag("_Test").d("协程任务完成")
        }.invokeOnCompletion { cause ->
            if (cause is CancellationException) {
                Timber.tag("_Test").d("验证成功：方案一协程已自动取消")
            }
        }
    }
}

预期测试日志（Logcat）：

text
复制代码 
D/_Test: 协程已启动
// (此时关闭 Activity)
D/_Test: 验证成功：方案一协程已自动取消

操作验证步骤：

  1. 运行应用并进入该 Activity。
  2. 观察 Logcat（过滤 TAG 为 _Test），确认输出“协程已启动”。
  3. 在 5 秒内（协程任务完成前）按下返回键关闭 Activity。
  4. 检查 Logcat，若输出“验证成功...”，则说明协程随 Activity 销毁而正常取消。

三、 方案二：基于 Kotlin 属性委托的“声明式”方案

这是方案一的升级版，充分发挥了 Kotlin 的语言优势，实现了“零侵入”初始化。

1. Kotlin 风格方案：属性委托

为了极致的简洁，我们可以利用 Kotlin 属性委托，通过手动实现一个安全的属性委托扩展来注入生命周期监听：

kotlin
复制代码 
fun Activity.lifecycleRegistry() = lazy(LazyThreadSafetyMode.NONE) {
    require(this is LifecycleOwner) { "Activity 必须实现 LifecycleOwner 接口" }
    LifecycleRegistry(this).also { registry ->
        application.registerActivityLifecycleCallbacks(object : Application.ActivityLifecycleCallbacks {
            private fun handle(targetActivity: Activity, event: Lifecycle.Event) {
                if (targetActivity === this@lifecycleRegistry) {
                    registry.handleLifecycleEvent(event)
                    if (event == Lifecycle.Event.ON_DESTROY) {
                        targetActivity.application.unregisterActivityLifecycleCallbacks(this)
                    }
                }
            }

            override fun onActivityCreated(activity: Activity, savedInstanceState: Bundle?) = handle(activity, Lifecycle.Event.ON_CREATE)
            override fun onActivityStarted(activity: Activity) = handle(activity, Lifecycle.Event.ON_START)
            override fun onActivityResumed(activity: Activity) = handle(activity, Lifecycle.Event.ON_RESUME)
            override fun onActivityPaused(activity: Activity) = handle(activity, Lifecycle.Event.ON_PAUSE)
            override fun onActivityStopped(activity: Activity) = handle(activity, Lifecycle.Event.ON_STOP)
            override fun onActivitySaveInstanceState(activity: Activity, outState: Bundle) {}
            override fun onActivityDestroyed(activity: Activity) = handle(activity, Lifecycle.Event.ON_DESTROY)
        })
    }
}

2. 避免 JVM 签名冲突

注意：在 Kotlin 中，属性会自动生成 Getter。如果属性名设为 lifecycleRegistry，会与接口生成的 getLifecycleRegistry() 产生冲突。因此建议使用 mLifecycleRegistry 等名称。

测试代码：

kotlin
复制代码 
class ScanCodeActivity : ScanKitActivity(), LifecycleAction {
  
    // 使用属性委托，同时也需要避免方法名冲突
    private val mLifecycleRegistry by lifecycleRegistry()
  
    // 显式实现接口要求的方法
    override fun getLifecycleRegistry() = mLifecycleRegistry

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
      
        // 触发协程测试
        lifecycleScope.launch {
            Timber.tag("_Test").d("方案二协程运行中...")
            delay(5000)
            Timber.tag("_Test").d("方案二任务完成")
        }.invokeOnCompletion { cause ->
            if (cause is CancellationException) {
                Timber.tag("_Test").d("验证成功：方案二协程已自动取消")
            }
        }
    }
}

预期测试日志（Logcat）：

text
复制代码 
D/_Test: 方案二协程运行中...
// (此时关闭 Activity)
D/_Test: 验证成功：方案二协程已自动取消

操作验证步骤：

  1. 启动 ScanCodeActivity。
  2. 观察 Logcat（过滤 TAG 为 _Test），确认输出“方案二协程运行中...”。
  3. 在任务结束（5 秒）前退出该页面。
  4. 验证 Logcat 是否输出了“验证成功...”日志。

四、 总结

无论是选择“手动注册”还是“属性委托”，核心目标都是通过 LifecycleRegistry 准确分发生命周期事件。通过 invokeOnCompletion 回调并配合日志输出，我们可以直观地验证协程是否已随 Activity 的销毁而及时释放。

结语

好啦，就写到这里吧 ，如果你想看更多的项目代码，请查看我在 Github 上的 阳光沙滩APP项目 ，你也可以在这里点击下载我写的 阳光沙滩APP客户端 进行体验。

如果对你有帮助的话，欢迎一键三连+关注哦~

本文由 A lonely cat 原创发布于 阳光沙滩 ， 未经作者授权，禁止转载
评论
0 / 1024
用户头像
拉大锯
我最近用flutter比较多，虽然我还不会写，哈哈哈。全部用AI写得了。
2026-01-26 14:38回复
回复@拉大锯(我最近用flutte...)： AI 会写就行了[doge] 哈哈哈
2026-01-26 15:37回复
推荐文章
记给网站接入图形验证码
本文分享了如何为个人站点添加图形验证码以提升安全性，详细介绍了使用第三方接口实现验证码功能的过程，并通过代码示例展示了具体实现方式。对于关注网站安全的开发者来说，这篇文章提供了实用的参考价值。
东子871
Java开发环境搭建
本文是一份详细的Java开发环境搭建指南，涵盖了Java的发展历史、版本选择及安装配置过程。无论你是初学者还是有经验的开发者，都能从中找到实用的信息和步骤，帮助你快速上手Java开发。
拉大锯661
Vue3.js项目的创建
本文详细介绍了如何使用Vue3创建项目，包括Node.js的安装和配置，以及项目的初始化过程。适合初学者学习如何快速搭建Vue3开发环境，并推荐了相关课程供进一步学习。
拉大锯96点赞
Network Tools : 您的运维“助手”升级了
Network Tools是一款专为解决运维难题而设计的软件，集设备管理、配置备份、性能监控和告警处理于一体。通过统一的工作台，帮助运维人员更高效地管理资产、定位故障并提升团队协作效率。无论是设备在线状态还是具体问题排查，都能得到全面支持。
南城阿宇1181
Ubuntu 软件安装与彻底卸载指南
本文详细介绍了在 Ubuntu 系统中如何规范安装和彻底卸载 .deb 格式软件，包括依赖修复、残留清理以及图形化工具推荐，适合需要维护系统环境的用户。
南城阿宇1201
JavaWeb开发客户程序更新特殊环境下的骚操作
本文分享了在无外网环境下，如何利用Docker和docker-compose实现高效部署的实战经验。通过基础镜像和本地jar包挂载的方式，解决了内网环境下的依赖问题，适合需要灵活部署方案的技术人员参考。
拉大锯75点赞
Linux 防火墙完全指南：从原理到多发行版实战
本文全面解析Linux防火墙的底层原理与主流工具配置，涵盖UFW、firewalld、iptables、nftables等方案，适合不同发行版用户。从基础概念到生产环境加固建议，助你掌握核心安全策略，确保服务器与网络的安全运行。
拉大锯2581
水上派对英语单词篇
探索FLOATOPIA水上派对的完整指南，涵盖签到流程、场地指引、安全须知、活动安排及夜场舞会等实用英语词汇与对话。无论是初学者还是老手，都能轻松掌握关键术语，享受完美水上体验。
拉大锯188点赞
麒麟操作系统下使用 virt-customize 重置虚拟机 root 密码实战
本文详细介绍了在麒麟操作系统环境下使用 virt-customize 工具重置 KVM 虚拟机 root 密码的完整流程，包含安装步骤、常见问题及解决方案，帮助运维人员高效处理密码遗忘或批量初始化场景，避免数据丢失。
拉大锯1631
浅析JS预编译-函数篇
本文详细讲解了JavaScript中函数的预编译过程，包括AO对象的创建、变量和函数声明的提升，以及执行阶段的变化。适合初学者了解JS执行机制，帮助深入理解代码运行逻辑。
东子1791
访问Github的另一种姿势
本文介绍了如何通过Watt ToolKit等工具加速访问Github，适合对网络技术感兴趣的读者。内容涵盖工具介绍、下载和使用方法，以及一些实用技巧，值得一看。
东子2282
使用Gulp压缩JS
本文详细介绍了如何使用Gulp压缩JavaScript文件，特别是支持ES6语法的处理方法。通过实际操作和效果对比，帮助开发者提升代码性能，适合对前端自动化工具感兴趣的读者。
东子1951
使用Gulp压缩CSS
本文详细介绍了如何使用Gulp工具对CSS文件进行压缩，提升网页加载速度。适合需要优化静态资源的开发者，提供清晰的步骤和示例，帮助快速上手。
东子1811
从0部署Nuxtjs项目
本文详细介绍了如何将Nuxt.js项目部署到公网，涵盖Node.js安装、环境配置、源码上传及使用PM2启动服务的全过程，适合开发者学习和实践。
东子2372
Linux 命令行美化利器：tree 命令完全指南（安装 + 全部参数详解）
掌握 Linux 下的 `tree` 命令，快速直观地查看目录结构。本文详细讲解安装方法、参数含义及实战场景，适合开发者和系统管理员提升工作效率。
拉大锯2061
Linux常用命令（一）
本文详细介绍了Linux基础命令，包括文件操作、系统显示、网络状态、软件包管理等，适合初学者学习和查阅，是掌握Linux系统的实用指南。
东子2121
大模型推理参数解码：温度、Top-p 与核采样如何塑造生成文本的灵魂
探索大语言模型的采样参数如何塑造生成内容，从温度到Top-p，从惩罚机制到熵控制，揭示背后的信息论原理与实践策略。了解如何通过参数调优，让AI既保持知识的严谨，又拥有创造力的自由。
拉大锯198点赞
记从0使用Claude code写代码
本文介绍了如何使用Claude Code搭配DeepSeek进行编程，详细讲解了安装Node.js、全局安装Claude、配置模型以及使用方法。对于开发者来说，这是一份实用的技术教程，尤其适合对AI编程工具感兴趣的读者。
东子2511
Android-Studio-Gradle同步失败-Library为null的通用排查指南
遇到 Android Studio Gradle Sync 失败时，不要轻易删除全局缓存。本文详细解析了错误原因，并提供了一系列精准的排查步骤和解决方案，帮助开发者快速定位并解决问题，提升开发效率。
A lonely cat4052
PHP实现密码加密
本文详细介绍了Bcrypt密码加密技术及其在PHP中的应用，帮助开发者提升用户密码的安全性。通过实际代码示例，展示了如何使用password_hash和password_verify函数进行密码加密与验证，是学习网络安全知识的实用指南。
东子2281
WordCloud效果，滚动标签
本文详细介绍了如何在Vue项目中集成WordCloud组件，包括依赖安装、属性配置和使用方法。适合开发者学习如何实现数据可视化功能，提升项目交互体验。
拉大锯295点赞
从0使用WordPress搭建一个优美的网站
本文详细介绍了如何使用WordPress搭建一个美观的网站，从安装到主题配置和功能拓展，为读者提供了实用的操作指南。无论是初学者还是有一定经验的开发者，都能从中获得有价值的参考。
东子2751
JS实现在网站底部添加运行时间
想知道如何在网站底部显示运行时间？本文详细讲解了通过JavaScript实现这一功能的方法，包括时间计算逻辑和代码实现。适合前端开发者学习参考，轻松为网站添加实用功能。
东子2321
在Vercel上部署Hexo博客
本文详细介绍了如何在Vercel上快速部署Hexo博客，无需后端服务即可实现高效发布。相比传统方式，省去了手动生成和上传静态文件的步骤，更加便捷。适合想要搭建个人博客的开发者参考。
东子2411
从0搭建一个Hexo博客
本文详细介绍了Hexo博客框架的使用方法，从安装到部署全流程讲解，适合想快速搭建个人博客的技术爱好者。内容清晰易懂，是入门Hexo的理想指南。
东子250点赞
离线设备激活方案：古老的 Windows 光盘激活，离线算法授权等
本文深入解析了离线激活的核心原理与实现方式，从历史案例到现代技术，全面剖析了如何在无网络环境下确保软件授权的安全性。通过设备指纹、授权文件校验等手段，为开发者提供了可复用的架构设计思路，适用于工业、医疗等对网络依赖较低的场景。
拉大锯357点赞
Hexo实现生成站点地图
想为你的Hexo博客添加站点地图功能吗？本文详细介绍了如何通过安装插件和配置文件来实现，适合没有内置该功能的新主题或自定义主题的用户。简单步骤助你提升搜索引擎优化效果。
东子1862
Hexo实现代码压缩
本文分享了如何通过Hexo插件优化博客性能，详细介绍了安装和配置过程，帮助提升网页加载速度。适合对网站优化感兴趣的开发者阅读。
东子2281
记一次 GitHub 幽灵协作者大清洗：强制重写 Git 历史与穿透 CDN 缓存实践
本文详细讲解了如何解决GitHub上出现的‘幽灵协作者’问题，通过重写Git历史和穿透CDN缓存，彻底清理错误提交记录。适合开发者学习如何高效管理项目历史与优化仓库信息。
A lonely cat2751
从一行 `native` 堆栈追到 InstallReferrer：一次主线程 ANR 的排查全过程
本文详细记录了一次主线程ANR的排查过程，从一行native堆栈追踪到InstallReferrer服务调用。通过分析堆栈、源码和系统调用，揭示了归因SDK在主线程同步调用Play商店服务导致的ANR问题，并提供了多维度的解决方案。对于Android开发者来说，是一篇深入浅出的技术实践指南。
A lonely cat184点赞
1
2
本网站由程序猿(媛)用爱驱动 Copyright©阳光沙滩(0x07DE-0x07E9)
Design by ZengXue in Guangzhou and code by great TrillGates in Shenzhen