示例工程教程【免费下载链接】cw-omnibusSource code to omnibus edition of _The Busy Coders Guide to Android Development_项目地址https://gitcode.com/gh_mirrors/cw/cw-omnibus点击查看免费下载本篇技术指南围绕 cw-omnibus 仓库中 Tasks/NoHistory 示例展开深入讲解 Android 中如何将一个 Activity 从任务历史task history中移除包括 Manifest 中的android:noHistory属性、Intent.FLAG_ACTIVITY_NO_HISTORY标志以及如何借助生命周期日志验证两者带来的实际行为。读完本文你将掌握两种移除任务历史的实现方式、各自的适用场景与注意事项并能在自己的项目中直接复刻这套生命周期日志 标志位的验证方案。示例工程定位Tasks 章节目录中的任务行为演示cw-omnibus 是《The Busy Coders Guide to Android Development》一书的配套源码仓库顶层目录与书的章节主题对应Tasks/目录集中了与任务与返回栈tasks back stack相关的系列演示工程。该目录下包含NoHistory从任务历史中移除 Activity本文主题Tasksalot启动一个干净的新任务RoundRobin使用FLAG_ACTIVITY_REORDER_TO_FRONT调整任务内 Activity 顺序ReparentDemo把一个 Activity 从某个任务迁移reparent到另一个任务Nukesalot实现一个所谓的任务杀手task killerPersistentCanary使用persistAcrossReboots跨重启保存状态TaskCanary跟踪应用对各类任务事件与配置变化的响应Docs任务场景下的多窗口编辑演示。NoHistory 的 README 将本示例定位为演示如何将一个 Activity 从任务历史中移除how to remove an activity from the task history。虽然 README 本身极其简短但工程源码完整呈现了这一主题的全部实现细节是理解任务历史管理机制的理想样本。工程结构与关键文件NoHistory 是一个标准的单模块 Android 工程目录结构如下Tasks/NoHistory/ ├── README.markdown ├── settings.gradle # include :app ├── project.properties # targetandroid-19 ├── proguard-project.txt ├── gradle/ │ └── wrapper/ │ └── gradle-wrapper.properties └── app/src/main/ ├── AndroidManifest.xml ├── java/com/commonsware/android/tasks/nohistory/ │ ├── LifecycleLoggingActivity.java │ ├── MainActivity.java │ └── OtherActivity.java └── res/ ├── layout/main.xml ├── layout/other.xml └── values/strings.xml整个演示只包含两个界面MainActivity与OtherActivity外加一个负责输出生命周期日志的基类LifecycleLoggingActivity。它演示了两条移除任务历史的路径声明式在 AndroidManifest.xml 中给MainActivity配置android:noHistorytrue命令式在 MainActivity.java 中启动OtherActivity的 Intent 上附加Intent.FLAG_ACTIVITY_NO_HISTORY。界面与交互流程两个界面都很简单便于把注意力集中在任务行为上。入口界面 MainActivity布局文件 main.xml 中只有一个占满整个屏幕的Button文案来自 strings.xml 中的hello字符串I am the first activity!并通过android:onClickshowOther声明式绑定点击回调。对应的 MainActivity.java 代码如下public class MainActivity extends LifecycleLoggingActivity { Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); } public void showOther(View v) { Intent other new Intent(this, OtherActivity.class); other.putExtra(OtherActivity.EXTRA_MESSAGE, getString(R.string.other)); other.addFlags(Intent.FLAG_ACTIVITY_NO_HISTORY); startActivity(other); } }点击按钮后MainActivity构造一个指向OtherActivity的显式 Intent通过putExtra()把strings.xml中other字符串I am the other activity!作为消息传入随后调用addFlags(Intent.FLAG_ACTIVITY_NO_HISTORY)为这次启动打上不留历史标记最后startActivity(other)完成跳转。目标界面 OtherActivityOtherActivity.java 同样继承LifecycleLoggingActivity。它定义了公共常量EXTRA_MESSAGEmsg作为 Intent extra 的键并在onCreate()中从 other.xml 找到红色TextView把getIntent().getStringExtra(EXTRA_MESSAGE)取回的消息显示出来public class OtherActivity extends LifecycleLoggingActivity { public static final String EXTRA_MESSAGEmsg; Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.other); TextView tv (TextView)findViewById(R.id.msg); tv.setText(getIntent().getStringExtra(EXTRA_MESSAGE)); } }生命周期观察基类LifecycleLoggingActivity.java 是演示得以自证的关键它覆盖了onCreate、onRestart、onStart、onResume、onPause、onStop、onDestroy全部生命周期回调并用当前类的简单类名getClass().getSimpleName()作为 Tag、以Log.d输出对应方法名。例如Override public void onDestroy() { Log.d(getClass().getSimpleName(), onDestroy()); super.onDestroy(); }这样两个 Activity 各自的生命周期流转都会被写入 logcat。由于 Tag 分别是MainActivity与OtherActivity运行时可清晰地分辨哪个 Activity 在什么时刻被销毁从而直接观察noHistory的效果。方式一Manifest 声明android:noHistorytrueAndroidManifest.xml 中对入口 Activity 的声明如下activity android:name.MainActivity android:labelstring/app_name android:noHistorytrue intent-filter action android:nameandroid.intent.action.MAIN/ category android:nameandroid.intent.category.LAUNCHER/ /intent-filter /activityandroid:noHistory是activity节点上的布尔属性默认值为false。将其设为true后一旦用户从这个 Activity 导航离开navigates away该 Activity 就会从任务的任务栈task中被移除并执行finish()而不再驻留在返回栈中供用户通过 BACK 键返回。这相当于在声明层面为这个 Activity永久附加了FLAG_ACTIVITY_NO_HISTORY的效果不依赖任何一处startActivity()调用点。在 Manifest 中同时声明了两个 ActivityMainActivity带noHistorytrue与OtherActivity未设置该属性。也就是说OtherActivity这条路径上的不留历史行为完全由运行时的 Intent 标志下文负责两者对照恰好形成声明式 vs 命令式两种写法的互补演示。方式二启动时附加FLAG_ACTIVITY_NO_HISTORY在 MainActivity.java 的 showOther() 中关键一行是other.addFlags(Intent.FLAG_ACTIVITY_NO_HISTORY);FLAG_ACTIVITY_NO_HISTORY是 Android 框架提供的一个 Intent 标志其常量值为0x40000000语义是被该 Intent 启动的新 Activity 不会被放入历史栈history stack一旦用户导航离开它该 Activity 就会立刻被结束finish。它与 Manifest 的android:noHistory属性在机制上等价区别仅在于作用范围对比维度android:noHistorytrueFLAG_ACTIVITY_NO_HISTORY作用位置Manifest 的activity节点启动目标 Activity 的 Intent 上生效时机声明即生效所有指向该 Activity 的启动都受影响仅对携带该标志的这一次启动生效适用场景某个 Activity 永远不该留在任务历史中如入口/中转页只想针对某一次跳转临时关闭历史记录代码/配置纯静态配置无代码侵入需要在使用处addFlags()在本示例中OtherActivity正是通过后者被启动的因此移除任务历史的效果同时对两个 Activity 生效入口MainActivity靠 Manifest 属性跳转目标OtherActivity靠 Intent 标志。运行时行为从 logcat 看任务历史被移除由于LifecycleLoggingActivity对每次生命周期回调都打印日志可以按如下方式运行验证在 Android Studio 的 Logcat 中过滤 Tag 为MainActivity或OtherActivity或使用命令行adb logcat -s MainActivity:V OtherActivity:V。冷启动应用MainActivity依次打印onCreate()→onStart()→onResume()此时任务栈内容为[MainActivity]。点击按钮跳转到OtherActivityOtherActivity打印onCreate()→onStart()→onResume()。与此同时因为MainActivity声明了android:noHistorytrue用户一导航离开它就应被从任务栈移除日志中会紧接着出现MainActivity的onPause()→onStop()→onDestroy()——注意这里没有onRestart()说明它不会被保留在栈中等候返回。在OtherActivity上按 BACK由于OtherActivity是通过携带FLAG_ACTIVITY_NO_HISTORY的 Intent 启动的它同样不在历史栈中此时任务栈已经为空按 BACK 会直接结束任务退出应用OtherActivity打印onPause()→onStop()→onDestroy()后进程退出。也就是说两个 Activity 都用完即走返回栈中不会残留任何一层界面。日志中onDestroy()的及时出现就是该 Activity 已被移出任务历史最直接的可观测证据。使用要点与边界基于上面的源码实现与框架语义使用这两项机制时有几个值得注意的边界触发时机是导航离开而非被覆盖noHistory的移除动作发生在用户从该 Activity 导航离开例如按 BACK、按 HOME 或跳转到其他界面之时而不是它被其他界面短暂覆盖时就立即销毁。效果与调用finish()相似但时机不同可以近似理解为用户一离开就自动 finish但无需在代码里显式调用finish()也不存在把finish()写在生命周期回调里的时序问题。与 BACK 键的关系历史栈中没有该 Activity 后BACK 键自然也就无法退回到它如果它是栈中唯一的 Activity任务就会结束。适合的场景典型的过渡/中转界面例如启动闪屏、一次性向导、跳转中间的临时页以及不希望用户返回的页面例如支付完成页、登出后的残留页。反过来说不该给承载核心返回路径的 Activity 随意设置否则会破坏用户预期的返回导航。两个 API 语义等价Manifest 属性与 Intent 标志在框架层实现的是同一套不留历史行为选择哪一个主要取决于是页面级策略还是单次启动策略。构建与运行说明从仓库内容看NoHistory 属于书中的早期示例工程根目录 settings.gradle 只包含一行include :appproject.properties 声明targetandroid-19gradle-wrapper.properties 指向 Gradle 4.4而工程内没有提供build.gradle因此它更接近旧版Eclipse/Ant 时代的项目布局需要补充或改造 Gradle 构建脚本后才能直接用现代 Android Gradle Plugin 编译。这一点与仓库根目录 README.markdown 的通用说明一致各示例工程以可导入 Android Studio为目标但导入时可能需要根据本机已下载的 SDK 调整compileSdkVersion与buildToolsVersion同时仓库出于安全考虑没有附带gradlew可执行脚本及其 JAR命令行构建需要自行准备本地 Gradle 安装。对本文示例而言若要在新环境复现建议新建app/build.gradle将minSdk设为不低于 14Manifest 中声明的android:minSdkVersion14targetSdk可沿用 21 或提升到目标版本然后以include :app的模块结构导入 Android Studio 运行。小结Tasks/NoHistory用极简的两个界面演示了一个明确的系统行为——让 Activity 退出任务历史MainActivity通过 AndroidManifest.xml 的android:noHistorytrue声明式移除自身OtherActivity通过 MainActivity.java 的FLAG_ACTIVITY_NO_HISTORY命令式移除自身而 LifecycleLoggingActivity.java 提供的全量生命周期日志则让移除动作发生与否可以直接用 logcat 验证。这套日志基类 双机制对照的组织方式本身也是学习 Android 任务与返回栈行为的极佳模板若想继续深入任务管理主题可以顺藤摸瓜阅读Tasks/目录下的 Tasksalot干净任务、RoundRobinFLAG_ACTIVITY_REORDER_TO_FRONT、ReparentDemo任务重父与 TaskCanary任务事件跟踪等系列示例。赞分享示例工程教程【免费下载链接】cw-omnibusSource code to omnibus edition of _The Busy Coders Guide to Android Development_项目地址https://gitcode.com/gh_mirrors/cw/cw-omnibus点击查看免费下载相关推荐cw-omnibus 实战用 FauxSender 示例实现 ACTION_SEND 分享接收 Activitycw omnibus 实战用 FauxSender 示例实现 ACTION_SEND 分享接收 Activity 导读 当用户在浏览器、笔记类应用或其他 Ap示例工程教程cw-omnibus AFClient 示例剖析在 Android 8.0 的 Activity 中接入 Autofill 支持cw omnibus AFClient 示例剖析在 Android 8.0 的 Activity 中接入 Autofill 支持 导读 本文以 cw omn示例工程教程cw-omnibus Freecar 示例解析用 Quick Settings Tile 强制 Activity 以自由窗口free-form启动cw omnibus Freecar 示例解析用 Quick Settings Tile 强制 Activity 以自由窗口free form启动 本篇指示例工程教程上一篇Steam成就管理器开源工具让游戏成就掌控在你手中下一篇Steam成就管理终极指南开源神器SAM让你的游戏成就尽在掌握创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考