首页 游戏 软件 资讯 专题 排行

testjarconvaar 转换工具使用指南

时间:2026/11/16 14:50:08 作者:本站整理 阅读:0次

最近好多做安卓开发的朋友在群里问 jar 包怎么转成 aar,尤其是那些老项目里的第三方库,只给了 jar 没有 aar,导入新版本 Android Studio 之后各种报错。我自己前阵子接手一个维护项目也踩了这个坑,试了好几种办法,最后用 testjarconvaar 这个工具搞定了。今天就把整个使用过程写下来,包括怎么装、怎么跑、参数怎么填,还有我遇到的几个报错是怎么解决的,尽量说人话,新手也能照着做。

testjarconvaar 转换工具使用指南

testjarconvaar 到底是什么,能解决什么问题

简单说,testjarconvaar 就是一个专门把 jar 文件转成 aar 格式的小工具。安卓开发里 jar 只能放纯 class 文件,没有资源文件、没有 AndroidManifest,而 aar 可以带 res、assets、manifest 这些,所以很多新项目或者新版本 gradle 要求依赖必须是 aar 格式。你要是手里只有一个老 jar,直接扔进 libs 目录,编译的时候大概率会提示找不到资源或者 manifest 缺失。这时候 testjarconvaar 就派上用场了,它能把 jar 重新打包,补上 aar 需要的那几个基础文件,让依赖能正常被识别。

我第一次用的时候也担心会不会把原来的 class 搞坏,实际跑完发现只要参数填对,jar 里的 class 原封不动,只是外面套了一层 aar 的壳。这一点对老项目迁移特别友好,不用去找原库作者要 aar 了。

下载安装和运行环境准备

先说环境,testjarconvaar 是命令行工具,Windows、Mac、Linux 都能跑,但需要先装好 Java 运行环境,建议 JDK 8 以上。我是在 Windows 上试的,Mac 也跑过一遍,流程基本一样。下载下来是个压缩包,解压到一个不带中文和空格的路径,比如 D:\tools\testjarconvaar,路径带中文有时候会莫名其妙报错,这个坑我踩过。

解压完你会看到里面有一个可执行脚本和一个 lib 文件夹。Windows 下双击 bat 或者用 cmd 进到目录里运行,Mac 和 Linux 用终端给 sh 文件加执行权限。第一次运行如果提示 command not found,八成是权限没给,chmod +x 一下就行。还有就是别把工具放在 C 盘系统目录里,有时候权限不够写临时文件也会失败。

testjarconvaar 具体转换步骤和参数说明

真正转换就一条命令的事,但参数得说明白。基本用法是:testjarconvaar -i 你的文件.jar -o 输出目录。其中 -i 后面跟你要转的 jar 完整路径,-o 是转换后 aar 放哪个文件夹,不写的话默认在当前目录生成。还有一个常用参数是 -p,用来指定包名,因为 aar 里的 AndroidManifest 需要 package 属性,如果不指定,testjarconvaar 会尝试从 jar 里的 class 路径推断,但有时候推断出来的包名不对,会导致依赖引用不到,所以建议手动加上,比如 -p com.example.mylib。

我一般还会加 -v 参数,输出详细日志,转换过程中能看到它每一步在干嘛,出错了也好定位。命令敲下去之后,正常的话几秒钟就完事,输出目录里会出现一个同名 aar 文件。这时候你可以用解压软件打开看看,里面应该有 classes.jar、AndroidManifest.xml、R.txt 这些。如果 classes.jar 是空的,那说明原 jar 本身有问题,不是工具的事。

实测踩坑:几个常见报错和处理办法

第一个坑,报错说 “manifest package not found”。这个就是我前面说的包名问题,加上 -p 参数指定正确的包名就好了。包名从哪来?打开原 jar 里的 class 文件路径,或者看原库的文档,一般都能找到。

第二个坑,转出来的 aar 在 Android Studio 里同步时报 “Failed to resolve”。这种情况多半是 aar 里的 AndroidManifest 缺少 minSdkVersion 或者 targetSdkVersion。解决办法是用 testjarconvaar 的 -m 参数手动指定,或者在生成的 manifest 里自己补上。我后来干脆把常用参数写成一个 bat 脚本,每次改改文件名就能跑,省得记。

第三个坑,Mac 上运行提示 “bad interpreter”。这是因为脚本里的换行符是 Windows 格式,用 dos2unix 转一下,或者用 sed 把 \r 去掉就行。这个跟工具本身没关系,是跨平台的小毛病。

testjarconvaar 转换成功后的 aar 文件结构

转换完怎么在项目里用起来

aar 生成之后,把它放到项目的 libs 目录,然后在模块的 build.gradle 里加上 flatDir 仓库指向 libs,再在 dependencies 里用 implementation(name:'你的文件名', ext:'aar') 引用。注意文件名不要带版本号里的特殊符号,有时候带加号或者空格会解析失败。同步之后如果还报资源找不到,检查一下 aar 里有没有 res 目录,原 jar 如果没有资源,那 aar 里也不会有,这种情况只能确认原库是不是纯代码库。

另外提醒一句,testjarconvaar 适合做简单的 jar 转 aar,如果原 jar 依赖了其他库,转换后不会自动帮你把依赖也打进去,需要自己在 gradle 里补上。我上次转一个网络库就遇到这问题,后来手动加了 okhttp 的依赖才跑通。总体来说这个工具上手快、不挑系统,遇到报错别慌,多半是包名或者 manifest 缺东西,按上面说的排查基本都能解决。希望这篇指南能帮你少走点弯路。

相关文章
用户评论
昵称:
打分:
很好!

请自觉遵守互联网相关政策法规,网友评论内容与本站立场无关!

5.0
已有1人打分!
★★★★★
★★★★
★★★
★★
★
第 1 楼江苏盐城 网友2026/11/16 21:32:32
这工具本来挺好用但快捷键冲突太烦人了自定义几个功能后互相打架点啥都不响应只能关一个才能用另一个真坑新手别瞎调不然整个操作失灵体验极差建议默认别乱设快捷键

Poco_F7_Ultra支持(0) 盖楼(回复)

查看更多评论
精品推荐
充电圈app下载普天充电桩使用指南时间:2026-11-16诺动条码app扫码出入库管理软件使用教程时间:2026-11-16自如服务者1.2.3旧版本下载安装指南时间:2026-11-16扁鹊遇见AI官方下载安装最新版时间:2026-11-16微信聊天记录文件一键备份教程时间:2026-11-16
阅读排行
热门推荐