Android Activity 功能代码实战：生命周期、状态保存与避坑指南-北京尧图网络

简介这份资源面向BPM流程开发与Activiti/Flowable引擎实践者聚焦流程部署、动态加签、流程变量与指定节点审批人等核心功能的代码实现适合需要落地审批流定制的中高级开发者参考。压缩包共200个文件以62个class编译文件、56个bpmn流程定义、13个xml配置为主另含properties、sql、log等辅助文件整体约1.57MB目录结构便于按模块查阅。已有818人学习下载说明其在流程引擎实战场景中具备一定参考价值。通过研读其中的流程定义与配置读者可理解部署流程模型、运行时动态添加审批节点、借助流程变量驱动流转以及通过setAssignee或监听器指定任务处理人的具体做法并从中获取可复用的实现思路与排错经验。1. Activity 功能代码从一次“页面跳转后数据全丢”的排查说起做 Android 开发的人几乎都经历过这样的场景用户在列表页点了某条数据跳进详情页返回后列表滚动位置没了、筛选条件重置了、输入框清空了。你盯着代码看半天发现逻辑没问题最后定位到是 Activity 被系统回收重建了。这就是 Activity 功能代码最核心的问题域——它不只是“写个页面”而是管理一个页面的完整生命周期、状态保存、跳转传参和返回结果处理。Activity 功能代码指的是围绕 Activity 组件实现页面交互的整套编码实践包括启动模式配置、Intent 传参、生命周期回调、状态保存与恢复、结果回传、任务栈管理等。它适合所有做 Android 原生开发的工程师尤其是那些能跑通 Demo 但在真实项目里频繁遇到“返回后状态错乱”“多任务栈混乱”“内存泄漏”的人。这篇文章不讲 Activity 是什么而是把一套能直接落地的功能代码拆开告诉你每一步怎么写、参数怎么设、坑在哪里。2. Activity 生命周期与状态保存功能代码的骨架怎么搭2.1 为什么 onCreate 里拿不到最新状态很多新手会把所有初始化逻辑塞进onCreate然后发现从后台切回来时数据没刷新。原因在于 Activity 的生命周期回调触发条件不同onCreate只在 Activity 实例被创建时调用一次而onStart、onResume在每次可见时都会走。如果你在onCreate里读取了某个全局变量当 Activity 被系统回收后重建这个变量可能已经被重置。正确的做法是把“只做一次”的初始化放在onCreate把“每次可见都要刷新”的逻辑放在onResume。但这里有个细节onResume在首次启动时也会调用所以如果你在onResume里做网络请求要加一个标志位避免重复请求。常见做法是用一个boolean isFirstResume变量控制或者把请求逻辑放在onStart里配合isFinishing判断。public class MainActivity extends AppCompatActivity { private boolean isFirstResume true; Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); // 只做一次绑定 View、初始化 Adapter initViews(); if (savedInstanceState ! null) { // 恢复被系统回收前的状态 String keyword savedInstanceState.getString(keyword); if (keyword ! null) { searchEditText.setText(keyword); } } } Override protected void onResume() { super.onResume(); if (isFirstResume) { isFirstResume false; // 首次进入的加载逻辑 loadData(); } else { // 从后台返回时的刷新逻辑 refreshData(); } } Override protected void onSaveInstanceState(NonNull Bundle outState) { super.onSaveInstanceState(outState); // 保存用户输入的关键词防止被回收后丢失 outState.putString(keyword, searchEditText.getText().toString()); } }这段代码的关键点有三个onSaveInstanceState只在 Activity 可能被销毁前调用不是每次退后台都触发savedInstanceState在onCreate里可能为 null必须判空isFirstResume标志位解决了onResume重复执行的问题。参数方面outState是一个 Bundle只能存基本类型和实现了 Parcelable 或 Serializable 的对象存大图或大数组会导致TransactionTooLargeException。2.2 启动模式选错返回栈直接乱套Activity 的启动模式决定了它在任务栈里怎么放。standard是默认每次启动都新建实例singleTop在栈顶复用singleTask在栈内复用并清空其上方的 ActivitysingleInstance独占一个任务栈。很多人在做“首页跳详情再跳首页”时发现点了三次首页按钮栈里堆了三个首页实例这就是standard模式导致的。配置启动模式有两种方式在AndroidManifest.xml里写android:launchMode或者在 Intent 里加FLAG_ACTIVITY_*标志。推荐在 Manifest 里声明因为代码里的标志位容易在复杂跳转中互相覆盖。比如一个典型的电商 App首页用singleTask商品详情用standard购物车用singleTop这样从任何页面回首页都只会有一个实例而详情页可以层层叠加。activity android:name.HomeActivity android:launchModesingleTask android:exportedtrue intent-filter action android:nameandroid.intent.action.MAIN / category android:nameandroid.intent.category.LAUNCHER / /intent-filter /activity activity android:name.DetailActivity android:launchModestandard android:exportedfalse / activity android:name.CartActivity android:launchModesingleTop android:exportedfalse /这里有个血泪经验singleTask配合taskAffinity使用时如果taskAffinity设成空字符串Activity 会进入一个独立的任务栈导致返回键行为异常。我一般会保持默认的包名作为 affinity除非有明确的多任务栈需求。另外singleTask的onNewIntent回调必须重写否则新 Intent 的数据不会更新到已有实例上。Override protected void onNewIntent(Intent intent) { super.onNewIntent(intent); setIntent(intent); // 必须调用否则 getIntent() 拿到的还是旧数据 String newData intent.getStringExtra(key); if (newData ! null) { updateUI(newData); } }setIntent(intent)这行很容易漏漏了之后getIntent()返回的是第一次启动时的 Intent后续跳转传的参数全部失效。这个坑我在三个项目里都见过排查起来很费时间因为日志里看 Intent 是有值的但代码里读出来就是旧的。3. Intent 传参与结果回传功能代码的数据通道3.1 传参的三种方式和大小限制Activity 之间传参最常用的是 Intent 的putExtra支持基本类型、String、Parcelable、Serializable。但很多人不知道 Intent 传参有大小限制大约在 1MB 左右超过会抛TransactionTooLargeException。这个限制不是 Intent 本身的而是 Binder 机制的限制。如果你要传一个包含多张图片的列表正确做法是传图片的 URL 或本地路径而不是 Bitmap 对象。// 推荐传轻量级标识 Intent intent new Intent(this, DetailActivity.class); intent.putExtra(product_id, 10086L); intent.putExtra(from_page, search_result); startActivity(intent); // 不推荐传大对象 // intent.putExtra(product_bitmap, bitmap); // 容易触发 TransactionTooLargeException如果确实需要传复杂对象用 Parcelable 比 Serializable 性能好因为 Parcelable 是 Android 专门优化的序列化接口不需要反射。实现 Parcelable 时要注意describeContents返回 0 即可writeToParcel和CREATOR的字段顺序必须一致否则反序列化会错位。public class Product implements Parcelable { private long id; private String name; private double price; protected Product(Parcel in) { id in.readLong(); name in.readString(); price in.readDouble(); } public static final CreatorProduct CREATOR new CreatorProduct() { Override public Product createFromParcel(Parcel in) { return new Product(in); } Override public Product[] newArray(int size) { return new Product[size]; } }; Override public int describeContents() { return 0; } Override public void writeToParcel(Parcel dest, int flags) { dest.writeLong(id); dest.writeString(name); dest.writeDouble(price); } }注意writeToParcel和构造函数里的读取顺序必须完全一致我见过有人先写name再写id读取时先读id结果id变成了字符串的哈希值排查了半天。3.2 startActivityForResult 的替代方案startActivityForResult在 AndroidX 里已经被标记为废弃推荐用ActivityResultLauncher。但很多老项目还在用而且新手容易在onActivityResult里写错requestCode的判断逻辑。新方案的好处是类型安全不需要手动管理requestCode。public class MainActivity extends AppCompatActivity { private ActivityResultLauncherIntent detailLauncher; Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); detailLauncher registerForActivityResult( new ActivityResultContracts.StartActivityForResult(), result - { if (result.getResultCode() RESULT_OK result.getData() ! null) { String updatedName result.getData().getStringExtra(updated_name); if (updatedName ! null) { nameTextView.setText(updatedName); } } } ); findViewById(R.id.btn_open_detail).setOnClickListener(v - { Intent intent new Intent(this, DetailActivity.class); intent.putExtra(current_name, nameTextView.getText().toString()); detailLauncher.launch(intent); }); } }在 DetailActivity 里回传数据时用setResult加finishpublic class DetailActivity extends AppCompatActivity { Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_detail); findViewById(R.id.btn_save).setOnClickListener(v - { Intent resultIntent new Intent(); resultIntent.putExtra(updated_name, 新名称); setResult(RESULT_OK, resultIntent); finish(); }); } }这里有个容易翻车的点如果用户在 DetailActivity 里按了返回键而不是点保存按钮resultCode会是RESULT_CANCELEDonActivityResult里的回调不会走RESULT_OK分支。所以如果你需要“无论用户怎么返回都要回传数据”得在onBackPressed里也调用setResult或者用OnBackPressedDispatcher处理。4. Activity 功能代码的避坑与排查五个真实踩坑记录4.1 现象旋转屏幕后 Dialog 消失、数据重置原因屏幕旋转会导致 Activity 销毁重建如果没有在onSaveInstanceState里保存 Dialog 的状态重建后 Dialog 不会自动恢复。另外如果 Dialog 持有 Activity 的 Context 且没有 dismiss还会导致内存泄漏。解决对于简单的 Dialog可以在onSaveInstanceState里存一个布尔值标记是否显示在onCreate里根据标记重新 show。对于复杂状态建议用DialogFragment它自带状态保存机制。内存泄漏方面用WeakReference持有 Activity或者在onDestroy里强制 dismiss。4.2 现象从通知栏点击进入 Activity返回键直接退出 App原因通知栏的 PendingIntent 默认用FLAG_ACTIVITY_NEW_TASK启动 Activity如果目标 Activity 是standard模式它会新建一个任务栈导致返回键无栈可回。解决给通知的 Intent 加上FLAG_ACTIVITY_CLEAR_TOP和FLAG_ACTIVITY_SINGLE_TOP或者把目标 Activity 的启动模式设为singleTask。更稳妥的做法是用TaskStackBuilder构建一个合成返回栈。Intent intent new Intent(this, DetailActivity.class); intent.putExtra(from_notification, true); TaskStackBuilder stackBuilder TaskStackBuilder.create(this); stackBuilder.addNextIntentWithParentStack(intent); PendingIntent pendingIntent stackBuilder.getPendingIntent(0, PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE);4.3 现象Activity 里启动的线程在页面关闭后还在跑导致崩溃原因在 Activity 里直接new Thread()启动后台任务页面销毁后线程还在运行回调时更新 UI 就会抛NullPointerException或IllegalStateException。解决用ViewModel配合LiveData管理异步任务ViewModel 的生命周期比 Activity 长但不会泄漏 Activity。如果必须用线程在onDestroy里中断线程并在回调前判断isFinishing()或isDestroyed()。Override protected void onDestroy() { super.onDestroy(); if (backgroundThread ! null backgroundThread.isAlive()) { backgroundThread.interrupt(); } }4.4 现象singleTask模式下onActivityResult不回调原因singleTask的 Activity 如果已经存在再次启动时不会新建实例而是走onNewIntent此时startActivityForResult的结果无法正常回传。解决避免对需要返回结果的 Activity 使用singleTask。如果业务必须用改用EventBus或LiveData做跨页面通信不要依赖onActivityResult。4.5 现象getIntent()拿到的数据是上一次的原因在singleTop或singleTask模式下Activity 复用时会触发onNewIntent但如果没有调用setIntent(intent)getIntent()返回的还是旧 Intent。解决在onNewIntent里第一行就调用setIntent(intent)然后再读取数据。这个坑在推送跳转场景里特别常见因为推送会频繁触发onNewIntent。5. 用 ViewModel SavedStateHandle 做状态恢复的进阶技巧前面讲的onSaveInstanceState只能存轻量级数据而且进程被杀后 Bundle 可能丢失。如果你需要更可靠的状态恢复推荐用ViewModel配合SavedStateHandle。ViewModel在配置变更如旋转屏幕时不会销毁SavedStateHandle则能在进程被杀后恢复数据。public class SearchViewModel extends ViewModel { private SavedStateHandle savedStateHandle; private MutableLiveDataString keywordLiveData; public SearchViewModel(SavedStateHandle savedStateHandle) { this.savedStateHandle savedStateHandle; keywordLiveData savedStateHandle.getLiveData(keyword, ); } public void setKeyword(String keyword) { savedStateHandle.set(keyword, keyword); keywordLiveData.setValue(keyword); } public LiveDataString getKeyword() { return keywordLiveData; } }在 Activity 里获取 ViewModelpublic class SearchActivity extends AppCompatActivity { private SearchViewModel viewModel; Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_search); viewModel new ViewModelProvider(this).get(SearchViewModel.class); viewModel.getKeyword().observe(this, keyword - { searchEditText.setText(keyword); }); findViewById(R.id.btn_search).setOnClickListener(v - { String input searchEditText.getText().toString(); viewModel.setKeyword(input); performSearch(input); }); } }SavedStateHandle的 key 用字符串value 支持基本类型、String、Parcelable 等。它的优势是数据存在系统进程的 Bundle 里即使用户离开 App 后进程被回收重新打开时也能恢复。但注意不要存大对象否则同样会触发TransactionTooLargeException。验证方法很简单打开开发者选项里的“不保留活动”然后操作 App 到搜索页按 Home 键回到桌面再重新进入 App。如果搜索关键词还在说明状态恢复生效了。这个选项在“开发者选项 → 应用 → 不保留活动”里打开后每次离开 Activity 都会被销毁是测试状态恢复的利器。我自己的习惯是任何涉及用户输入或滚动位置的页面一律用ViewModel SavedStateHandle兜底不再依赖onSaveInstanceState手动存取。这样代码更干净而且不容易漏字段。希望帮到你。本文还有配套的精品资源点击获取

