APP-android_arm64常见问题FAQ：Android版Blender安装、编译与崩溃排查的10个技巧

APP-android_arm64 是Android 版 Blender（OBlender，应用名 "blender on Android"）的官方移植仓库，包含完整的 Android 应用源码与资源文件。本文以 FAQ 形式整理 10 个实用技巧，覆盖 Android 版 Blender 的安装部署、源码编译与崩溃排查三大场景，帮助你少走弯路、快速上手。

📦 项目结构速览

在开始之前，先花 30 秒了解仓库的组织方式，后续排查问题时会用到：

该仓库只是"四仓库矩阵"之一：lib-android_arm64（第三方库）、Utilities-android_arm64（辅助工具）、Blender-android_arm64（Blender 库源码）、APP-android_arm64（本仓库，APP 源码与资源）。

📥 安装篇（技巧 1–3）

技巧1：如何确认你的手机支持 Android 版 Blender？

先看 OBlender/app/build.gradle 中的三项硬性要求：

• CPU 架构：仅支持arm64-v8a（64 位 ARM），32 位手机无法安装运行
• 系统版本：minSdkVersion 28，即Android 9.0 及以上
• 屏幕方向：AndroidManifest.xml 中锁定为横屏使用

💡 小技巧：在系统"关于手机"中确认架构是否含arm64-v8a；平板和横屏大屏手机体验最佳。

技巧2：首次启动为什么要求存储和网络权限？

启动页 StartupActivity.java 会依次申请两类权限，原因如下：

💡 小技巧：Android 11 及以上系统跳转的是系统级"所有文件访问"开关，直接点"确定"进入设置页打开即可，这是正常流程而非异常弹窗。

技巧3：首次启动加载很慢、卡在加载页怎么办？

这是**最常被误认为"崩溃"**的现象。首次启动时，InstallOBLFiles.java 会把打包资源释放到两处：

• 外部存储：examples、Desktop、Documents、Downloads、Music、Pictures、Videos（模拟桌面系统的家目录结构）
• 应用私有目录：python、4.0、scripts、usd（Python 运行库与内置脚本）

由于包含完整的 Python 3.11 运行库和数百个脚本文件，首次解压可能需要数分钟。正确做法：

1. 保持应用在前景或后台，不要强制结束
2. 确认剩余存储空间充足（建议预留 1GB 以上）
3. 资源仅复制一次（已存在的文件夹会跳过），第二次启动会明显变快

🛠️ 编译篇（技巧 4–7）

完整流程以 Doc/编译流程_cn.txt 为准，英文版本见 Doc/Compile Flow_en.txt。

技巧4：编译 Android 版 Blender 需要下载哪四个仓库？

四个仓库需放在同一父目录下（文档以D:/FreeProjects/Blender/Blender为例）：

Blender/ ├── lib-android_arm64 # 第三方库（库文件+头文件） ├── Utilities-android_arm64 # 辅助工具：MakeBlender / MakeSDNA / MakeSRNA ├── Blender-android_arm64 # Blender 库源码（基于 Blender 发行分支的本地修改版） └── APP-android_arm64 # 本仓库：APP 源码与资源

编译顺序上，先编译 Blender 库（MakeBlender），最后才编译本仓库中的 OBlender APP（第 19–20 步）。

技巧5：编译工具版本清单（照着装不踩坑）

所有组件都用同一套工具链编译，版本务必对齐：

💡 小技巧：build.gradle中已写死ndkVersion '21.4.7075529'，若本机 NDK 版本不同，同步项目时会直接报版本缺失——去 Android Studio 的 SDK Manager → SDK Tools 里安装对应版本即可。

技巧6：DNA/RNA 文件生成失败？按"三步编译法"走

编译 Blender 库的核心难点在于DNA/RNA 描述文件需要先在 Android 设备上生成再回拷，流程分三步（详见 Doc/编译流程_cn.txt）：

1. 第一次编译 MakeBlender→ 生成libmakesdna.a；再编译运行MakeSDNA，把dna.c、dna_type_offsets.h、dna_verify.c回拷到源码目录
2. 第二次编译→ 生成libmakesrna.a；再运行MakeSRNA回拷*.c/*.h
3. 第三次编译→ 完成全部库，最后编译 OBlender APP

⚠️ 关键细节：每步回拷前都要注释掉CMake 中对应的add_custom_command自动生成命令，并把dna_verify.c中的设备路径/data/data/com.epai.makesdna/makesdna替换为本机源码路径。

技巧7：编译报"找不到库路径"或工具缺失？

两个高频原因及对策：

• 硬编码路径：第三方库路径目前硬编码为D:/FreeProjects/Blender/Blender，如果你把仓库放在别处，把该前缀全局替换成自己的目录即可（Doc/编译流程_cn.txt 第 2–3 行有说明）
• 辅助工具未就位：msgfmt.exe、datatoc.exe等工具需要从Utilities-android_arm64/Utilities复制到 MakeBlender 的.cxx/cmake/release/arm64-v8a/bin/和source/creator/两个目录（流程第 8 步）

🔍 崩溃排查篇（技巧 8–10）

技巧8：排查第一步——找到 error.log 日志文件

C++ 层启动时会把stderr 重定向到文件（native-lib.cpp），日志位置固定：

外部存储家目录下的error.log（即InstallOBLFiles创建的那个 home 目录，见 native-lib.cpp）

💡 小技巧：崩溃后第一时间打开error.log看最后几行，比盲目重装有效得多。配合 Android Studio 的Logcat（过滤OBLNativeActivity、InstallOBLFiles标签）可定位 Java 层异常。

技巧9：安装后无法启动或闪退？按这个清单排查

技巧10：手机上没有键盘鼠标，怎么按快捷键？

OBlender 内置了虚拟按键面板，核心逻辑在 OblSettingFragment.java：

• 提供Ctrl / Alt / Shift三个修饰键，以及鼠标**左键、中键（MMB）、右键（RMB）**的触屏模拟
• 面板分多页管理（Page1/2/3），支持拖动定位（MOVE），适配横屏小屏操作
• 也支持外接蓝牙键盘和触控板；AndroidManifest中type.pc非必需声明意味着Android 版 PC 设备同样可安装

✅ 写在最后

• 日常查阅：Doc/编译流程_cn.txt（20 步完整流程 + 工具版本）
• 应用入口：OBlender/app/src/main/java/com/epai/oblender/OBLNativeActivity.java（加载libblender主窗口）
• 资源释放逻辑：OBlender/OBLFiles/src/main/java/com/epai/oblfiles/InstallOBLFiles.java
• 示例工程：OBlender/OBLFiles/src/main/assets/examples/ball-in-grass.blend，可用于快速验证安装是否成功

掌握以上 10 个技巧后，绝大多数 Android 版 Blender 的安装、编译与崩溃问题都能自行解决。如果遇到error.log中未收录过的报错，建议附上日志内容到项目 Issue 中反馈 🙌