[ { "path": ".gitignore", "content": "*.iml\n.gradle\n/local.properties\n/.idea/\n.DS_Store\n/build\n/captures\n.externalNativeBuild\n.cxx\nlocal.properties\n/plugin-sentry/~/.m2/\n.build_history/\n/local\n" }, { "path": "CLAUDE.md", "content": "# CLAUDE.md\n\nThis file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.\n\n## 项目概述\n\nPrivacySentry 是一个 Android 隐私合规检测工具,通过 ASM 字节码插桩技术在编译期和运行期拦截敏感 API 调用,帮助开发者规避应用市场上架时的隐私合规检测问题。\n\n## 核心架构\n\n### 三层架构设计\n\n1. **plugin-sentry (Gradle 插件层)**\n - 基于 AGP 8.0+ 和 Booster 框架的 Gradle 插件\n - 负责在编译期进行字节码转换 (Transform)\n - 两阶段 Transform:\n - 第一阶段: 收集需要拦截的敏感函数 (MethodProxyCollectTransform, ClassProxyCollectTransform)\n - 第二阶段: 替换敏感函数调用 (MethodHookTransform, FieldProxyTransform, ClassProxyTransform)\n - 关键类: `PrivacySentryPlugin.kt`, `PrivacyTransformTask.kt`\n\n2. **privacy-annotation (注解层)**\n - 定义编译期注解用于声明需要拦截的方法和字段\n - 核心注解:\n - `@PrivacyMethodProxy`: 标记需要代理的方法\n - `@PrivacyFieldProxy`: 标记需要代理的字段\n - `@PrivacyClassProxy`: 标记包含代理方法的类\n - `@PrivacyClassBlack`: 标记不需要拦截的黑名单类\n\n3. **hook-sentry (运行时 Hook 层)**\n - 提供运行时的 SDK 初始化和日志收集功能\n - 支持三种缓存策略: 内存缓存 (MemoryCache)、时效性磁盘缓存 (TimeLessDiskCache)、永久磁盘缓存 (DiskCache)\n - 日志输出到文件 (.xls 格式)\n - 关键类: `PrivacySentry.kt`, `PrivacySentryBuilder.kt`\n\n4. **privacy-proxy (预置代理实现)**\n - 提供常用敏感 API 的拦截实现\n - 通过注解声明拦截规则,由插件在编译期自动收集\n - 关键类: `PrivacyProxyCall.kt`, `PrivacyTelephonyProxy.kt`, `PrivacySensorProxy.kt`\n\n### 工作原理\n\n1. **编译期**: 插件扫描所有 `@PrivacyMethodProxy` 注解,收集需要拦截的方法列表\n2. **字节码转换**: 将目标方法调用替换为代理方法调用\n3. **运行期**: 代理方法执行实际逻辑,并记录调用堆栈和时机到日志文件\n\n## 常用命令\n\n### 构建项目\n```bash\n./gradlew clean build\n```\n\n### 编译调试 (本地依赖模式)\n修改 `config.gradle`:\n```gradle\nbuild = [\n local_debug: true,\n local_debug_dir : \"${rootProject.projectDir}/local\"\n]\n```\n\n### 发布到本地 Maven\n```bash\n./gradlew publishToMavenLocal\n```\n\n### 运行测试应用\n```bash\n./gradlew :app:installDebug\n```\n\n## 项目模块说明\n\n- **app**: 示例应用,演示如何集成和使用 PrivacySentry\n- **plugin-sentry**: Gradle 插件,负责字节码转换\n- **hook-sentry**: 运行时 SDK 核心库\n- **privacy-annotation**: 注解定义模块\n- **privacy-proxy**: 预置的敏感 API 拦截实现\n- **privacy-replace**: 类替换功能 (已废弃,不再维护)\n- **privacy-test**: 测试模块\n\n## 版本兼容性\n\n- **当前版本 (1.3.7_v820_beta4)**: 支持 AGP 8.0+\n- **旧版本 (1.3.6)**: 支持 AGP 8.0 以下版本\n- **最低 Android SDK**: minSdkVersion 19\n- **编译 SDK**: compileSdkVersion 34\n- **Kotlin**: 1.8.10\n\n## 关键配置\n\n### privacy 插件配置 (在 app/build.gradle 中)\n```gradle\nprivacy {\n // 黑名单包名,不会被字节码修改\n blackList = []\n\n // 插件功能总开关\n enablePrivacy = true\n\n // 是否 hook 反射方法\n hookReflex = false\n\n // 反射拦截配置 (如小米 OAID)\n reflexMap = [\"com.android.id.impl.IdProviderImpl\":[\"getOAID\",\"getAAID\",\"getVAID\"]]\n\n // 已废弃的功能开关\n hookConstructor = false\n hookField = false\n}\n```\n\n### SDK 初始化示例\n```kotlin\nval builder = PrivacySentryBuilder()\n .configResultFileName(\"privacy_result\")\n .syncDebug(true) // 开启 logcat 输出\n .enableFileResult(true) // 开启文件输出\n .configWatchTime(30 * 60 * 1000) // 持续监控 30 分钟\n\nPrivacySentry.Privacy.init(application, builder)\n\n// 用户同意隐私协议后必须调用\nPrivacySentry.Privacy.updatePrivacyShow()\n```\n\n## 添加自定义拦截\n\n1. 创建包含 `@PrivacyClassProxy` 注解的类\n2. 在静态方法上添加 `@PrivacyMethodProxy` 注解:\n```kotlin\n@PrivacyClassProxy\nobject CustomProxy {\n @PrivacyMethodProxy(\n originalClass = TargetClass::class,\n originalMethod = \"methodName\",\n originalOpcode = MethodInvokeOpcode.INVOKEVIRTUAL\n )\n @JvmStatic\n fun proxyMethod(instance: TargetClass, param: String): ReturnType {\n doFilePrinter(\"methodName\", \"方法说明\")\n // 自定义逻辑\n return instance.methodName(param)\n }\n}\n```\n\n## 注意事项\n\n1. **黑名单配置**: 如引入高德地图或 OpenInstall,需添加到黑名单避免 ASM 版本冲突:\n ```gradle\n blackList = [\"com.loc\", \"com.amap.api\", \"io.openinstall.sdk\"]\n ```\n\n2. **线上环境**: 务必关闭 `enableFileResult`,避免隐私数据泄露\n\n3. **初始化时机**: 尽可能在 `Application.attachBaseContext()` 中第一个调用\n\n4. **动态加载**: 热修复、插件化加载的代码无法被拦截\n\n5. **支持的敏感 API**: 包括 IMEI、MAC、Android ID、位置信息、剪贴板、传感器、应用列表等,详见 README.md\n\n## 调试技巧\n\n- 查看生成的 hook 配置: `privacy_hook.json`\n- 日志 TAG: `PrivacyOfficer`\n- 输出文件路径: `/storage/emulated/0/Android/data/{packageName}/files/privacy/`\n- 拉取文件: `adb pull /storage/emulated/0/Android/data/{packageName}/files/privacy/`\n" }, { "path": "LICENSE", "content": "MIT License\n\nCopyright (c) 2022 alleny\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n" }, { "path": "README.md", "content": "# PrivacySentry\n\n[![](https://jitpack.io/v/allenymt/PrivacySentry.svg)](https://jitpack.io/#allenymt/PrivacySentry)\n[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![API](https://img.shields.io/badge/API-19%2B-brightgreen.svg?style=flat)](https://android-arsenal.com/api?level=19)\n\n> Android 隐私合规检测工具，可规避应用市场上架合规检测的大部分问题\n\n## ✨ 核心特性\n\n- ✅ **编译期字节码插桩**：基于 ASM + Booster 框架，零运行时性能损耗\n- 🎯 **完整的拦截方案**：支持 60+ 敏感 API 拦截，覆盖工信部合规要求\n- 📊 **自动化检测报告**：生成 Excel 格式的详细调用记录和统计分析\n- 🔄 **智能缓存机制**：内存/磁盘多级缓存，优化性能\n- 🌐 **多进程支持**：自动处理多进程场景，独立输出日志\n- 🔧 **灵活可扩展**：支持自定义拦截规则，黑名单配置\n\n## 📚 文档导航\n\n- **[快速开始](#快速开始)** - 5 分钟集成使用\n- **[插件配置详解](#插件配置详解)** - 完整配置说明\n- **[SDK 初始化](#sdk-初始化)** - 运行时配置\n- **[自定义拦截](#自定义拦截)** - 扩展拦截规则\n- **[架构文档](./docs/architecture.md)** - 完整技术架构解析\n- **[开发指南](./CLAUDE.md)** - Claude Code 开发指南\n\n## 📱 社区支持\n\n加作者个人微信，备注来意 PrivacySentry，进社区群\n\n\"image\"\n\n## 🚀 快速开始\n\n### 版本要求\n\n| 组件 | 版本要求 |\n|------|---------|\n| **AGP** | 8.0+ (推荐 8.2.0) |\n| **Gradle** | 8.0+ |\n| **Kotlin** | 1.8.10+ |\n| **minSdk** | 19+ |\n| **compileSdk** | 34+ |\n\n> **注意**：AGP 8.0 以下版本请使用 `1.3.6` 版本\n\n### Step 1: 添加插件依赖\n\n在项目根目录的 `build.gradle` 中添加：\n\n```gradle\nbuildscript {\n repositories {\n maven { url 'https://jitpack.io' }\n mavenCentral()\n google()\n }\n\n dependencies {\n classpath 'com.github.allenymt.PrivacySentry:plugin-sentry:1.3.7_v820_beta4'\n }\n}\n\nallprojects {\n repositories {\n maven { url 'https://jitpack.io' }\n mavenCentral()\n google()\n }\n}\n```\n\n### Step 2: 应用插件和依赖\n\n在 app 模块的 `build.gradle` 中：\n\n```gradle\n// 应用插件\napply plugin: 'privacy-sentry-plugin'\n\ndependencies {\n def privacyVersion = \"1.3.7_v820_beta4\"\n\n // 核心库（必须）\n implementation \"com.github.allenymt.PrivacySentry:hook-sentry:$privacyVersion\"\n implementation \"com.github.allenymt.PrivacySentry:privacy-annotation:$privacyVersion\"\n\n // 预置拦截实现（强烈推荐）\n implementation \"com.github.allenymt.PrivacySentry:privacy-proxy:$privacyVersion\"\n\n // 类替换功能（已废弃，不推荐使用）\n // implementation \"com.github.allenymt.PrivacySentry:privacy-replace:$privacyVersion\"\n}\n```\n\n### Step 3: 插件配置\n\n在 app 模块的 `build.gradle` 中添加 `privacy` 配置块：\n\n```gradle\nprivacy {\n // ========== 核心配置 ==========\n\n /**\n * 插件功能总开关\n * 类型：Boolean\n * 默认值：true\n * 说明：控制 PrivacySentry 插件是否生效\n * - true: 启用插件，执行字节码转换\n * - false: 禁用插件，相当于未集成\n */\n enablePrivacy = true\n\n /**\n * 黑名单配置\n * 类型：Set\n * 默认值：null (空列表)\n * 说明：指定不进行字节码修改的包名列表\n * - 适用场景：\n * 1. 使用了其他 ASM 字节码修改工具的三方库（如高德地图）\n * 2. 已知会导致冲突的 SDK\n * 3. 不需要监控的系统库或三方库\n * - 注意：blackList 中的包不会被插件修改，也无法拦截其中的敏感 API\n */\n blackList = []\n\n // 常见黑名单配置示例：\n // blackList = [\n // \"com.loc\", // 高德地图（ASM 版本冲突）\n // \"com.amap.api\", // 高德地图 API\n // \"io.openinstall.sdk\", // OpenInstall SDK\n // \"com.google.android\", // Google 服务（可选）\n // \"androidx\" // AndroidX 库（可选）\n // ]\n\n /**\n * 静态扫描结果文件名\n * 类型：String\n * 默认值：\"privacy_hook.json\"\n * 说明：记录所有被代理的方法名和类名的文件名\n * - 文件位置：项目根目录\n * - 文件格式：JSON\n * - 内容包含：\n * 1. hookServiceList: 被 hook 的 Service 列表\n * 2. replaceMethodMap: 被替换的方法映射表\n * - 设置为 null 或空字符串则不生成文件\n */\n replaceFileName = \"privacy_hook.json\"\n\n // ========== 反射 Hook 配置（可选）==========\n\n /**\n * 反射方法 Hook 开关\n * 类型：Boolean\n * 默认值：false\n * 说明：是否拦截通过反射调用的敏感方法\n * - true: 拦截反射调用（需配合 reflexMap 使用）\n * - false: 不拦截反射调用\n * - 适用场景：\n * 1. 三方 SDK 通过反射获取设备信息（如小米 OAID）\n * 2. 极光推送、个推、穿山甲等 SDK 的设备标识获取\n * - 性能影响：轻微（仅影响 LDC 指令的匹配）\n */\n hookReflex = false\n\n /**\n * 反射拦截配置映射\n * 类型：Map>\n * 默认值：null\n * 说明：配置需要拦截的反射调用\n * - Key: 类的全限定名\n * - Value: 该类中需要拦截的方法名列表\n * - 只有 hookReflex = true 时才生效\n * - 匹配原理：检测字节码中的 LDC 指令加载的字符串常量\n */\n reflexMap = [:]\n\n // 反射拦截配置示例：\n // reflexMap = [\n // // 小米设备标识服务\n // \"com.android.id.impl.IdProviderImpl\": [\n // \"getOAID\", // 开放匿名设备标识符\n // \"getAAID\", // 应用匿名设备标识符\n // \"getVAID\" // 开发者匿名设备标识符\n // ],\n // // 自定义类的反射方法\n // \"com.example.utils.DeviceUtils\": [\n // \"getDeviceId\",\n // \"getIMEI\"\n // ]\n // ]\n\n // ========== 已废弃功能（不推荐使用，仅供参考）==========\n\n /**\n * 字段 Hook 开关（已废弃）\n * 类型：Boolean\n * 默认值：false\n * 废弃原因：几乎没有业务场景，功能不稳定\n * 说明：是否 hook 字段访问（如 Build.SERIAL）\n * - 不推荐使用，请使用方法 hook 代替\n */\n // hookField = false\n\n /**\n * 构造函数 Hook 开关（已废弃）\n * 类型：Boolean\n * 默认值：false\n * 废弃原因：实现复杂，稳定性差，已停止维护\n * 说明：是否 hook 构造函数（主要用于拦截 File 构造函数参数）\n * - 相关模块：privacy-replace\n * - 不推荐使用\n */\n // hookConstructor = false\n\n /**\n * Manifest 处理开关（已废弃）\n * 类型：Boolean\n * 默认值：false\n * 废弃原因：功能边界不清晰，已停止维护\n * 说明：是否处理 AndroidManifest.xml 文件\n * - 主要用于处理 Service 的 Priority 和 Export\n * - 不推荐使用\n */\n // enableProcessManifest = false\n\n /**\n * Service Priority 替换开关（已废弃）\n * 类型：Boolean\n * 默认值：false\n * 废弃原因：针对 MIUI 自启动问题的特殊方案，已停止维护\n * 说明：是否替换 Service 的 Priority 值\n * - 部分 Service 设置 Priority = 1000 导致自启动\n * - 开启后会将 Priority 替换为 replacePriority 的值\n * - 不推荐使用\n */\n // enableReplacePriority = false\n\n /**\n * Service Priority 替换值（已废弃）\n * 类型：Int\n * 默认值：0\n * 说明：替换后的 Priority 值\n * - 配合 enableReplacePriority 使用\n * - 不推荐使用\n */\n // replacePriority = 0\n\n /**\n * Service Export 关闭开关（已废弃）\n * 类型：Boolean\n * 默认值：false\n * 废弃原因：可能影响厂商推送功能，已停止维护\n * 说明：是否关闭 Service 的 Export 功能\n * - 注意：部分厂商推送（小米、VIVO、华为）的 PushService 不能关闭\n * - 配合 serviceExportPkgWhiteList 使用\n * - 不推荐使用\n */\n // enableCloseServiceExport = false\n\n /**\n * Service Export 白名单（已废弃）\n * 类型：Set\n * 默认值：null\n * 说明：允许保持 Export 的 Service 包名列表\n * - 配合 enableCloseServiceExport 使用\n * - 不推荐使用\n */\n // serviceExportPkgWhiteList = []\n\n /**\n * Service StartCommand Hook 开关（已废弃）\n * 类型：Boolean\n * 默认值：false\n * 废弃原因：针对 MIUI 自启动问题的特殊方案，已停止维护\n * 说明：是否 hook Service 的 startCommand 方法\n * - 不推荐使用\n */\n // enableHookServiceStartCommand = false\n}\n```\n\n**配置优先级说明**：\n1. **必须配置**：`enablePrivacy`（总开关）\n2. **强烈推荐**：`blackList`（避免冲突）\n3. **按需配置**：`hookReflex` + `reflexMap`（反射拦截）\n4. **可选配置**：`replaceFileName`（静态扫描文件）\n5. **不推荐使用**：所有标记为 `@Deprecated` 的配置项\n\n### Step 4: SDK 初始化\n\n在 `Application` 中初始化 SDK：\n\n**Kotlin 示例**:\n\n```kotlin\nclass MyApplication : Application() {\n\n override fun attachBaseContext(base: Context?) {\n super.attachBaseContext(base)\n\n // ⚠️ 重要：尽可能在 attachBaseContext 中第一个调用\n // 这样可以确保捕获所有敏感 API 调用\n initPrivacySentry()\n }\n\n override fun onCreate() {\n super.onCreate()\n\n // 展示隐私协议弹窗\n showPrivacyDialog {\n // 用户同意后，必须调用此方法\n PrivacySentry.Privacy.updatePrivacyShow()\n }\n }\n\n private fun initPrivacySentry() {\n val builder = PrivacySentryBuilder()\n // 自定义输出文件名\n .configResultFileName(\"privacy_result\")\n\n // 开启 debug 模式（可在 logcat 查看日志）\n .syncDebug(BuildConfig.DEBUG)\n\n // 开启文件输出（⚠️ 线上版本请关闭）\n .enableFileResult(BuildConfig.DEBUG)\n\n // 监控时长（30 分钟）\n .configWatchTime(30 * 60 * 1000)\n\n // 文件输出完成回调\n .configResultCallBack(object : PrivacyResultCallBack {\n override fun onResultCallBack(filePath: String) {\n Log.i(\"PrivacySentry\", \"结果文件：$filePath\")\n }\n })\n\n PrivacySentry.Privacy.init(this, builder)\n }\n}\n```\n\n**Java 示例**:\n\n```java\npublic class MyApplication extends Application {\n\n @Override\n protected void attachBaseContext(Context base) {\n super.attachBaseContext(base);\n\n // ⚠️ 重要：尽可能在 attachBaseContext 中第一个调用\n initPrivacySentry();\n }\n\n @Override\n public void onCreate() {\n super.onCreate();\n\n // 展示隐私协议弹窗\n showPrivacyDialog(() -> {\n // 用户同意后，必须调用此方法\n PrivacySentry.Privacy.INSTANCE.updatePrivacyShow();\n });\n }\n\n private void initPrivacySentry() {\n PrivacySentryBuilder builder = new PrivacySentryBuilder()\n .configResultFileName(\"privacy_result\")\n .syncDebug(BuildConfig.DEBUG)\n .enableFileResult(BuildConfig.DEBUG)\n .configWatchTime(30 * 60 * 1000)\n .configResultCallBack(new PrivacyResultCallBack() {\n @Override\n public void onResultCallBack(@NonNull String filePath) {\n Log.i(\"PrivacySentry\", \"结果文件：\" + filePath);\n }\n });\n\n PrivacySentry.Privacy.INSTANCE.init(this, builder);\n }\n}\n```\n\n### Step 5: 查看检测结果\n\n#### 方式 1：Logcat 日志\n\n```bash\n# 实时查看日志\nadb logcat | grep \"PrivacyOfficer\"\n```\n\n#### 方式 2：Excel 文件\n\n```bash\n# 拉取结果文件\nadb pull /storage/emulated/0/Android/data/{your.package.name}/files/privacy/\n\n# 文件名格式\n# 主进程：privacy_result.xls\n# 子进程：{进程名}_privacy_result.xls\n```\n\n**Excel 文件包含两个 Sheet**:\n\n1. **Sheet 1 - 隐私合规明细**：按时间倒序记录所有敏感 API 调用\n - 调用时间\n - 方法别名\n - 函数名\n - 完整调用堆栈\n\n2. **Sheet 2 - 调用次数统计**：按堆栈聚合统计调用次数\n - 方法别名\n - 函数名\n - 调用堆栈\n - 调用次数\n\n## ⚙️ 插件配置详解\n\n### 核心配置项完整说明\n\n| 配置项 | 类型 | 默认值 | 说明 |\n|--------|------|--------|------|\n| `enablePrivacy` | Boolean | `true` | **插件功能总开关**
- `true`: 启用插件，执行字节码转换
- `false`: 禁用插件 |\n| `blackList` | Set\\ | `null` | **黑名单配置**
指定不进行字节码修改的包名列表
- 适用场景：ASM 冲突的三方库
- 注意：黑名单中的包无法拦截敏感 API |\n| `replaceFileName` | String | `\"privacy_hook.json\"` | **静态扫描结果文件名**
记录所有被代理的方法和类
- 文件位置：项目根目录
- 文件格式：JSON
- 设置为 `null` 则不生成 |\n| `hookReflex` | Boolean | `false` | **反射方法 Hook 开关**
是否拦截通过反射调用的敏感方法
- 需配合 `reflexMap` 使用
- 适用：三方 SDK 反射获取设备信息 |\n| `reflexMap` | Map\\\\> | `null` | **反射拦截配置**
- Key: 类的全限定名
- Value: 需要拦截的方法名列表
- 只有 `hookReflex=true` 时生效 |\n\n### 已废弃配置项\n\n| 配置项 | 类型 | 默认值 | 废弃原因 |\n|--------|------|--------|---------|\n| `hookField` | Boolean | `false` | 几乎没有业务场景，功能不稳定 |\n| `hookConstructor` | Boolean | `false` | 实现复杂，稳定性差，已停止维护 |\n| `enableProcessManifest` | Boolean | `false` | 功能边界不清晰，已停止维护 |\n| `enableReplacePriority` | Boolean | `false` | 针对 MIUI 特殊问题，已停止维护 |\n| `replacePriority` | Int | `0` | 配合 `enableReplacePriority` 使用 |\n| `enableCloseServiceExport` | Boolean | `false` | 可能影响厂商推送，已停止维护 |\n| `serviceExportPkgWhiteList` | Set\\ | `null` | 配合 `enableCloseServiceExport` 使用 |\n| `enableHookServiceStartCommand` | Boolean | `false` | 针对 MIUI 特殊问题，已停止维护 |\n\n> ⚠️ **重要提示**：所有标记为\"已废弃\"的配置项均不推荐使用，可能在未来版本中移除。\n\n### 黑名单配置说明\n\n#### 什么情况需要配置黑名单？\n\n1. **ASM 版本冲突**\n - 使用高德地图 SDK（ASM 9.1 vs 其他版本）\n - 使用其他字节码修改工具的三方库\n\n2. **已知冲突的 SDK**\n - OpenInstall SDK\n - 部分混淆工具\n\n3. **不需要监控的库**\n - 系统库（可选）\n - 不涉及隐私的三方库\n\n#### 黑名单工作原理\n\n- 插件在 Transform 阶段会跳过黑名单中的包\n- 黑名单采用**前缀匹配**规则\n- 例如：`\"com.loc\"` 会匹配 `com.loc.*` 下的所有类\n\n#### 配置示例\n\n```gradle\nprivacy {\n blackList = [\n // 高德地图（ASM 版本冲突）\n \"com.loc\",\n \"com.amap.api\",\n\n // OpenInstall SDK\n \"io.openinstall.sdk\",\n\n // Google 服务（可选）\n \"com.google.android\",\n\n // AndroidX 库（可选）\n \"androidx\",\n\n // 自定义不需要监控的包\n \"com.example.thirdparty\"\n ]\n}\n```\n\n#### 黑名单注意事项\n\n- ✅ **推荐**：只添加确实冲突的包\n- ❌ **不推荐**：盲目添加大量包到黑名单\n- ⚠️ **影响**：黑名单中的包无法拦截敏感 API 调用\n\n### 反射 Hook 配置详解\n\n#### 使用场景\n\n反射 Hook 用于拦截通过**反射方式**调用的敏感方法，常见场景：\n\n1. **设备标识获取**\n - 小米设备 OAID/AAID/VAID\n - 华为设备标识\n - OPPO/VIVO 设备标识\n\n2. **三方 SDK**\n - 极光推送（JPush）\n - 个推（GeTui）\n - 穿山甲广告 SDK\n - 友盟统计\n\n3. **自定义反射调用**\n - 项目中通过反射获取的敏感信息\n\n#### 工作原理\n\n```kotlin\n// 原始代码（反射调用）\nClass.forName(\"com.android.id.impl.IdProviderImpl\")\n .getMethod(\"getOAID\")\n .invoke(obj)\n\n// 字节码层面\nLDC \"com.android.id.impl.IdProviderImpl\" // ← hookReflex 检测这里\nLDC \"getOAID\" // ← reflexMap 匹配方法名\nINVOKEVIRTUAL Method.invoke() // ← 替换为代理方法\n```\n\n#### 配置示例\n\n**场景 1：小米设备标识**\n\n```gradle\nprivacy {\n hookReflex = true\n\n reflexMap = [\n \"com.android.id.impl.IdProviderImpl\": [\n \"getOAID\", // 开放匿名设备标识符\n \"getAAID\", // 应用匿名设备标识符\n \"getVAID\" // 开发者匿名设备标识符\n ]\n ]\n}\n```\n\n**场景 2：多个 SDK 配置**\n\n```gradle\nprivacy {\n hookReflex = true\n\n reflexMap = [\n // 小米设备标识\n \"com.android.id.impl.IdProviderImpl\": [\n \"getOAID\", \"getAAID\", \"getVAID\"\n ],\n\n // 华为设备标识\n \"com.huawei.hms.ads.identifier.AdvertisingIdClient\": [\n \"getAdvertisingIdInfo\"\n ],\n\n // 自定义工具类\n \"com.example.utils.DeviceUtils\": [\n \"getDeviceId\",\n \"getIMEI\",\n \"getAndroidId\"\n ]\n ]\n}\n```\n\n**场景 3：极光推送/个推配置**\n\n```gradle\nprivacy {\n hookReflex = true\n\n reflexMap = [\n // 极光推送反射获取设备信息\n \"cn.jpush.android.api.JCoreInterface\": [\n \"getDeviceId\",\n \"getRegistrationID\"\n ],\n\n // 个推反射获取设备信息\n \"com.igexin.sdk.PushManager\": [\n \"getClientid\"\n ]\n ]\n}\n```\n\n#### 反射 Hook 注意事项\n\n- ✅ **精确匹配**：类名和方法名必须完全匹配\n- ✅ **性能影响**：轻微（仅影响 LDC 指令匹配）\n- ⚠️ **必须启用**：`hookReflex = true` 才生效\n- ⚠️ **无法拦截**：动态生成的类名或方法名\n\n### 静态扫描文件说明\n\n#### replaceFileName 配置\n\n```gradle\nprivacy {\n // 生成静态扫描文件\n replaceFileName = \"privacy_hook.json\"\n\n // 不生成文件\n // replaceFileName = null\n}\n```\n\n#### 文件内容示例\n\n**文件位置**：项目根目录 `/privacy_hook.json`\n\n```json\n{\n \"hookServiceList\": [\n \"com.example.TestService\",\n \"com.example.BackgroundService\"\n ],\n\n \"replaceMethodMap\": {\n \"android.app.ActivityManager.getRunningTasks\": {\n \"count\": 5,\n \"originMethodList\": [\n {\n \"originClassName\": \"com.example.MainActivity\",\n \"originMethodName\": \"checkRunningTasks\"\n },\n {\n \"originClassName\": \"com.example.utils.AppUtils\",\n \"originMethodName\": \"getRunningApps\"\n }\n ]\n },\n \"android.telephony.TelephonyManager.getDeviceId\": {\n \"count\": 2,\n \"originMethodList\": [\n {\n \"originClassName\": \"com.example.DeviceManager\",\n \"originMethodName\": \"getIMEI\"\n }\n ]\n }\n }\n}\n```\n\n#### 文件用途\n\n1. **静态分析**：离线分析敏感 API 调用情况\n2. **合规检查**：提供给安全团队审查\n3. **调试参考**：确认插件是否正确拦截了目标方法\n4. **版本对比**：对比不同版本的 API 调用变化\n\n### 配置优先级建议\n\n| 优先级 | 配置项 | 建议值 | 说明 |\n|--------|--------|--------|------|\n| ⭐⭐⭐ 必须 | `enablePrivacy` | `true` | 插件总开关 |\n| ⭐⭐⭐ 强烈推荐 | `blackList` | 根据实际情况 | 避免 ASM 冲突 |\n| ⭐⭐ 推荐 | `replaceFileName` | `\"privacy_hook.json\"` | 生成静态扫描文件 |\n| ⭐ 按需配置 | `hookReflex` | `false` 或 `true` | 根据是否有反射调用 |\n| ⭐ 按需配置 | `reflexMap` | `[:]` 或配置 | 配合 hookReflex 使用 |\n| ❌ 不推荐 | 所有废弃配置 | - | 已停止维护 |\n\n## 🔧 SDK 初始化\n\n### PrivacySentryBuilder 配置项\n\n| 方法 | 参数类型 | 默认值 | 说明 |\n|------|---------|--------|------|\n| `configResultFileName(String)` | String | 自动生成 | 自定义输出文件名 |\n| `syncDebug(Boolean)` | Boolean | `false` | 开启 debug 日志 |\n| `enableFileResult(Boolean)` | Boolean | `true` | 是否输出到文件 |\n| `configWatchTime(Long)` | Long (毫秒) | 180000 (3分钟) | 监控时长 |\n| `configResultCallBack(PrivacyResultCallBack)` | PrivacyResultCallBack | `null` | 文件输出完成回调 |\n| `enableReadClipBoard(Boolean)` | Boolean | `true` | 是否允许读取剪贴板 |\n\n### 最佳实践\n\n#### 1. 初始化时机\n\n```kotlin\nclass MyApplication : Application() {\n override fun attachBaseContext(base: Context?) {\n super.attachBaseContext(base)\n\n // ✅ 推荐：第一个调用\n PrivacySentry.Privacy.init(this, builder)\n\n // ❌ 不推荐：在其他初始化之后\n // MultiDex.install(this)\n // PrivacySentry.Privacy.init(this, builder)\n }\n}\n```\n\n**原因**：attachBaseContext 之后才能通过反射获取 ActivityThread 的 application，如果初始化太晚，可能无法捕获早期的敏感 API 调用。\n\n#### 2. Debug vs Release 配置\n\n```kotlin\nprivate fun initPrivacySentry() {\n val builder = PrivacySentryBuilder()\n .syncDebug(BuildConfig.DEBUG) // Debug 开启日志\n .enableFileResult(BuildConfig.DEBUG) // Release 关闭文件输出\n .configWatchTime(\n if (BuildConfig.DEBUG) 30 * 60 * 1000 // Debug: 30分钟\n else 3 * 60 * 1000 // Release: 3分钟（谨慎）\n )\n\n PrivacySentry.Privacy.init(this, builder)\n}\n```\n\n#### 3. 隐私协议状态管理\n\n```kotlin\noverride fun onCreate() {\n super.onCreate()\n\n // 检查是否已同意隐私协议\n if (!hasAgreedPrivacyPolicy()) {\n showPrivacyDialog {\n // 用户同意后保存状态\n savePrivacyAgreement()\n\n // ⚠️ 必须调用，告知 SDK 用户已同意\n PrivacySentry.Privacy.updatePrivacyShow()\n }\n } else {\n // 已同意，直接告知 SDK\n PrivacySentry.Privacy.updatePrivacyShow()\n }\n}\n```\n\n**重要提示**：\n- ✅ 用户同意隐私协议后，**必须**调用 `updatePrivacyShow()`\n- ✅ 调用前的敏感 API 会返回空数据并标记 `check!!!`\n- ✅ 调用后的敏感 API 返回真实数据并记录日志\n\n#### 4. 手动停止监控\n\n```kotlin\n// 手动停止监控和文件写入\nPrivacySentry.Privacy.stop()\n```\n\n## 🎯 自定义拦截\n\n### 创建自定义代理类\n\n```kotlin\nimport androidx.annotation.Keep\nimport com.yl.lib.privacy_annotation.MethodInvokeOpcode\nimport com.yl.lib.privacy_annotation.PrivacyClassProxy\nimport com.yl.lib.privacy_annotation.PrivacyMethodProxy\nimport com.yl.lib.sentry.hook.PrivacySentry\nimport com.yl.lib.sentry.hook.util.PrivacyProxyUtil.Util.doFilePrinter\n\n@Keep\n@PrivacyClassProxy\nobject MyCustomProxy {\n\n /**\n * 示例 1：拦截实例方法\n */\n @PrivacyMethodProxy(\n originalClass = YourClass::class,\n originalMethod = \"getSensitiveData\",\n originalOpcode = MethodInvokeOpcode.INVOKEVIRTUAL\n )\n @JvmStatic\n fun getSensitiveData(\n instance: YourClass, // 第一个参数是实例对象\n param1: String\n ): String {\n // 记录日志\n doFilePrinter(\"getSensitiveData\", \"获取敏感数据: $param1\")\n\n // 检查隐私协议状态\n if (PrivacySentry.Privacy.inDangerousState()) {\n return \"\" // 未同意返回空\n }\n\n // 调用原始方法\n return instance.getSensitiveData(param1)\n }\n\n /**\n * 示例 2：拦截静态方法\n */\n @PrivacyMethodProxy(\n originalClass = YourUtilClass::class,\n originalMethod = \"getDeviceId\",\n originalOpcode = MethodInvokeOpcode.INVOKESTATIC\n )\n @JvmStatic\n fun getDeviceId(): String {\n doFilePrinter(\"getDeviceId\", \"获取设备ID\")\n\n if (PrivacySentry.Privacy.inDangerousState()) {\n return \"\"\n }\n\n return YourUtilClass.getDeviceId()\n }\n\n /**\n * 示例 3：拦截接口方法\n */\n @PrivacyMethodProxy(\n originalClass = YourInterface::class,\n originalMethod = \"getData\",\n originalOpcode = MethodInvokeOpcode.INVOKEINTERFACE\n )\n @JvmStatic\n fun getData(instance: YourInterface): String {\n doFilePrinter(\"getData\", \"接口方法调用\")\n return instance.getData()\n }\n}\n```\n\n### Java 自定义代理示例\n\n```java\nimport androidx.annotation.Keep;\nimport com.yl.lib.privacy_annotation.MethodInvokeOpcode;\nimport com.yl.lib.privacy_annotation.PrivacyClassProxy;\nimport com.yl.lib.privacy_annotation.PrivacyMethodProxy;\nimport com.yl.lib.sentry.hook.PrivacySentry;\nimport static com.yl.lib.sentry.hook.util.PrivacyProxyUtil.Util.doFilePrinter;\n\n@Keep\n@PrivacyClassProxy\npublic class MyCustomProxyJava {\n\n @PrivacyMethodProxy(\n originalClass = YourClass.class,\n originalMethod = \"getSensitiveData\",\n originalOpcode = MethodInvokeOpcode.INVOKEVIRTUAL\n )\n public static String getSensitiveData(YourClass instance, String param) {\n doFilePrinter(\"getSensitiveData\", \"获取敏感数据: \" + param, false);\n\n if (PrivacySentry.Privacy.INSTANCE.inDangerousState()) {\n return \"\";\n }\n\n return instance.getSensitiveData(param);\n }\n}\n```\n\n### 方法签名规则\n\n#### 实例方法 (INVOKEVIRTUAL)\n\n```kotlin\n// 原始方法\nclass TargetClass {\n fun method(param1: String, param2: Int): String\n}\n\n// 代理方法：第一个参数是实例对象\n@JvmStatic\nfun method(\n instance: TargetClass, // ⬅️ 额外的第一个参数\n param1: String,\n param2: Int\n): String\n```\n\n#### 静态方法 (INVOKESTATIC)\n\n```kotlin\n// 原始方法\nobject TargetClass {\n fun method(param1: String): String\n}\n\n// 代理方法：参数完全相同\n@JvmStatic\nfun method(param1: String): String\n```\n\n#### 接口方法 (INVOKEINTERFACE)\n\n```kotlin\n// 原始接口\ninterface TargetInterface {\n fun method(param: String): String\n}\n\n// 代理方法：第一个参数是接口实例\n@JvmStatic\nfun method(\n instance: TargetInterface, // ⬅️ 接口实例\n param: String\n): String\n```\n\n## 📋 支持的敏感 API\n\n### 设备标识\n\n- ✅ IMEI / DeviceId (`TelephonyManager.getDeviceId()`)\n- ✅ IMSI (`TelephonyManager.getSubscriberId()`)\n- ✅ MEID (`TelephonyManager.getMeid()`)\n- ✅ Android ID (`Settings.Secure.getAndroidId()`)\n- ✅ Serial (`Build.getSerial()`, `Build.SERIAL`)\n- ✅ MAC 地址 (`WifiInfo.getMacAddress()`)\n- ✅ ICCID (`TelephonyManager.getSimSerialNumber()`)\n\n### 网络信息\n\n- ✅ WiFi 信息 (`WifiManager.getConnectionInfo()`)\n- ✅ WiFi 扫描结果 (`WifiManager.getScanResults()`)\n- ✅ IP 地址 (`NetworkInterface`, `WifiInfo.getIpAddress()`)\n- ✅ DHCP 信息 (`WifiManager.getDhcpInfo()`)\n\n### 位置信息\n\n- ✅ GPS 定位 (`LocationManager.getLastKnownLocation()`)\n- ✅ 基站信息 (`TelephonyManager.getAllCellInfo()`)\n- ✅ 位置监听 (`LocationManager.requestLocationUpdates()`)\n\n### 应用信息\n\n- ✅ 已安装应用列表 (`PackageManager.getInstalledPackages()`)\n- ✅ 运行中任务 (`ActivityManager.getRunningTasks()`)\n- ✅ 运行中进程 (`ActivityManager.getRunningAppProcesses()`)\n- ✅ 最近任务 (`ActivityManager.getRecentTasks()`)\n\n### 联系人和日历\n\n- ✅ 联系人查询 (`ContentResolver.query()`)\n- ✅ 联系人插入 (`ContentResolver.insert()`)\n- ✅ 日历事件 (Calendar Provider)\n\n### 传感器\n\n- ✅ 传感器列表 (`SensorManager.getSensorList()`)\n- ✅ 传感器注册 (`SensorManager.registerListener()`)\n\n### 其他\n\n- ✅ 剪贴板 (`ClipboardManager.getPrimaryClip()`)\n- ✅ 蓝牙 (`BluetoothAdapter.getAddress()`)\n- ✅ 权限请求 (`requestPermissions()`)\n- ✅ SIM 卡信息 (`TelephonyManager.getSimOperator()`)\n\n> 完整列表请参考 [privacy-proxy](./privacy-proxy) 模块\n\n## 🔍 检测结果说明\n\n### 日志格式\n\n```\n[PrivacyOfficer] getDeviceId-线程名: main | 读取IMEI | com.example.MainActivity.onCreate(MainActivity.kt:42)\n ↑ 调用堆栈\n```\n\n### 危险状态标记\n\n如果在日志中看到 `check!!!` 标记：\n\n```\ncheck!!! 还未展示隐私协议，Illegal print\n```\n\n**说明**：此时还未同意隐私协议，调用了敏感 API\n\n**解决方法**：\n1. 检查是否在隐私协议同意后调用了 `updatePrivacyShow()`\n2. 优化代码，避免在隐私协议同意前调用敏感 API\n\n## 🛠️ 常见问题\n\n### Q1: 为什么某些 API 没有被拦截？\n\n**可能原因**：\n1. 该 API 未在 privacy-proxy 中实现\n2. 包名在黑名单中\n3. 使用动态加载的代码（热修复、插件化）\n\n**解决方法**：\n1. 查看 `privacy_hook.json` 确认是否包含该 API\n2. 检查黑名单配置\n3. 自定义拦截规则\n\n### Q2: 编译失败或运行时崩溃\n\n**可能原因**：\n1. ASM 版本冲突（特别是高德地图）\n2. AGP 版本不兼容\n\n**解决方法**：\n1. 添加冲突库到黑名单\n2. 升级到 AGP 8.0+\n3. 检查 Gradle 和 Kotlin 版本\n\n### Q3: 如何在线上环境使用？\n\n**建议配置**：\n\n```kotlin\nPrivacySentryBuilder()\n .syncDebug(false) // 关闭 debug 日志\n .enableFileResult(false) // 关闭文件输出\n .configWatchTime(3 * 60 * 1000) // 缩短监控时间\n```\n\n**注意**：\n- ❌ 线上版本**不要**开启 `enableFileResult`，避免隐私数据泄露\n- ✅ 可以通过 `configResultCallBack` 上报统计数据\n\n### Q4: 多进程如何处理？\n\nSDK 自动支持多进程，会为不同进程生成独立的日志文件：\n\n```\n主进程：privacy_result.xls\n子进程：com.example.service_privacy_result.xls\n```\n\n### Q5: 性能影响如何？\n\n- **编译时间**：增加 < 2 秒\n- **APK 体积**：增加 ~200KB\n- **运行时性能**：零额外开销（字节码已修改）\n- **内存占用**：缓存数据占用，可通过 watchTime 控制\n\n## 📖 更新日志\n\n### 1.3.7_v820_beta4 (2025-05-18)\n- ✅ 支持 AGP 8.0+\n- ❌ 不兼容 AGP 8.0 以下版本（请使用 1.3.6）\n\n### 1.3.6 (2024-11-01)\n- 修复 `T.(args..):T` 函数 hook 失败的问题\n\n### 1.3.5 (2024-05-08)\n- 修复读取小米系统 OAID 反射代理失败的问题\n- 修复 SHA-256 digest error 问题\n\n### 1.3.4 (2023-09-18)\n- 修复内存缓存数据转换问题\n- 修复 `getSimState` 闪退问题\n\n### 1.3.3 (2023-08-22)\n- 重构 plugin 部分，引入 Booster\n- 适配 AGP 和 Gradle 高版本\n- 支持 AGP 7.0+\n\n> 完整更新日志请查看 [CHANGELOG](./CHANGELOG.md)\n\n## 🤝 贡献指南\n\n欢迎提交 Issue 和 Pull Request！\n\n- **Bug 报告**：请详细描述问题和复现步骤\n- **功能建议**：欢迎提出改进建议\n- **Pull Request**：请先创建 Issue 讨论\n\n## 📄 许可证\n\n本项目采用 [MIT License](LICENSE)\n\n## 💰 打赏支持\n\n如果这个项目对你有帮助，欢迎打赏支持！\n\n\"image\"\n\n\"image\"\n\n## 🌟 Star History\n\n如果觉得有用，请给个 Star ⭭！\n\n## 🔗 相关资源\n\n- **架构文档**：[docs/architecture.md](./docs/architecture.md)\n- **开发指南**：[CLAUDE.md](./CLAUDE.md)\n- **示例项目**：[app](./app)\n- **GitHub Issues**：[提交问题](https://github.com/allenymt/PrivacySentry/issues)\n\n---\n\n**注意事项**：\n\n1. ⚠️ 线上版本请关闭 `enableFileResult`\n2. ⚠️ 尽可能在 `attachBaseContext` 中第一个调用初始化\n3. ⚠️ 用户同意隐私协议后必须调用 `updatePrivacyShow()`\n4. ⚠️ 使用高德地图等三方库需配置黑名单\n5. ⚠️ 动态加载的代码无法被拦截\n\n---\n\n> 如有问题，请提 [Issue](https://github.com/allenymt/PrivacySentry/issues)\n>\n> 兄弟们，走过路过请给个 Star ⭭~~~\n" }, { "path": "app/.gitignore", "content": "/build" }, { "path": "app/build.gradle", "content": "apply plugin: 'com.android.application'\napply plugin: 'kotlin-android'\napply plugin: 'privacy-sentry-plugin'\n\nandroid {\n compileSdkVersion 34\n buildToolsVersion \"34.0.0\"\n namespace \"com.yl.lib.privacysentry\"\n defaultConfig {\n applicationId \"com.yl.lib.privacysentry\"\n minSdkVersion 19\n targetSdkVersion 34\n versionCode 1\n versionName \"1.0\"\n multiDexEnabled true\n testInstrumentationRunner \"androidx.test.runner.AndroidJUnitRunner\"\n }\n\n signingConfigs {\n release {\n storeFile file(\"../privacy\")\n storePassword \"123456\"\n keyAlias \"privacy\"\n keyPassword \"123456\"\n v2SigningEnabled true\n }\n }\n\n buildTypes {\n debug {\n debuggable true\n signingConfig signingConfigs.release //使用release签名\n }\n release {\n debuggable true\n jniDebuggable false\n shrinkResources false\n minifyEnabled true\n signingConfig signingConfigs.release //使用release签\n zipAlignEnabled true\n proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'\n }\n }\n compileOptions {\n sourceCompatibility JavaVersion.VERSION_1_8\n targetCompatibility JavaVersion.VERSION_1_8\n }\n kotlinOptions {\n jvmTarget = '1.8'\n }\n lintOptions {\n abortOnError false\n }\n\n}\n\ndependencies {\n api fileTree(dir: 'libs', include: ['*.jar'])\n\n implementation 'androidx.core:core-ktx:1.9.0'\n implementation 'androidx.appcompat:appcompat:1.6.1'\n implementation 'com.google.android.material:material:1.9.0'\n implementation 'androidx.constraintlayout:constraintlayout:2.1.4'\n implementation \"androidx.multidex:multidex:2.0.1\"\n implementation \"org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version\"\n implementation \"org.jetbrains.kotlin:kotlin-reflect:$kotlin_version\"\n\n if (rootProject.ext.build.local_debug) {\n implementation project(\":hook-sentry\")\n implementation project(\":privacy-proxy\")\n implementation project(\":privacy-replace\")\n implementation project(\":privacy-annotation\")\n } else {\n def privacyVersion = rootProject.ext.publish_config['version']\n implementation \"com.github.allenymt.PrivacySentry:hook-sentry:$privacyVersion\"\n implementation \"com.github.allenymt.PrivacySentry:privacy-annotation:$privacyVersion\"\n // 测试自定义拦截就注释掉\n implementation \"com.github.allenymt.PrivacySentry:privacy-proxy:$privacyVersion\"\n // 新增类替换，主要是为了hook构造函数的参数\n implementation \"com.github.allenymt.PrivacySentry:privacy-replace:$privacyVersion\"\n }\n implementation(project(path: ':privacy-test')) {\n exclude module: 'privacy-annotation'\n }\n implementation \"androidx.exifinterface:exifinterface:1.3.6\"\n implementation \"androidx.work:work-runtime-ktx:2.8.1\"\n implementation 'androidx.lifecycle:lifecycle-livedata-ktx:2.6.2'\n implementation 'androidx.lifecycle:lifecycle-viewmodel-ktx:2.6.2'\n implementation \"androidx.lifecycle:lifecycle-runtime-ktx:2.6.2\"\n implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3'\n // 测试SHA-256 digest error问题\n// api \"org.eclipse.paho:org.eclipse.paho.client.mqttv3:1.2.5\"\n testImplementation 'junit:junit:4.+'\n androidTestImplementation 'androidx.test.ext:junit:1.1.2'\n androidTestImplementation 'androidx.test.espresso:espresso-core:3.3.0'\n\n}\n\n\nprivacy {\n // 设置免hook的名单\n blackList = []\n // 开关PrivacySentry插件功能，核心功能开关，默认为true\n enablePrivacy = true\n\n // 开启hook反射的方法,默认为false,按需打开\n hookReflex = false\n // 配置反射拦截 反射获取小米系统的oaid、aaid、vaid,例如极光、个推、穿山甲等SDK都有获取\n reflexMap = [\"com.android.id.impl.IdProviderImpl\":[\"getOAID\",\"getAAID\",\"getVAID\"]]\n\n\n ///// *************后续不再维护，只保留hook方法的核心功能****************\n // 默认为false,按需打开\n hookConstructor = false\n // 默认为false,按需打开\n hookField = false\n\n\n //*************以下是分割线，主要是对Service的自启动优化处理,默认为false,按需打开****************\n // 处理Manifest文件，主要是处理Service的Priority ， 关闭Service的Export\n enableProcessManifest = false\n // hook Service的部分代码，修复在MIUI上的自启动问题\n // 部分Service把自己的Priority设置为1000，这里开启代理功能，可以代理成0\n enableReplacePriority = false\n replacePriority = 1\n\n // 支持关闭Service的Export功能，默认为false，注意部分厂商通道之类的push(xiaomi、vivo、huawei等厂商的pushService)，不能关闭\n enableCloseServiceExport = false\n // Export白名单Service\n serviceExportPkgWhiteList = [\"white\"]\n enableHookServiceStartCommand = false\n}\n\nproject.afterEvaluate {\n project.gradle.taskGraph.whenReady {\n println(\"=======> print allTasks\")\n println(project.gradle.taskGraph.allTasks)\n }\n}\n" }, { "path": "app/proguard-rules.pro", "content": "# Add project specific ProGuard rules here.\n# You can control the set of applied configuration files using the\n# proguardFiles setting in build.gradle.\n#\n# For more details, see\n# http://developer.android.com/guide/developing/tools/proguard.html\n\n# If your project uses WebView with JS, uncomment the following\n# and specify the fully qualified class name to the JavaScript interface\n# class:\n#-keepclassmembers class fqcn.of.javascript.interface.for.webview {\n# public *;\n#}\n\n# Uncomment this to preserve the line number information for\n# debugging stack traces.\n#-keepattributes SourceFile,LineNumberTable\n\n# If you keep the line number information, uncomment this to\n# hide the original source file name.\n#-renamesourcefileattribute SourceFile" }, { "path": "app/src/androidTest/java/com/yl/lib/privacysentry/ExampleInstrumentedTest.kt", "content": "package com.yl.lib.privacysentry\n\nimport androidx.test.platform.app.InstrumentationRegistry\nimport androidx.test.ext.junit.runners.AndroidJUnit4\n\nimport org.junit.Test\nimport org.junit.runner.RunWith\n\nimport org.junit.Assert.*\n\n/**\n * Instrumented test, which will execute on an Android device.\n *\n * See [testing documentation](http://d.android.com/tools/testing).\n */\n@RunWith(AndroidJUnit4::class)\nclass ExampleInstrumentedTest {\n @Test\n fun useAppContext() {\n // Context of the app under test.\n val appContext = InstrumentationRegistry.getInstrumentation().targetContext\n assertEquals(\"com.yl.lib.privacysentry\", appContext.packageName)\n }\n}" }, { "path": "app/src/main/AndroidManifest.xml", "content": "\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n \n \n \n \n \n \n \n \n \n\n \n \n \n\n \n\n \n \n\n" }, { "path": "app/src/main/java/com/yl/lib/privacysentry/APP.kt", "content": "package com.yl.lib.privacysentry\n\nimport android.app.Application\nimport android.content.Context\nimport android.os.Build\nimport androidx.multidex.MultiDex\nimport com.yl.lib.privacysentry.test.PrivacyMethod\nimport com.yl.lib.sentry.hook.PrivacyResultCallBack\nimport com.yl.lib.sentry.hook.PrivacySentry\nimport com.yl.lib.sentry.hook.PrivacySentryBuilder\nimport com.yl.lib.sentry.hook.util.PrivacyLog\n\n/**\n * @author yulun\n * @sinice 2021-11-19 10:20\n */\nclass APP : Application() {\n override fun onCreate() {\n super.onCreate()\n var str = testJustSerial()\n }\n\n override fun attachBaseContext(base: Context?) {\n super.attachBaseContext(base)\n // 注意尽可能在attachBaseContext里第一个调用，因为attachBaseContext之后才能反射拿到ActivityThread的application\n // 所以如果是在attachBaseContext中，且隐私合规SDK未初始化，不管是不是首次启动，都会认为是危险期，无法调用敏感api\n PrivacyMethod.PrivacyMethod.getAndroidId(base!!)\n MultiDex.install(this)\n Thread { initPrivacyTransformComplete() }.start()\n\n }\n\n private fun initPrivacyTransform() {\n PrivacySentry.Privacy.initTransform(this)\n }\n\n\n private fun initPrivacyTransformComplete() {\n\n // 完整版配置\n var builder = PrivacySentryBuilder()\n // 自定义文件结果的输出名\n .configResultFileName(\"demo_test\")\n //自定义检测时间，也支持主动停止检测 PrivacySentry.Privacy.stopWatch()\n .configWatchTime(10 * 60 * 1000)\n // 打开写入文件开关\n .enableFileResult(true)\n .syncDebug(true)\n // 文件输出后的回调\n .configResultCallBack(object : PrivacyResultCallBack {\n override fun onResultCallBack(filePath: String) {\n PrivacyLog.i(\"result file patch is $filePath\")\n }\n })\n // 添加默认结果输出，包含log输出和文件输出\n PrivacySentry.Privacy.init(this, builder)\n // 简易版配置\n// PrivacySentry.Privacy.init(this)\n }\n\n fun testJustSerial() {\n val serialNum = android.os.Build.SERIAL\n }\n}" }, { "path": "app/src/main/java/com/yl/lib/privacysentry/MainActivity.kt", "content": "package com.yl.lib.privacysentry\n\nimport android.Manifest\nimport android.app.ActivityManager\nimport android.app.AlertDialog\nimport android.content.Context\nimport android.content.Intent\nimport android.os.Build\nimport android.os.Bundle\nimport android.view.View\nimport android.widget.Button\nimport androidx.appcompat.app.AppCompatActivity\nimport androidx.fragment.app.FragmentActivity\nimport androidx.lifecycle.lifecycleScope\nimport com.yl.lib.privacy_test.PrivacyProxySelfTest2\nimport com.yl.lib.privacy_test.TestMethod\nimport com.yl.lib.privacy_test.TestMethodInJava\nimport com.yl.lib.privacysentry.calendar.CalenderActivity\nimport com.yl.lib.privacysentry.contact.ContactActivity\nimport com.yl.lib.privacysentry.location.LocationTestActivity\nimport com.yl.lib.privacysentry.process.MultiProcessB\nimport com.yl.lib.privacysentry.process.MultiProcessC\nimport com.yl.lib.privacysentry.telephony.TelephonyTestActivity\nimport com.yl.lib.privacysentry.test.*\nimport com.yl.lib.sentry.hook.PrivacySentry\nimport com.yl.lib.sentry.hook.util.MainProcessUtil\nimport com.yl.lib.sentry.hook.util.PrivacyClipBoardManager\nimport com.yl.lib.sentry.hook.util.PrivacyLog\n\nclass MainActivity : AppCompatActivity() {\n\n override fun onCreate(savedInstanceState: Bundle?) {\n super.onCreate(savedInstanceState)\n setContentView(R.layout.activity_main)\n\n findViewById