buildscript {
    repositories {
        maven { url 'https://jitpack.io' }
        mavenCentral()
        google()
    }

    dependencies {
        classpath 'com.github.allenymt.PrivacySentry:plugin-sentry:1.3.7_v820_beta4'
    }
}

allprojects {
    repositories {
        maven { url 'https://jitpack.io' }
        mavenCentral()
        google()
    }
}

// 应用插件
apply plugin: 'privacy-sentry-plugin'

dependencies {
    def privacyVersion = "1.3.7_v820_beta4"

    // 核心库（必须）
    implementation "com.github.allenymt.PrivacySentry:hook-sentry:$privacyVersion"
    implementation "com.github.allenymt.PrivacySentry:privacy-annotation:$privacyVersion"

    // 预置拦截实现（强烈推荐）
    implementation "com.github.allenymt.PrivacySentry:privacy-proxy:$privacyVersion"

    // 类替换功能（已废弃，不推荐使用）
    // implementation "com.github.allenymt.PrivacySentry:privacy-replace:$privacyVersion"
}

privacy {
    // ========== 核心配置 ==========

    /**
     * 插件功能总开关
     * 类型：Boolean
     * 默认值：true
     * 说明：控制 PrivacySentry 插件是否生效
     *      - true: 启用插件，执行字节码转换
     *      - false: 禁用插件，相当于未集成
     */
    enablePrivacy = true

    /**
     * 黑名单配置
     * 类型：Set<String>
     * 默认值：null (空列表)
     * 说明：指定不进行字节码修改的包名列表
     *      - 适用场景：
     *        1. 使用了其他 ASM 字节码修改工具的三方库（如高德地图）
     *        2. 已知会导致冲突的 SDK
     *        3. 不需要监控的系统库或三方库
     *      - 注意：blackList 中的包不会被插件修改，也无法拦截其中的敏感 API
     */
    blackList = []

    // 常见黑名单配置示例：
    // blackList = [
    //     "com.loc",              // 高德地图（ASM 版本冲突）
    //     "com.amap.api",         // 高德地图 API
    //     "io.openinstall.sdk",   // OpenInstall SDK
    //     "com.google.android",   // Google 服务（可选）
    //     "androidx"              // AndroidX 库（可选）
    // ]

    /**
     * 静态扫描结果文件名
     * 类型：String
     * 默认值："privacy_hook.json"
     * 说明：记录所有被代理的方法名和类名的文件名
     *      - 文件位置：项目根目录
     *      - 文件格式：JSON
     *      - 内容包含：
     *        1. hookServiceList: 被 hook 的 Service 列表
     *        2. replaceMethodMap: 被替换的方法映射表
     *      - 设置为 null 或空字符串则不生成文件
     */
    replaceFileName = "privacy_hook.json"

    // ========== 反射 Hook 配置（可选）==========

    /**
     * 反射方法 Hook 开关
     * 类型：Boolean
     * 默认值：false
     * 说明：是否拦截通过反射调用的敏感方法
     *      - true: 拦截反射调用（需配合 reflexMap 使用）
     *      - false: 不拦截反射调用
     *      - 适用场景：
     *        1. 三方 SDK 通过反射获取设备信息（如小米 OAID）
     *        2. 极光推送、个推、穿山甲等 SDK 的设备标识获取
     *      - 性能影响：轻微（仅影响 LDC 指令的匹配）
     */
    hookReflex = false

    /**
     * 反射拦截配置映射
     * 类型：Map<String, List<String>>
     * 默认值：null
     * 说明：配置需要拦截的反射调用
     *      - Key: 类的全限定名
     *      - Value: 该类中需要拦截的方法名列表
     *      - 只有 hookReflex = true 时才生效
     *      - 匹配原理：检测字节码中的 LDC 指令加载的字符串常量
     */
    reflexMap = [:]

    // 反射拦截配置示例：
    // reflexMap = [
    //     // 小米设备标识服务
    //     "com.android.id.impl.IdProviderImpl": [
    //         "getOAID",   // 开放匿名设备标识符
    //         "getAAID",   // 应用匿名设备标识符
    //         "getVAID"    // 开发者匿名设备标识符
    //     ],
    //     // 自定义类的反射方法
    //     "com.example.utils.DeviceUtils": [
    //         "getDeviceId",
    //         "getIMEI"
    //     ]
    // ]

    // ========== 已废弃功能（不推荐使用，仅供参考）==========

    /**
     * 字段 Hook 开关（已废弃）
     * 类型：Boolean
     * 默认值：false
     * 废弃原因：几乎没有业务场景，功能不稳定
     * 说明：是否 hook 字段访问（如 Build.SERIAL）
     *      - 不推荐使用，请使用方法 hook 代替
     */
    // hookField = false

    /**
     * 构造函数 Hook 开关（已废弃）
     * 类型：Boolean
     * 默认值：false
     * 废弃原因：实现复杂，稳定性差，已停止维护
     * 说明：是否 hook 构造函数（主要用于拦截 File 构造函数参数）
     *      - 相关模块：privacy-replace
     *      - 不推荐使用
     */
    // hookConstructor = false

    /**
     * Manifest 处理开关（已废弃）
     * 类型：Boolean
     * 默认值：false
     * 废弃原因：功能边界不清晰，已停止维护
     * 说明：是否处理 AndroidManifest.xml 文件
     *      - 主要用于处理 Service 的 Priority 和 Export
     *      - 不推荐使用
     */
    // enableProcessManifest = false

    /**
     * Service Priority 替换开关（已废弃）
     * 类型：Boolean
     * 默认值：false
     * 废弃原因：针对 MIUI 自启动问题的特殊方案，已停止维护
     * 说明：是否替换 Service 的 Priority 值
     *      - 部分 Service 设置 Priority = 1000 导致自启动
     *      - 开启后会将 Priority 替换为 replacePriority 的值
     *      - 不推荐使用
     */
    // enableReplacePriority = false

    /**
     * Service Priority 替换值（已废弃）
     * 类型：Int
     * 默认值：0
     * 说明：替换后的 Priority 值
     *      - 配合 enableReplacePriority 使用
     *      - 不推荐使用
     */
    // replacePriority = 0

    /**
     * Service Export 关闭开关（已废弃）
     * 类型：Boolean
     * 默认值：false
     * 废弃原因：可能影响厂商推送功能，已停止维护
     * 说明：是否关闭 Service 的 Export 功能
     *      - 注意：部分厂商推送（小米、VIVO、华为）的 PushService 不能关闭
     *      - 配合 serviceExportPkgWhiteList 使用
     *      - 不推荐使用
     */
    // enableCloseServiceExport = false

    /**
     * Service Export 白名单（已废弃）
     * 类型：Set<String>
     * 默认值：null
     * 说明：允许保持 Export 的 Service 包名列表
     *      - 配合 enableCloseServiceExport 使用
     *      - 不推荐使用
     */
    // serviceExportPkgWhiteList = []

    /**
     * Service StartCommand Hook 开关（已废弃）
     * 类型：Boolean
     * 默认值：false
     * 废弃原因：针对 MIUI 自启动问题的特殊方案，已停止维护
     * 说明：是否 hook Service 的 startCommand 方法
     *      - 不推荐使用
     */
    // enableHookServiceStartCommand = false
}