Android Activity 功能代码实战：生命周期、状态保存与避坑指南

相关推荐

Java连接PostgreSQL完整指南：JDBC驱动、连接池与避坑清单

cua：命令行耗时分析器，追踪进程时间线上看不见的等待

Pytest项目接入Allure：从配置到CI集成的完整实战指南

更多资讯

PJ85718DM+MKV42F128VLH16工业温控信号链设计

Muse与Dots竞逐消费级AI agent；700篇AI证明引发数学家抵制 | 科技日报1009

OpenHarmony实战：MAX30100血氧心率传感器驱动开发从零到通

CMake 策略 CMP0107 详解：禁止 ALIAS 目标覆盖同名已有目标

用 __android_log_print(ANDROID_LOG_DEBUG, 打印出data_ptr[i]的值

Flink电商实时计算实战：从Kafka到五大核心指标

今日更新

再见，SSE！你好，Streamable HTTP！轻松开发 Streamable HTTP MCP Server 并接入 TaoToken

工业软件标准化路线图：国产替代的落地施工图

VCMI安卓版实操指南：原生运行英雄无敌3的3步技术落地

本周精选

CMOS设计三大物理效应：体效应、沟道长度调制与亚阈值导电

微信小程序在线阅读毕设全解析：Java后端+MySQL+避坑实战

Android音频问题五层分析法：从App到Codec的系统化诊断

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？