企业官网建设流程全解析

1. Han1meViewer 是什么？它解决的不是“看APK”而是“理解APK”

Han1meViewer 这个名字乍一听像某个小众汉化工具或二次元向插件，但实际它是 Android 开发与逆向分析领域里一个被低估的轻量级 APK 可视化解析器——不是反编译器，也不是打包工具，而是一个以开发者视角重构 APK 内部结构认知的交互式探针。我第一次在 GitHub 上看到它时，正被一个 Cocos Creator 打包出的 80MB 单体 APK 折磨得睡不着：资源目录混乱、so 库版本错位、assets 里嵌套了三层 zip、AndroidManifest.xml 里权限声明和 targetSdkVersion 明显矛盾……用 apktool 反编译后生成 2 万行 smali，用 jadx-gui 打开卡顿 47 秒，而 Han1meViewer 启动 1.8 秒，双击展开classes.dex就直接跳转到Application.onCreate()入口方法，点击res/values/strings.xml实时高亮所有未使用的 string 资源——它不做全量解析，只做关键路径优先索引。

它的核心价值，从来不是“替代 jadx 或 apktool”，而是填补了一个真实断层：当 Gradle 构建失败报错Could not install gradle distribution，你查完网络代理、镜像源、离线包路径后仍卡在java.net.SocketTimeoutException，这时候你需要的不是重装 Android Studio，而是快速确认当前 APK 是否真的包含了你刚 commit 的那几个 native so 文件；当测试反馈“bilibili 6.72.0 arm64-v8a 独立单 APK 在 vivo X90 上闪白”，你不需要等完整反编译，只需拖入 Han1meViewer，3 秒内定位android:hardwareAccelerated="false"是否被错误写死在某个 Activity 的 manifest 声明里。它把 APK 从“二进制黑盒”变成“可导航的工程地图”。

关键词里反复出现的Android Studio、Gradle、APK并非偶然——Han1meViewer 的设计哲学是紧贴 Android 开发者日常工作流。它不模拟 ADB 命令，不封装签名逻辑，不提供构建功能，但它能实时读取你本地~/.gradle/caches/modules-2/files-2.1/下已下载的依赖 JAR 包元信息，并与当前 APK 中的classes.dex方法引用做交叉比对；它能解析build.gradle中minSdkVersion和targetSdkVersion的实际生效值（哪怕你写了compileSdkVersion 34却在defaultConfig里漏配targetSdkVersion），并高亮显示与AndroidManifest.xml中<uses-sdk>标签的冲突点。这种“开发态感知能力”，正是它区别于传统 APK 分析工具的本质特征。

适合谁用？如果你常做这些事，Han1meViewer 就是你的新键盘快捷键：

• 每次./gradlew assembleRelease后，花 5 秒拖入 Han1meViewer 验证proguard-rules.pro是否真过滤掉了com.google.android.material的冗余类；
• 接手一个“移植 Android Studio 项目”时，不用逐行 diffsettings.gradle，直接加载两个 APK 并排对比lib/目录下 so 库的 ABI 架构分布；
• 调试content://com.tencent.wework.fileprovider/external_path/android/data/com.xxx.xxx/这类复杂 FileProvider URI 时，它能自动提取paths.xml中<external-path>的name与path映射关系，并验证是否与AndroidManifest.xml中android:authorities值匹配；
• 甚至当你只是想确认“js科技下载.apk”里有没有偷偷埋android.permission.READ_SMS权限，它也能在 2 秒内完成 Manifest 解析+权限树渲染，比手动打开 XML 文件快 6 倍。

它不教你怎么写代码，但让你一眼看清代码最终变成了什么。

2. 为什么选 Han1meViewer 而不是 jadx、apktool 或 Android Studio 自带 Analyze APK？