privacy {
    blackList = [
        // 高德地图（ASM 版本冲突）
        "com.loc",
        "com.amap.api",

        // OpenInstall SDK
        "io.openinstall.sdk",

        // Google 服务（可选）
        "com.google.android",

        // AndroidX 库（可选）
        "androidx",

        // 自定义不需要监控的包
        "com.example.thirdparty"
    ]
}

privacy {
    hookReflex = true

    reflexMap = [
        "com.android.id.impl.IdProviderImpl": [
            "getOAID",   // 开放匿名设备标识符
            "getAAID",   // 应用匿名设备标识符
            "getVAID"    // 开发者匿名设备标识符
        ]
    ]
}

privacy {
    hookReflex = true

    reflexMap = [
        // 小米设备标识
        "com.android.id.impl.IdProviderImpl": [
            "getOAID", "getAAID", "getVAID"
        ],

        // 华为设备标识
        "com.huawei.hms.ads.identifier.AdvertisingIdClient": [
            "getAdvertisingIdInfo"
        ],

        // 自定义工具类
        "com.example.utils.DeviceUtils": [
            "getDeviceId",
            "getIMEI",
            "getAndroidId"
        ]
    ]
}

privacy {
    hookReflex = true

    reflexMap = [
        // 极光推送反射获取设备信息
        "cn.jpush.android.api.JCoreInterface": [
            "getDeviceId",
            "getRegistrationID"
        ],

        // 个推反射获取设备信息
        "com.igexin.sdk.PushManager": [
            "getClientid"
        ]
    ]
}

privacy {
    // 生成静态扫描文件
    replaceFileName = "privacy_hook.json"

    // 不生成文件
    // replaceFileName = null
}