condom

项目地址:oasisfeng/condom
更多:作者   提 Bug   
标签:

Download Build Status License: Apache 2.0

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

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

    compile 'com.oasisfeng.condom:library:1.2.0'
    
  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.2.0'
    

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

    -dontwarn android.content.IContentProvider
    -dontwarn android.content.ContentResolver
    -dontwarn android.content.pm.PackageManager
    -dontwarn android.content.pm.PackageManager$**
    -dontwarn android.content.pm.IPackageDeleteObserver
    -dontwarn android.content.pm.IPackageDataObserver
    -dontwarn android.content.pm.IPackageStatsObserver
    -dontwarn android.content.pm.KeySet
    -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 组件的独立进程内,因此也不会对应用的自有功能造成任何影响。

Android 开发经验分享
用了一年多的理财推荐
Android 开发经验分享
用了一年多的理财推荐