选择 Han1meViewer 不是技术情怀，而是基于三个硬性工作场景的效率权衡：启动速度、上下文关联、增量验证。我拿自己最近处理的 7 个真实 APK 样本做了横向测试（样本涵盖 Cocos Creator 打包、Flutter 插件混合、纯 Java SDK 封装、React Native 混合、Unity IL2CPP、Kotlin Multiplatform、以及一个被加固的金融类 APK），结果如下：

这个差距不是“快一点”，而是工作节奏的质变。举个具体例子：上周帮团队排查一个python flet 打包 apk后崩溃的问题，错误日志只显示FATAL EXCEPTION: main Process: com.example.fletapp, PID: 12345 java.lang.UnsatisfiedLinkError: dlopen failed: library "libflet_jni.so" not found。用 jadx-gui 打开要等半分钟，再一层层找lib/目录，发现arm64-v8a下有libflet_jni.so，但armeabi-v7a下没有——这说明打包脚本没配置多 ABI 支持。而 Han1meViewer 拖入 APK 后，左侧树状图直接以颜色区分 ABI 支持状态：绿色表示存在且符号表完整，黄色表示存在但缺少SONAME，红色表示缺失。我 3 秒内就截图发给 Python 同事：“你 flet build 命令加--android-abi arm64-v8a就行，不用改 Gradle”。他 2 分钟后回复：“已 fix，感谢”。

再比如gradle国内镜像配置错误导致Could not install gradle distribution，很多人会去翻gradle/wrapper/gradle-wrapper.properties，但 Han1meViewer 能直接读取 APK 的META-INF/MANIFEST.MF，提取Built-By: Gradle 8.4字段，然后自动检查你本地~/.gradle/wrapper/dists/下是否存在对应版本的解压目录。如果不存在，它不会报错，而是弹出提示框：“检测到 APK 使用 Gradle 8.4 构建，但本地未缓存该版本。建议执行./gradlew --version验证当前 wrapper 版本，或手动下载离线包至~/.gradle/wrapper/dists/gradle-8.4-bin/xxx/”。这种从产物反推构建环境的能力，是其他工具不具备的。

它的底层架构也决定了这种优势：Han1meViewer 不是基于 dex2jar 或 baksmali 的全量转换，而是采用分层解析策略——

• 第一层：ZIP 结构直读（不解压），快速获取AndroidManifest.xml、classes.dex、resources.arsc、lib/目录结构；
• 第二层：对classes.dex使用自研的轻量 DexReader（非 dexlib2），仅解析 method_id_item 和 class_def_item，跳过 code_item 的完整反汇编，实现毫秒级方法索引；
• 第三层：对AndroidManifest.xml使用 AXMLParser（非 android-xml-utils），直接映射二进制格式为 DOM 树，支持 XPath 查询；
• 第四层：Gradle 关联模块通过解析build.gradle的 AST（抽象语法树）片段，而非文本匹配，避免minSdkVersion 21写在ext { }闭包里导致误判。

这种设计牺牲了“完整反编译”的能力，却换来了开发者最需要的“精准定位”。就像外科医生不需要看完整人体扫描图，只需要在手术中精准定位病灶位置——Han1meViewer 就是那个手术灯。

3. 安装与基础使用：三步完成从零到熟练

Han1meViewer 的安装逻辑完全遵循 Android 开发者的习惯路径，不折腾 JDK 版本、不强制安装额外运行时、不修改系统 PATH。它本质是一个 JavaFX 应用，但打包时已内嵌 JRE 17（Windows/macOS/Linux 三端统一），所以你拿到的han1meviewer-1.3.2.jar就是开箱即用的完整程序——这点和android studio 下载后还要配 SDK、NDK、Emulator 形成鲜明对比。

3.1 下载与首次运行：拒绝“下一步下一步”

官方发布页（GitHub Releases）提供三个渠道：

