嵌入式软件单元测试（六十）——零开销测试桩：利用GCC属性构造编译期函数替换实现
2026/9/17 7:17:10
RTranslator 模型部署教程：1.2GB 离线翻译模型 5 分钟手动装好
【免费下载链接】RTranslatorOpen source real-time translation app for Android that runs locally项目地址: https://gitcode.com/GitHub_Trending/rt/RTranslator
第一次打开 RTranslator 时，应用会自动下载约 1.2GB 的 AI 模型文件，在部分网络环境下这一过程可能耗时数小时甚至反复中断。RTranslator 是一款运行在 Android 上的免费、离线实时翻译应用，所有语音识别（Whisper）和翻译（Meta NLLB）计算都在本机完成，不经过任何服务器，因此模型一旦部署完成，之后可以完全离线使用。
部署前准备：确认设备与空间
开始之前，请对照下表确认设备满足条件，满足后再动手：
| 项目 | 要求 | 说明 |
|---|---|---|
| 内存 | 至少 6GB RAM | 低于 6GB 时应用启动会弹出警告，且很可能崩溃 |
| 存储空间 | 内部存储和外部存储各预留约 2GB | 模型约 1.2GB，应用在校验和转存时还需额外约 800MB 缓冲 |
| 系统版本 | Android 7.0 及以上（API 24+） | 应用 minSdk 为 24 |
| 应用版本 | RTranslator 2.0.3 或更高（当前版本 2.1.2） | 手动放置模型从 2.0.3 版开始支持 |
| 所需工具 | 一台电脑 + USB 数据线 | 新版 Android 限制了手机自身访问Android/目录，需要用电脑完成复制 |
主方案：在电脑下载模型，手动放入应用目录
这是官方文档 Sideloading.md 推荐的做法，按顺序执行以下 6 步即可。
第 1 步：安装最新版应用
从 RTranslator 项目 Releases 页面下载最新版 APK（2.0.3 及以上）并安装。如果你之前装过旧版本，先在系统设置中重置应用数据，避免残留状态干扰。
第 2 步：在电脑上下载 10 个模型文件
从项目 Releases 页面 2.0.0 版本的附件（assets）中下载全部 10 个.onnx文件，这些就是应用首次启动时本来要下载的内容：
| 文件 | 用途 | 大小（约） |
|---|---|---|
| NLLB_encoder.onnx | 翻译编码器 | 254MB |
| NLLB_decoder.onnx | 翻译解码器 | 171MB |
| NLLB_embed_and_lm_head.onnx | 翻译嵌入与输出层 | 500MB |
| NLLB_cache_initializer.onnx | 翻译缓存初始化 | 24MB |
| Whisper_encoder.onnx | 语音识别编码器 | 88MB |
| Whisper_decoder.onnx | 语音识别解码器 | 173MB |
| Whisper_detokenizer.onnx | 语音识别解标记 | <1MB |
| Whisper_cache_initializer.onnx | 语音缓存初始化 | 14MB |
| Whisper_cache_initializer_batch.onnx | 批量语音缓存 | 14MB |
| Whisper_initializer.onnx | 语音识别初始化 | <1MB |
做完这步你会看到：一个包含 10 个.onnx文件的文件夹，总大小约 1.2GB。文件清单与源码 DownloadFragment.java 中的DOWNLOAD_NAMES数组一一对应。
第 3 步：先启动一次应用，让它建好目录
打开 RTranslator，接受通知权限（通知仅在对话或 WalkieTalkie 模式后台运行时使用），然后直接关闭应用，不要继续往下走。应用在这一步会在手机上创建存放模型的文件夹。
第 4 步：把文件复制到手机
用 USB 线把手机连上电脑，把 10 个.onnx文件全部复制到：
内部存储/Android/data/nie.translator.rtranslator/files/如果之前刚连接过电脑，请拔掉再重新插上，否则新建的文件夹可能不会显示。
提示：如果你的手机同时有内部存储和 SD 卡，不确定文件该放哪，就检查内部存储中的这个
files目录里是否有一个Readme.txt文件——应用只在自己创建的目录里写这个文件，没有 Readme.txt 的话就去看 SD 卡。
做完这步你会看到：files目录中同时存在 10 个.onnx文件和 1 个Readme.txt。
第 5 步：重新打开应用，让应用接管文件
再次启动 RTranslator 并继续配置流程。进入下载界面后，应用不会开始网络下载，而是直接从files目录读取这 10 个文件并逐个校验完整性（界面会显示 "Checking integrity of ..."），只有校验失败的文件才会触发重新下载。
第 6 步：验证部署成功
校验全部通过后，files目录里你放进去的 10 个文件会自动消失（已被移入应用的私有内部存储），应用进入主界面。接着把手机开飞行模式，进入文本翻译模式翻译一句中文为英文，能正常输出即代表模型部署完成、可离线工作。
备选方案
网络条件好：直接用应用内置下载
如果你的手机下载速度正常（如 5MB/s 以上，1.2GB 约 4-5 分钟可完成），可以跳过手动放置，安装应用后直接让它自动下载。界面会依次显示 "Downloading ..."、"Checking integrity of ..."、"Transferring ... in internal memory" 三种状态，全部完成后自动进入主界面。中途断网时界面会出现重试按钮，点击即可从断点处继续。
使用 ADB 推送（进阶用户）
已有 USB 调试环境的话，可以先按主方案第 3 步启动一次应用建好目录，然后在电脑终端执行：
adb push /本地路径/*.onnx /sdcard/Android/data/nie.translator.rtranslator/files/ adb shell ls -l /sdcard/Android/data/nie.translator.rtranslator/files/第二条命令应列出 10 个.onnx文件和 1 个Readme.txt，随后照主方案第 5、6 步验证即可。
验证与排错：如何确认部署成功
成功的标志有三个：1）下载界面显示完整性校验完成而非下载进度；2）files目录中的.onnx文件被自动清空；3）主界面在飞行模式下仍能正常翻译。
出现异常时，按下表对照处理：
| 现象 | 原因 | 处理 |
|---|---|---|
| 显示 "Error in the download..." | 网络连接中断或下载失败 | 点击重试；反复失败则改用本教程的手动放置方式 |
| 显示 "Error in the transfer of the downloaded file..." | 外部存储（如 SD 卡）在转存时被拔出 | 保持应用前台打开，插回存储设备后点重试 |
| 显示 "There was an error loading the files of the models..." | 模型文件损坏或不完整 | 先重启应用；问题仍在则点界面上的修复按钮，应用只会重新下载损坏的文件 |
| 显示 "Low storage space, the download may fail" | 内部或外部存储剩余空间不足 2GB | 清理出至少 2GB 后重试 |
电脑里找不到Android/data/nie.translator.rtranslator目录 | 连接未刷新或目录尚未创建 | 重插 USB 线；确认已按第 3 步启动过应用 |
| 放入文件后应用仍开始下载 | 文件放错了存储位置或文件名被改动 | 用Readme.txt判断正确目录；文件名必须与第 2 步清单完全一致 |
进阶：内存占用与语言选项
模型已经做过 int8 量化、KV 缓存分离等优化，实际占用为：NLLB 翻译模型约 1.3GB RAM（75 个 token 的翻译耗时约 2 秒），Whisper 语音识别约 0.9GB RAM。内存低于 8GB 的设备上，Whisper 会自动切换到 0.5GB RAM 的低占用模式，代价是识别耗时从 1.6 秒增加到 2.1 秒。此外，在设置中开启 "Support low quality languages" 可以增加 40 多种低质量语言支持，代价是翻译与识别质量下降，按需开启即可。
下一步
现在可以打开应用的文本翻译模式做一次离线验证；确认无误后，即可邀请另一位安装了 RTranslator 的伙伴通过对话模式测试双向语音翻译。更多细节见 README.md 与 Sideloading.md。
【免费下载链接】RTranslatorOpen source real-time translation app for Android that runs locally项目地址: https://gitcode.com/GitHub_Trending/rt/RTranslator
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考