这是一个纯前端网页应用，用于分析 Android APK 文件中集成的 SDK 库和 AndroidManifest.xml 内容。
- ✅ 从 APK 中提取并解析 AndroidManifest.xml 文件
- ✅ 识别集成的 SDK 和原生库（基于 LibChecker 规则库，2884+ 库规则）
- ✅ 按分类展示 SDK 库（崩溃收集、网络请求、支付、广告等）
- ✅ 完整展示 AndroidManifest.xml 内容（支持复制和下载）
- ✅ 生成专业分析报告（HTML / JSON）
- 前端框架: React 18 + TypeScript
- 构建工具: Vite
- APK 解析: jszip
- AXML 解析: 自实现（基于 axml2xml）
- 多线程: Web Worker
- 缓存: IndexedDB
apk-analyzer/
├── package.json # 项目配置
├── tsconfig.json # TypeScript 配置
├── vite.config.ts # Vite 配置
├── index.html # 入口 HTML
├── sdk-categories.json # SDK 分类映射
├── scripts/
│ └── build-rules-bundle.js # 规则库预处理脚本（合并 2884+ JSON）
├── public/
│ └── rules-bundle.json # 预处理后的规则库（自动生成）
└── src/
├── main.tsx # 应用入口
├── App.tsx # 主应用组件
├── types/
│ └── index.ts # TypeScript 类型定义
├── utils/
│ ├── axmlParser.ts # AXML 解析工具（已完成）
│ ├── fuzzyMatcher.ts # 模糊匹配算法
│ └── reportGenerator.ts # 报告生成器
├── services/
│ ├── apkAnalyzer.ts # APK 分析主逻辑
│ ├── sdkScanner.ts # SDK 扫描模块
│ └── rulesLoader.ts # 规则库加载管理
├── workers/
│ └── analyzerWorker.ts # 分析 Worker（后台处理）
├── components/
│ ├── FileUploader.tsx # 文件上传组件
│ ├── AnalysisProgress.tsx # 进度展示组件
│ ├── ResultTabs.tsx # 结果 Tab 容器
│ ├── LibraryList.tsx # SDK 库列表
│ ├── XmlViewer.tsx # XML 内容展示
│ ├── AnalysisHistory.tsx # 历史记录页面
│ ├── ReportExport.tsx # 报告导出对话框
│ └── Toast.tsx # Toast 通知组件
└── styles/
└── App.css # 全局样式
pnpm installpnpm dev服务器将在 http://localhost:3000 启动。
pnpm build构建产物将输出到 dist/ 目录。
规则库预处理脚本会在 pnpm dev 和 pnpm build 前自动执行，将 2884+ 个规则文件合并为一个 public/rules-bundle.json 文件。
手动执行：
node scripts/build-rules-bundle.js- 将 Android 二进制 XML 转换为普通 XML
- 提取 Manifest 基本信息（包名、版本号等）
- 提取组件列表（Activity、Service、Provider、Receiver）
采用 7 层级匹配策略：
- 精确匹配: 直接匹配规则库键名
- 基础规范化: 去除
lib前缀、.so扩展名、转小写 - 去除版本号: 移除
-5.9.7、_v2.0等版本号 - 去除构建后缀: 移除
-debug、-release、_arm64等 - 去除包名前缀: 移除
com_example_app_等包名模式 - 子串模糊匹配: 在规则库中查找包含关系
- Hash 名称处理: 检测并标记混淆名称
- 扫描 Native 库（lib 目录下的 .so 文件）
- 扫描 Manifest 组件（Activities/Services/Providers/Receivers）
- 按架构分组（arm64-v8a, armeabi-v7a 等）
- 去重处理
- 从 IndexedDB 加载规则库
- 支持云端版本检查和自动更新
- 规则库缓存优化
- ✅ 项目目录结构初始化
- ✅ 规则库预处理脚本（合并 2358 个 JSON 文件，1.75 MB）
- ✅ AXML 解析模块（完整实现，支持 ArrayBuffer）
- ✅ TypeScript 完整类型定义
- ✅ 7 层级模糊匹配算法实现
- ✅ SDK 扫描和匹配模块（Native、Activity、Service、Provider、Receiver）
- ✅ 规则库加载管理（IndexedDB 缓存 + 云端更新）
- ✅ APK 分析主逻辑（完整流程编排）
- ✅ 报告导出功能（HTML/JSON 双格式）
- ✅ 文件上传组件（拖拽 + 点击上传，500MB 限制）
- ✅ 分析进度组件（阶段跟踪 + 进度条）
- ✅ 结果 Tab 容器（基本信息 + 统计卡片）
- ✅ SDK 库列表（分类导航 + 展开/折叠）
- ✅ XML 查看器（复制 + 下载）
- ✅ 报告导出对话框（自定义选项）
- ✅ 历史记录页面（日期分组 + 搜索 + 排序）
- ✅ 最近分析列表（localStorage 持久化 + 快速重新分析）
- ✅ Toast 通知组件（成功/错误提示）
- ✅ 删除确认弹窗（防误操作）
- ✅ 文件验证错误提示（内联显示，替代 alert）
- ✅ 主应用组件（状态管理 + 错误处理）
- ✅ 完整 CSS 样式（响应式设计 + 动画 + 优化对比度）
- ✅ Vite + React + TypeScript 配置完成
- ✅ 依赖安装完成
- ✅ 开发服务器正常运行（http://localhost:3000）
- ✅ 规则库合并成功（2358 个规则）
项目已经完全开发完成，可以直接使用！
# 启动开发服务器
pnpm dev
# 构建生产版本
pnpm build访问 http://localhost:3000，上传 APK 文件即可开始分析。
规则库版本: 2025-11-10-1724
总规则数: 2358 个
文件大小: 1.75 MB
规则分布:
- Native 库: 1269 个规则
- Activity: 454 个规则
- Service: 259 个规则
- Provider: 147 个规则
- Receiver: 117 个规则
- Static: 1 个规则
- Actions: 111 个规则
- 规则库路径: 确保
../LibChecker-Rules-4/目录存在并包含规则文件 - 分类映射:
sdk-categories.json文件必须存在于项目根目录 - 内存优化: 使用 Web Worker 处理大文件，避免阻塞 UI
- 离线支持: 规则库通过 IndexedDB 缓存，支持离线使用
MIT