• 推荐方式：直接下载han1meviewer-1.3.2-jre17-all.jar（约 86MB）。这是包含 JRE 17 的全量包，双击即可运行，无需预装 Java。我实测在一台刚重装系统的 Windows 11 笔记本上，下载后双击，1.7 秒弹出主界面，顶部菜单栏显示JRE: 17.0.8+8-LTS；
• 极简方式：下载han1meviewer-1.3.2.jar（约 12MB）。要求本地已安装 JDK 17+，且JAVA_HOME配置正确。适合已有完整 Android Studio 环境的用户，启动更快（1.2 秒），但需自行验证java -version输出是否为17.x.x；
• 定制方式：下载han1meviewer-1.3.2-src.zip（源码包）。适合想了解其 Gradle 依赖管理机制的开发者，里面build.gradle.kts清晰列出所有第三方库：org.jetbrains.kotlinx:kotlinx-coroutines-swing:1.7.3（异步 UI）、com.github.javaparser:javaparser-core:3.25.3（用于解析 build.gradle）、net.sf.jopt-simple:jopt-simple:6.0-alpha-3（命令行参数解析）。

提示：不要从第三方论坛或网盘下载所谓“汉化版”，Han1meViewer 原生支持中文界面（自动检测系统语言），且所有字符串资源都放在src/main/resources/i18n/messages_zh_CN.properties中，修改成本极低。所谓“汉化补丁”往往捆绑恶意软件，去年就有案例导致用户~/.gradle目录被加密勒索。

首次运行后，主界面默认为深色主题（适配 Android Studio Dolphin 的 UI 风格），左侧是 APK 结构树，中间是内容预览区，右侧是属性面板。此时不要急着拖入 APK——先做两件事：

1. 点击顶部菜单Settings → Preferences，进入设置页；
2. 在General标签下，勾选Auto-detect Gradle cache path（自动检测 Gradle 缓存路径），并确认Gradle user home显示为你真实的~/.gradle路径（Windows 是C:\Users\{username}\.gradle）；
3. 切换到APK Analysis标签，将Max resource file size (MB)从默认 50 调整为 100（因为bilibili 6.72.0 arm64-v8a 独立单 apk的 assets 目录含 78MB 视频资源，不调大会跳过解析）；
4. 点击OK保存。

做完这四步，你才真正准备好加载第一个 APK。记住：Han1meViewer 的强大不在于“能打开什么”，而在于“打开后你知道该看哪里”。

3.2 加载 APK 与核心视图解读：告别盲目点击

拖入一个 APK（比如你刚用android studio 安装教程配好环境后新建的 Hello World 项目生成的app-debug.apk），界面会瞬间刷新。此时重点观察三个区域：

左侧结构树（Structure Tree）：这不是简单的 ZIP 目录列表。它按 Android 工程语义分组：

• AndroidManifest.xml：点击展开，你会看到<manifest>→<application>→<activity>的层级，每个节点右键有Jump to source in build.gradle（跳转到对应 build.gradle 配置）；
• classes.dex：展开后是Packages→com.example.helloworld→MainActivity，双击onCreate()方法，中间预览区直接显示反编译后的 Java 代码（注意：这是轻量反编译，不生成完整 .java 文件，仅展示方法体）；
• resources.arsc：展开后是String Pool、Resource Table、Package，点击String Pool可查看所有字符串资源 ID 与值的映射；
• lib/：按 ABI 分组（arm64-v8a、armeabi-v7a、x86_64），每个 so 文件旁标注Size、Build Date、Required SDK Version（从.dynamic段读取）；
• assets/：支持预览图片、JSON、文本文件，对content://com.baidu.searchbox.fileprovider/baiddpath/android/data/com.ba这类路径，它会自动识别fileprovider并高亮paths.xml中的<external-files-path>声明。

中间预览区（Preview Panel）：根据左侧选中项动态变化。选中AndroidManifest.xml时，显示格式化 XML；选中classes.dex中的方法时，显示 Java 伪代码；选中res/values/strings.xml时，显示表格形式的 key-value 对，并在Status列标注Used（被代码引用）、Unused（未引用）、Referenced but missing（代码引用了但资源文件里没定义）。

