Skip to content

heruoxin/IceBox-SDK

Repository files navigation

IceBox-SDK

冰箱 SDK,可以在已安装并启用了冰箱的设备上,为第三方 App 提供冻结/解冻的功能。

冻结/解冻需要冰箱版本号 >= 3.6.0;

静默安装需要冰箱版本号 >= 3.9.5。

使用方法

依赖

添加依赖,在 app 下的 build.gradle 文件中:

repositories {
    ......
    ......
    maven { url 'https://dl.bintray.com/heruoxin/icebox' }
}

dependencies {
    ......
    ......
    implementation 'com.catchingnow.icebox:SDK:1.0.5'
}

请求权限

在 Android 6.0+ 设备上,冰箱 SDK 的操作类接口(冻结/安装 APK)需要先请求权限再使用,查询类的接口都不需要。

 if (ContextCompat.checkSelfPermission(this, IceBox.PERMISSION) != PackageManager.PERMISSION_GRANTED) {
            ActivityCompat.requestPermissions(this, new String[]{IceBox.PERMISSION}, 0x233);
 }

调用接口

冻结解冻相关接口

查询工作模式

不需要权限,冰箱可能工作在 pm disable-user 或 pm hide 两种模式下。

 IceBox.WorkMode workMode = IceBox.queryWorkMode(getContext());
查询 App 状态

不需要权限,是正常/ pm disable 冻结/ pm hide 冻结/ both:

IceBox.getAppEnabledSetting(context, packageName);
// 或者
IceBox.getAppEnabledSetting(applicationInfo);
冻结/解冻 App

需要权限,支持批量操作

 IceBox.setAppEnabledSettings(getContext(), enable, PACKAGE_NAME...);

静默安装卸载相关接口

当冰箱运行在设备管理员(俗称免 Root)模式下时,可对外提供静默安装和卸载 APK 的接口。

查询是否支持
 IceBox.querySupportSilentInstall(context);

返回为一个枚举类型

    public enum SilentInstallSupport {
        SUPPORTED,

        NOT_INSTALLED,          //未安装冰箱 IceBox;
        UPDATE_REQUIRED,        //冰箱 IceBox 版本过低;
        SYSTEM_NOT_SUPPORTED,   //当前系统版本过低,不支持静默安装;
        NOT_DEVICE_OWNER,       //冰箱 IceBox 不是设备管理员;
        PERMISSION_REQUIRED,    //当前 App 未取得权限,请发起标准的 Android 权限请求;
    }
安装/卸载 APK

在冰箱支持,并且用户授权了的前提下,可以调用实现静默安装卸载,无需用户确认。方法均为同步,直到安装完成或失败后才会返回。

安装成功后通知栏会由系统发送通知提示,同时冰箱的 SDK 日志页面中也会留存记录。

// 安装
IceBox.installPackage(context, uriToApk);

// 卸载
IceBox.uninstallPackage(context, packageName);

更详细的代码示例可见 冻结解冻 Demo静默安装 Demo

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages