Windows 上的安卓应用运行器:双击 APK 即装,应用以独立窗口与桌面图标运行,自持 QEMU 运行时
'use strict';
/**
* Android 二进制 XML(AXML) 解析器
* AndroidManifest.xml 在 APK 内是编译后的二进制格式,无法直接当文本读。
* 这里实现字符串池 + 元素/属性树解析,输出普通的 DOM 结构。
*/
const RES_STRING_POOL_TYPE = 0x0001;
const RES_XML_TYPE = 0x0003;
const RES_XML_START_NAMESPACE = 0x0100;
const RES_XML_END_NAMESPACE = 0x0101;
const RES_XML_START_ELEMENT = 0x0102;
const RES_XML_END_ELEMENT = 0x0103;
const RES_XML_CDATA = 0x0104;
const RES_XML_RESOURCE_MAP = 0x0180;
const TYPE_NULL = 0x00;
const TYPE_REFERENCE = 0x01;
const TYPE_STRING = 0x03;
const TYPE_INT_DEC = 0x10;
const TYPE_INT_HEX = 0x11;
const TYPE_INT_BOOLEAN = 0x12;
const ANDROID_NS = 'http://schemas.android.com/apk/res/android';
function readStringPool(buf, start) {
const type = buf.readUInt16LE(start);
if (type !== RES_STRING_POOL_TYPE) throw new Error('字符串池类型错误');
const headerSize = buf.readUInt16LE(start + 2);
const chunkSize = buf.readUInt32LE(start + 4);
const count = buf.readUInt32LE(start + 8);
const flags = buf.readUInt32LE(start + 16);
const stringsStart = buf.readUInt32LE(start + 20);
const isUtf8 = (flags & 0x100) !== 0;
const offsets = [];
for (let i = 0; i < count; i++) {
offsets.push(buf.readUInt32LE(start + headerSize + i * 4));
}
const base = start + stringsStart;
const strings = new Array(count);
for (let i = 0; i < count; i++) {
let p = base + offsets[i];
if (isUtf8) {
// utf16 长度(1~2 字节)
let len = buf[p++];
if (len & 0x80) { len = ((len & 0x7f) << 8) | buf[p++]; }
// utf8 字节长度
let byteLen = buf[p++];
if (byteLen & 0x80) { byteLen = ((byteLen & 0x7f) << 8) | buf[p++]; }
strings[i] = buf.toString('utf8', p, p + byteLen);
} else {
let len = buf.readUInt16LE(p); p += 2;
if (len & 0x8000) {
len = ((len & 0x7fff) << 16) | buf.readUInt16LE(p); p += 2;
}
strings[i] = buf.toString('utf16le', p, p + len * 2);
}
}
return { strings, chunkSize };
}
/**
* @returns {{name:string, attrs:Array, children:Array}}
*/
function parseAxml(buffer) {
const buf = buffer;
if (buf.readUInt16LE(0) !== RES_XML_TYPE) {
throw new Error('不是 Android 二进制 XML(可能被混淆或非法 APK)');
}
let pos = buf.readUInt16LE(2); // headerSize
const total = buf.readUInt32LE(4);
let pool = [];
const nsStack = []; // uri
const prefixByUri = new Map();
const root = { name: '#document', attrs: [], children: [], parent: null };
const stack = [root];
while (pos + 8 <= total && pos < buf.length) {
const type = buf.readUInt16LE(pos);
const headerSize = buf.readUInt16LE(pos + 2);
const chunkSize = buf.readUInt32LE(pos + 4);
if (chunkSize <= 0) break;
if (type === RES_STRING_POOL_TYPE) {
pool = readStringPool(buf, pos).strings;
} else if (type === RES_XML_START_NAMESPACE || type === RES_XML_END_NAMESPACE) {
const prefixIdx = buf.readUInt32LE(pos + 16);
const uriIdx = buf.readUInt32LE(pos + 20);
if (type === RES_XML_START_NAMESPACE) {
nsStack.push(pool[uriIdx]);
prefixByUri.set(pool[uriIdx], pool[prefixIdx]);
} else {
nsStack.pop();
}
} else if (type === RES_XML_START_ELEMENT) {
const nameIdx = buf.readUInt32LE(pos + 20);
const attrStart = buf.readUInt16LE(pos + 24);
const attrSize = buf.readUInt16LE(pos + 26);
const attrCount = buf.readUInt16LE(pos + 28);
const node = { name: pool[nameIdx], attrs: [], children: [], parent: stack[stack.length - 1] };
// attributeStart 相对 ResXMLTree_attrExt(chunk + 16)起算
const attrBase = pos + 16 + attrStart;
for (let i = 0; i < attrCount; i++) {
const a = attrBase + i * attrSize;
const nsIdx = buf.readUInt32LE(a);
const aNameIdx = buf.readUInt32LE(a + 4);
const rawIdx = buf.readUInt32LE(a + 8);
const dataType = buf.readUInt8(a + 15);
const data = buf.readUInt32LE(a + 16);
const ns = nsIdx === 0xffffffff ? '' : pool[nsIdx];
const name = pool[aNameIdx];
let value = null;
let refId = null;
if (rawIdx !== 0xffffffff) {
value = pool[rawIdx];
} else if (dataType === TYPE_STRING) {
value = pool[data];
} else if (dataType === TYPE_REFERENCE) {
refId = data >>> 0;
value = null;
} else if (dataType === TYPE_INT_BOOLEAN) {
value = data !== 0;
} else if (dataType === TYPE_INT_DEC || dataType === TYPE_INT_HEX) {
value = data | 0;
}
node.attrs.push({
ns, prefix: ns ? (prefixByUri.get(ns) || '') : '',
name, value, refId, dataType,
typed: dataType === TYPE_REFERENCE ? null : value,
});
}
stack[stack.length - 1].children.push(node);
stack.push(node);
} else if (type === RES_XML_END_ELEMENT) {
if (stack.length > 1) stack.pop();
}
pos += chunkSize;
}
const el = root.children.find((c) => c.name === 'manifest') || root.children[0];
if (!el) throw new Error('APK 清单为空');
return el;
}
function attr(node, name, ns = ANDROID_NS) {
if (!node) return null;
return node.attrs.find((a) => a.name === name && (ns === null ? true : a.ns === ns)) || null;
}
function attrValue(node, name, ns = ANDROID_NS) {
const a = attr(node, name, ns);
return a ? a.typed : null;
}
function children(node, name) {
if (!node) return [];
return node.children.filter((c) => c.name === name);
}
module.exports = { parseAxml, attr, attrValue, children, ANDROID_NS, TYPE_REFERENCE };