右侧属性面板（Properties Panel）：显示当前选中项的元数据。例如选中MainActivity，这里会显示：

• Full name:com.example.helloworld.MainActivity
• Superclass:android.app.Activity
• Declared methods:12（含继承的）
• Referenced from:R$layout.activity_main（说明它被 layout 引用）
• Gradle dependency:androidx.appcompat:appcompat:1.6.1（从本地 cache 匹配）

注意：属性面板里的Gradle dependency不是猜的。Han1meViewer 会扫描~/.gradle/caches/modules-2/files-2.1/下所有 JAR 的MANIFEST.MF，提取Implementation-Title和Implementation-Version，建立哈希索引。当你选中一个方法，它就用该方法的class_name和method_signature去索引中匹配，找到最可能的依赖库版本。实测对androidx.core:core-ktx的匹配准确率达 99.2%。

3.3 快捷操作与效率技巧：让重复动作变成肌肉记忆

Han1meViewer 的快捷键设计完全复刻 Android Studio 的操作习惯，降低学习成本：

• Ctrl+O（Windows/Linux）或Cmd+O（macOS）：打开 APK 文件对话框；
• Ctrl+Shift+T：快速切换到最近打开的 APK（最多保留 10 个历史记录）；
• Ctrl+F：在当前预览区全文搜索（对 XML、Java 伪代码、JSON 都有效）；
• Alt+Click（左键）：在结构树中多选多个文件（比如同时选中lib/arm64-v8a/libxxx.so和lib/armeabi-v7a/libxxx.so，右键Compare ABI differences）；
• F2：重命名当前选中资源（仅限res/下的文件，修改后会实时更新R.java引用计数）；
• Ctrl+Shift+P：打开命令面板（类似 VS Code），输入gradle可快速跳转到 Gradle 设置页。

最实用的技巧是“双 APK 对比模式”：

1. 先加载旧版 APK（如app-v1.2.0-release.apk）；
2. 按Ctrl+Shift+T打开新 APK（app-v1.3.0-release.apk）；
3. 顶部菜单Tools → Compare APKs，选择两个 APK；
4. 它会生成对比报告：
   • Dex changes: 新增/删除/修改的方法数（精确到 method_id）；
   • Resource changes: 新增/删除的 drawable、string、layout；
   • Manifest changes: 权限增减、Activity exported 状态变更、uses-feature 添加；
   • Lib changes: so 库 ABI 支持变化、版本号升级（从SONAME提取）；
   • Gradle changes: 依赖库版本差异（如com.google.firebase:firebase-bom从32.2.0升到32.3.1）。

这个功能直接替代了diff -r和人工核对，我在做android studio 配置 git的版本审计时，用它 30 秒内就确认了build.gradle中android.useAndroidX=true是否被误删——因为对比报告里Manifest changes明确标出<uses-library android:name="android.test.runner" />被移除，而这个标签只在启用 AndroidX 时才会自动清理。

4. 个性化配置深度指南：让 Han1meViewer 成为你专属的 APK 显微镜

Han1meViewer 的配置体系分为三层：全局偏好（Preferences）、项目级规则（Rules）、会话级覆盖（Session Overrides）。绝大多数用户只用到第一层，但真正发挥其威力的是后两层——它们让你能把 Han1meViewer 从“通用工具”变成“个人工作流引擎”。

4.1 全局偏好（Preferences）：不只是换个主题

进入Settings → Preferences，General标签下有几个关键选项值得细调：

• UI Theme: 除了Dark/Light，还有Android Studio主题（完全复刻 AS 的 Material You 配色），启用后所有按钮、树状图、代码高亮都与你日常的 Android Studio 一致，减少视觉切换疲劳；
• Font Size: 默认 12px，但res/values/strings.xml预览时中文显示偏小，建议调到 14px；
• Auto-save analysis results: 勾选后，每次分析 APK 的结果（如 unused resources、missing permissions）会自动保存到~/.han1meviewer/cache/{apk_hash}/analysis.json，下次加载同一 APK 时秒级恢复，避免重复解析。

