TinyAXML AndroidManifest 二进制文件序列化/反序列化库

此为 AXMLEditor 重写后的工具, 添加了 dump/build/plugin 指令(插件), 解决了那个工具的部分错误

实际上重构原项目工程量太大了... 而且有太多因为采用完全 ser/deser 而弃用的代码和认为不够合适的代码, 故决定以那个工具的部分代码为基础重做一个新的库(实际上没用)

和那个工具一样, 本源采用 Unlicensed 许可证, 你爱怎么办怎么办, 本库的文档测试覆盖机会大概计划比那个高一点, 使用插件系统, 本身基本只包含 AXML 处理逻辑

顺便推荐 一文章, 而且我把它复制成了 gist 方便参考

用途

针对于特定 Android APK 反编译修改后无法执行回编译操作, 直接进行 AXML 二进制文件修改, 然后只需要二次签名即可. 无需完全进行反编译和回编译操作

关于 xmlpull 依赖

原版包含了这个依赖以方便添加 XML tag, 如果 insert 工具抛出 NoClassDefFound 异常, 确认 xmlpull.jar 与工具放在相同目录下(不存在的, 好像只是类路径)

什么是 绝对名称

简短版本: <tag name="my_abs_name"></tag>

在更新时原版的代码里, 部分方法对应的参数没有使用, 我在找到的 XML 和 AXML 文档里没有提到这个

用法

Library usage

A small library for serializing/deserializing Android binary AXML format

import org.duangsuse.tinyaxml.AxmlFile

public class PrintResourceIds {
    public static void main(String[] args) {
        AxmlFile axml = new AxmlFile("AndroidManifest.xml");
        int i;
        for (int id:axml.resourceMap.ids) {
            System.out.println(String.format("#%1$i: %2$i", i++, id));
        }
    }
}

Writing a plugin

import org.duangsuse.tinyaxml.AxmlFile

@JvmName("TinyAxmlPlugin")
public class PrintResourceIds() {
    public process(axml: AxmlFile, args: Array<String>) {
        var i: Int;
        for (int id:axml.resourceMap.ids) {
            System.out.println("#$i: $id");
        }
    }
}

Run plugin: tinyaxml printResourceIds.class AndroidManifest.xml

方便的脚本

sudo nano /usr/bin/tinyaxml

#!/bin/sh
export TINYAXML_PLUG=$HOME/.local/tinyaxml/
cd $HOME/Projects/tinyaxml/build/libs/
java -cp ../../:tinyaxml-*.jar org.duangsuse.tinyaxml.Main $*

mkdir $HOME/.local/tinyaxml cd $HOME/Projects/tinyaxml/plugins; make install View JavaDoc for library documents

插入属性

tinyaxml attr -i [标签名] [属性名] [属性值] [输入 axml] [输出 axml]

示例： tinyaxml attr -i application debuggable true AndroidManifest.xml

在 application 标签中插入 android:debuggable="true" 属性, 让程序处于可调试状态

删除属性

tinyaxml attr -r [标签名] [属性名] [输入 axml] [输出 axml]

示例： tinyaxml attr -r application allowBackup AndroidManifest.xml AndroidManifest_out.xml

在 application 标签中删除 allowBackup 属性, 这样此 app 就可以进行沙盒数据备份

更改属性

tinyaxml attr -m [标签名] [属性名] [属性值] [输入 axml] [输出 axml]

示例： tinyaxml attr -m application debuggable true AndroidManifest.xml AndroidManifest_out.xml

在 application 标签中修改 android:debuggable 属性为 true, 让程序处于可调试状态

插入标签

tinyaxml tag -i [需要插入标签内容的 xml 文件] [输入 axml] [输出 axml]

示例： tinyaxml tag -i inserting.xml AndroidManifest.xml AndroidManifest_out.xml

因为插入标签时内容比较多, 命令行方式不方便, 直接输入一个需要插入标签内容的 xml 文件即可

删除标签

tinyaxml tag -r [标签名] [输入 axml] [输出 axml]

示例： tinyaxml tag -r activity android.demo.MainActivity AndroidManifest.xml

删除 android:name="android.demo.MainActivity" 标签

序列化/反序列化 AXML

tinyaxml dump [输入 axml]

示例： tinyaxml dump AndroidManifest.xml

将 AndroidManifest.xml 反序列化输出到 AndroidManifest.xml.text 文本

tinyaxml build [输入 serialized object] [输出 axml]

示例： tinyaxml build AndroidManifest.xml

将 AndroidManifest.xml.text 序列化输出到 AndroidManifest.xml

执行插件

java -jar tinyaxml-*.jar [class name] [input file] (output file)

AXMLEditor 将反射加载初始化插件类, 调用其中的 AxmlFile process(AxmlFile) 方法, 将结果序列化输出

算法

tinyaxml 一般只接受长度在 1 以上的参数 (至少有 plugin)

但其实它可以接受更多! 如果长度为 0:

如果 class name 以 .class 结尾, 检查文件是否存在 如果存在就是这个类, 否则
在插件目录 $TINYAXML_PLUG 下寻找 `missing_argument.class`
尝试加载这个类, 如果失败显示加载错误退出
尝试寻找类中的 public static void main(String[]) 方法, 以自己的 args 调用
如果失败显示插件方法查找错误退出
然后正常退出

如果长度为 1, 参数 1 为插件名称, 调用插件的 main 方法

如果长度为 2, 默认参数 1 是插件名, 2 是输入文件, 输入输出为同一文件

推断插件参数 or 输入文件：
检查 args[1] 是否是文件
如果不是即是插件参数, 调用 main 方法

如果长度为 3, 默认参数 1 是插件名, 2 和 3 分别是 I/O 文件

推断插件参数 or 输入文件：
检查 args[-2] 是否是文件
如果不是即是插件参数, 否则是输入文件
检查 args[-1] 是否是文件
如果不是即是插件参数, 否则是输出文件, 如果没有输入文件就作为输出文件

同时指定文件 I/O 或指定输入以使用默认推导, 如果没有写出就不使用 process 方法, 转而尝试 main 方法

如果没有找到 AxmlFile process(AxmlFile, String[]) 或 void process(AxmlFile, String[]), 就使用 argv[1..-1] 调用插件类的 void main(String[]) 方法

如果发现有无返回值的 process 方法, 不使用输出.

如果输出时发生错误, tinyaxml 会尝试标准输出 System.out