2tu / condom

一个超轻超薄的Android工具库，阻止三方SDK中常见的严重影响用户体验的『链式唤醒』行为。（对应用自身的功能无影响）

Project Condom

Project Condom is a thin library to wrap the naked Context in your Android project before passing it to the 3rd-party SDK. It is designed to prevent the 3rd-party SDK from common unwanted behaviors which may harm the user experience of your app.

• Massive launch of processes in other apps (common in 3rd-party push SDKs), causing slow app starting and notable lagging on low to middle-end devices. This behavior has "chain reaction" effects among apps with similar SDKs, greatly aggravating the overall device performance.

Quick Start

Most 3rd-party SDKs require explicit initialization with a Context instance, something like:

XxxClient.init(context, ...);

Just change the context paramter to CondomContext.wrap(context), like this:

XxxClient.init(CondomContext.wrap(context, "XxxSDK"), ...);

That's it! Enjoy the protection.

---

保险套项目

『保险套』是一个超轻超薄的Android工具库，将它套在Android应用工程里裸露的Context上，再传入第三方SDK（通常是其初始化方法），即可防止三方SDK 中常见的损害用户体验的行为：

• 在后台启动大量其它应用的进程（在三方推送SDK中较为常见），导致应用启动非常缓慢，启动后一段时间内出现严重的卡顿（在中低端机型上尤其明显）。 这是由于在这些SDK初始化阶段启动的其它应用中往往也存在三方SDK的类似行为，造成了进程启动的『链式反应』，在短时间内消耗大量的CPU、文件IO及 内存资源，使得当前应用所能得到的资源被大量挤占（甚至耗尽）。

快速开始

常见的三方SDK需要应用在启动阶段调用其初始化方法，一般包含Context参数，例如：

XxxClient.init(context, ...);

只需将其修改为：

XxxClient.init(CondomContext.wrap(context, "XxxSDK"), ...);

其中参数tag（上例中的"XxxSDK"）为开发者根据需要指定的用于区分多个不同CondomContext实例的标识，将出现在日志的TAG后缀。 如果只有一个CondomContext实例，或者不需要区分，则传入null亦可。

就这样简单的一行修改，三方SDK就无法再使用这个套上了保险套的Context去唤醒当前并没有进程在运行的其它app。 （已有进程在运行中的app仍可以被关联调用，因为不存在大量进程连锁创建的巨大资源开销，因此是被允许的。这也是Android O开始实施的限制原则）

工作原理

CondomContext是一个加入了特定API拦截和调整机制的ContextWrapper，这些调整和拦截包括：（均可单独开启或关闭）

• 开发者可主动设置一个OutboundJudge回调，方便根据需求定制拦截策略。
• 避免通过此Context发出的广播启动其它应用的进程。在Android N以上，通过为非应用内广播的Intent添加FLAG_RECEIVER_EXCLUDE_BACKGROUND标志达成；在低版本Android系统中，通过添加FLAG_RECEIVER_REGISTERED_ONLY达到类似的效果。
• 避免通过此Context发出的广播或请求的服务启动已被用户强行停止的应用。通过为发往应用之外的广播或服务请求Intent添加FLAG_EXCLUDE_STOPPED_PACKAGES标识达成。