APK Analysis标签下更需精细控制：

• Parse DEX files: 默认开启，但如果你只关心 Manifest 和资源，可以关闭，提速 40%；
• Extract native libraries: 默认开启，但某些加固 APK 的lib/目录是虚拟的，开启会导致解析失败，此时应关闭并勾选Skip lib directory parsing；
• Validate Android 12+ rules: 这是核心安全开关。Android 12+ 要求所有android:exported显式声明，Han1meViewer 会扫描所有Activity/Service/BroadcastReceiver，对未声明的标红并给出修复建议（如Add android:exported="true"或"false"）。我曾用它发现一个content://com.tencent.mobileqq.sharefileprovide/external_files/android/d的 FileProvider 在 Android 13 设备上崩溃，就是因为android:exported缺失——而 Android Studio 的 Lint 检查在 debug 模式下并不触发此警告。

Gradle Integration标签是差异化所在：

• Gradle user home: 必须指向你真实的~/.gradle，否则依赖比对失效；
• Custom Gradle wrapper path: 如果你公司用私有 Gradle 分发（如https://internal-mirror.com/gradle/），在这里填入本地 wrapper 路径，Han1meViewer 会读取gradle-wrapper.properties中的distributionUrl并映射到本地缓存；
• Exclude dependencies: 输入逗号分隔的 group ID，如com.android.tools.build,org.jetbrains.kotlin，告诉 Han1meViewer 这些是构建工具依赖，不参与 APK 方法引用分析，避免误报。

4.2 项目级规则（Rules）：为特定 APK 定制分析逻辑

规则系统位于Settings → Rules，它允许你为不同类型的 APK 定义专属解析策略。比如你正在维护一个qt想要编译一个安卓平台的apk该如何简单操作的项目，Qt for Android 生成的 APK 有特殊结构：lib/下是libQt5Core.so等，assets/里有qt.conf和qml/目录。默认规则会把qt.conf当作普通文本，但你可以创建一条规则：

• Rule Name:Qt Android APK
• APK Pattern:.*qt.*\.apk（正则匹配文件名）
• Actions:
  • Parse assets/qt.conf as INI file（将 qt.conf 解析为键值对）
  • Highlight qml/ directory in assets tree（在结构树中高亮 qml 目录）
  • Check for missing Qt plugins in lib/（扫描lib/下是否缺失libqsvg.so等插件）

创建后，只要拖入任何含qt的 APK，Han1meViewer 就自动启用此规则。我用它快速定位过一个pc运行apk项目（用 Qt Quick Controls 2 构建）的字体渲染问题：规则自动解析qt.conf发现FontFamily=Roboto，但assets/fonts/目录下只有NotoSans.ttf，于是高亮提示“Font family 'Roboto' not found in assets/fonts/”。

另一个典型场景是cocos creator 打包 apk。Cocos Creator 3.x 生成的 APK 里，assets/src/存放 JavaScript 源码（混淆后），assets/frameworks/是引擎代码。默认规则会把 JS 当作纯文本，但你可以添加规则：

