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.

1. Add dependency to this library in build.gradle of your project module.

   compile 'com.oasisfeng.condom:library:1.1.1'
   

2. Migration the initialization code of 3rd-party SDK.

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

   XxxClient.init(context, ...);
   

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

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

3. If the 3rd-party SDK contains its own components (<activity>, <service>, <receiver> or <provider>), they will not be running with CondomContext. To also prevent them from unwanted behaviors, CondomProcess is introduced to apply the process-level condom protection, assuming that those components are already isolated from your application process (with separate android:process specified). Add the following initialization code in the very beginning of your Application.onCreate().

   public class MyApplication extends Application {
   
     @Override public void onCreate() {
       CondomProcess.installExceptDefaultProcess(this);
       ...
     }
   }
   

That's all! Enjoy the pleasure with the confidence of protection.

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

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

注意：此项目通常并不适用于核心功能强依赖特定外部应用或组件的SDK（如Facebook SDK、Google Play services SDK）。 如果希望在使用此类SDK时避免后台唤醒依赖的应用，仅在特定条件下（如用户主动作出相关操作时）调用SDK所依赖的应用，则可以使用本项目，并通过CondomContext.setOutboundJudge()自主控制何时放行。

1. 首先在工程中添加对此项目的依赖项。

   对于Gradle工程，直接在模块的依赖项清单中添加下面这一行：

   compile 'com.oasisfeng.condom:library:1.1.1'
   

   对于非Gradle工程，请下载AAR文件放进项目模块本地的 libs 路径中，并在工程的ProGuard配置文件中增加以下规则：（Gradle工程和不使用ProGuard的工程不需要这一步）

   -dontwarn android.content.IContentProvider
   -dontwarn android.content.ContentResolver
   -keep class com.oasisfeng.condom.**
   

2. 略微修改三方SDK的初始化代码。

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

   XxxClient.init(context, ...);
   

   只需将其修改为：

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

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

3. 如果三方SDK含有自己的组件（Activity、Service、Receiver 或 Provider），为防止这些组件内的有害行为，还需要确保这些组件的工作进程与应用自己的进程隔离（android:process使用非应用自有组件的进程名），并在应用的Application.onCreate()起始部分调用CondomProcess.installExceptDefaultProcess(this) (或CondomProcess.installExcept(this, ...))。如下所示：

   public class MyApplication extends Application {
   
     @Override public void onCreate() {
       CondomProcess.installExceptDefaultProcess(this);
       ...
     }
   }
   

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

CondomContext是一个加入了特定API拦截和调整机制的ContextWrapper，它只作用于通过这个CondomContext实例发生的行为，完全不会触及除此之外的其它Context，因此不必担心对应用的自有功能造成影响，可以放心的使用。其中涉及到的调整和拦截包括：（可通过配置CondomOptions选择性使用）

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

CondomProcess采用了更偏底层的API拦截策略对整个进程内与系统服务之间的IPC通信进行拦截和调整，达到与CondomContext类似的效果。由于它被设计为工作在三方SDK组件的独立进程内，因此也不会对应用的自有功能造成任何影响。