• Rule Name:Cocos Creator APK
• APK Pattern:.*cocos.*\.apk
• Actions:
  • Decode base64 strings in assets/src/*.js（自动解码 JS 中的 base64 字符串，便于查看原始资源路径）
  • Map assets/src/ to project structure（将assets/src/game.js映射到project/assets/scripts/game.ts，方便溯源）
  • Warn on deprecated Cocos APIs（扫描cc.log、cc.sys.os等已废弃 API 调用）

这些规则保存在~/.han1meviewer/rules/下，以 JSON 格式存储，可版本管理、可共享给团队。

4.3 会话级覆盖（Session Overrides）：临时应对特殊需求

会话覆盖是最高优先级的配置，只对当前打开的 APK 生效，关闭后自动清除。按Ctrl+Shift+O打开覆盖面板，常见用途：

• 处理加固 APK：某些加固方案（如腾讯乐固、360加固）会加密classes.dex，Han1meViewer 默认解析失败。此时在覆盖面板中勾选Use custom DEX parser，选择dexguard-decryptor（需提前放入~/.han1meviewer/plugins/），它会调用本地dexguard-cli工具进行解密；
• 指定 Manifest 解析模式：遇到android 进入apk闪白的问题，可能是AndroidManifest.xml被混淆工具篡改。勾选Force AXML parse mode，切换为Legacy AXML模式（兼容老版本二进制格式）；
• 自定义资源路径映射：content://com.tencent.wework.fileprovider/external_path/android/data/com这类路径，Wework 的paths.xml可能放在assets/而非res/xml/。在覆盖面板中添加Path mapping:assets/paths.xml → res/xml/file_paths.xml，Han1meViewer 就会按此映射解析 FileProvider 配置。

实操心得：会话覆盖的“自定义资源路径映射”功能，救了我三次。有一次分析一个殴易okx安卓版apk，它的FileProvider配置被移到assets/okx_file_paths.xml，且android:authorities动态拼接（com.okx.fileprovider.${package_name}）。我通过覆盖面板映射路径后，Han1meViewer 成功提取${package_name}的实际值（com.okx.app），并验证了external_path是否真的指向android/data/com.okx.app/——结果发现权限声明里漏了android.permission.WRITE_EXTERNAL_STORAGE，这就是闪退根源。

5. 高阶实战：用 Han1meViewer 解决 5 类高频疑难问题

Han1meViewer 的价值，在于把抽象的构建错误、模糊的崩溃日志、混乱的资源引用，转化为可视化的、可操作的诊断线索。以下是我在真实项目中用它解决的 5 类高频问题，附带完整操作链路和避坑要点。

5.1 Gradle 构建失败：Could not install gradle distribution from reason: java.net.SocketTimeoutException

现象：执行./gradlew assembleRelease报错，提示Could not install gradle distribution，网络检查无异常，gradle国内镜像配置正确，gradle离线包已下载，但依然失败。

Han1meViewer 诊断链路：

1. 找到最近一次成功构建的 APK（如app-success.apk），拖入 Han1meViewer；
2. 查看右侧属性面板中的Built-By字段，确认 Gradle 版本（如Gradle 8.4）；
3. 进入Settings → Preferences → Gradle Integration，点击Verify Gradle cache；
4. Han1meViewer 会扫描~/.gradle/wrapper/dists/，发现gradle-8.4-bin/xxx/目录下缺少gradle-8.4.jar（只有gradle-8.4-bin.zip）；
5. 此时点击Download missing files，它会自动用你配置的镜像源下载gradle-8.4.jar并解压；
6. 验证完成后，回到终端重新执行./gradlew assembleRelease，构建成功。

避坑要点：

• 不要手动解压gradle-8.4-bin.zip，Han1meViewer 的下载器会校验 SHA256 值，确保完整性；
• 如果Verify Gradle cache提示 “No matching distribution found”，说明 APK 是用私有 Gradle 构建的，需在Custom Gradle wrapper path中指定内部镜像地址。

5.2 权限崩溃：java.lang.SecurityException: Permission Denial

现象：Android 12+ 设备上，调用content://com.baidu.searchbox.fileprovider/baiddpath/android/data/com.ba时崩溃，日志显示Permission Denial。

Han1meViewer 诊断链路：

1. 拖入 APK，展开AndroidManifest.xml→<application>→<provider>；
2. 找到android:authorities="com.baidu.searchbox.fileprovider"的节点；
3. 右键Open paths.xml（Han1meViewer 自动定位res/xml/file_paths.xml或assets/paths.xml）；
4. 查看<external-path name="baiddpath" path="." />，确认path="."表示根目录；
5. 切换到Permissions标签页（顶部菜单View → Permissions），发现android.permission.READ_EXTERNAL_STORAGE未声明；
6. 更关键的是，在AndroidManifest.xml的<provider>节点上，android:exported属性缺失（Android 12+ 要求必须显式声明）；
7. Han1meViewer 在Properties Panel中高亮提示：“Missing android:exported attribute. Add android:exported="true" if accessible by other apps, or "false" if private.”；
8. 根据业务需求，添加android:exported="true"并声明android.permission.READ_EXTERNAL_STORAGE。

避坑要点：

• android:exported的值不能乱填。如果 FileProvider 只供本应用内使用，必须设为false，否则会被 Google Play 拒绝；
• path="."是危险配置，Han1meViewer 会在Security Warnings标签页中标红提示：“External path points to root directory. Consider narrowing scope to specific subdirectory.”

5.3 资源缺失：android.content.res.Resources$NotFoundException: Resource ID #0x7f080001

现象：运行时崩溃，日志显示找不到资源 ID，但R.java中该 ID 存在，res/目录下也有对应文件。

Han1meViewer 诊断链路：

1. 拖入 APK，进入Resources标签页（顶部菜单View → Resources）；
2. 在搜索框输入0x7f080001，Han1meViewer 会定位到res/drawable/ic_launcher.xml；
3. 展开该文件，发现它是一个vector，但android:fillType属性值为evenOdd；
4. 切换到Compatibility标签页，Han1meViewer 检测到evenOdd是 Android 24+ 新增属性，在 Android 21 设备上不支持；
5. 同时，Properties Panel显示Target SDK: 33，但Min SDK: 21，存在兼容性缺口；
6. 解决方案：将android:fillType="evenOdd"改为android:fillType="nonZero"（后者 Android 21+ 全支持），或降级 vector 图形。

避坑要点：

• Han1meViewer 的Compatibility标签页会列出所有 API Level 相关警告，按严重程度排序（Critical > High > Medium）；
• 对vector资源，它还会检查android:viewportWidth/android:viewportHeight是否为整数，避免某些低端设备渲染异常。

5.4 ABI 不匹配：java.lang.UnsatisfiedLinkError: dlopen failed: library "libxxx.so" not found

现象：pc运行apk时崩溃，日志指出libxxx.so找不到，但lib/目录下明明有该文件。

Han1meViewer 诊断链路：

1. 拖入 APK，展开lib/目录；
2. 找到libxxx.so，右键Show library info；
3. Han1meViewer 解析 ELF 头，显示：
   • Architecture:AArch64（即 arm64-v8a）
   • Required SDK Version:21
   • Dependencies:libstdc++.so, liblog.so
4. 对比设备 ABI：adb shell getprop ro.product.cpu.abi返回armeabi-v7a；
5. 结论：APK 只提供了arm64-v8a版本，但设备是armeabi-v7a架构；
6. 解决方案：在build.gradle的ndk块中添加abiFilters 'armeabi-v7a', 'arm64-v8a'。

避坑要点：

• 不要只看lib/目录是否存在，要看Required SDK Version是否与设备匹配；
• Han1meViewer 会标记lib/armeabi-v7a/libxxx.so为Red（缺失），lib/arm64-v8a/libxxx.so为Green（存在），一目了然。

5.5 混淆干扰：ProGuard mapping 丢失导致崩溃无法定位

现象：线上崩溃日志是混淆后的类名方法名，如a.b.c.d.e.f()，无法对应源码。

Han1meViewer 诊断链路：

1. 确保你有mapping.txt（通常在app/build/outputs/mapping/release/）；
2. 拖入 APK，顶部菜单Tools → Load ProGuard Mapping，选择mapping.txt；
3. Han1meViewer 将混淆映射加载到内存，此时再展开 `classes