Windows 上的安卓应用运行器:双击 APK 即装,应用以独立窗口与桌面图标运行,自持 QEMU 运行时
'use strict';
/**
* 桌面快捷方式 + 多尺寸 ICO 生成
*
* ICO 直接用 Electron nativeImage 缩放并手写 ICO 容器(DIB 格式,全 Windows 版本兼容),
* 不依赖任何第三方图像库,也不需要 ImageMagick。
*/
const fs = require('fs');
const path = require('path');
const ICO_SIZES = [16, 20, 24, 32, 40, 48, 64, 128, 256];
function buildDib(bgra, size) {
const header = Buffer.alloc(40);
header.writeUInt32LE(40, 0); // biSize
header.writeInt32LE(size, 4); // biWidth
header.writeInt32LE(size * 2, 8); // biHeight = XOR + AND
header.writeUInt16LE(1, 12); // biPlanes
header.writeUInt16LE(32, 14); // biBitCount
header.writeUInt32LE(0, 16); // BI_RGB
header.writeUInt32LE(size * size * 4, 20);
// XOR 位图:自下而上,行内 BGRA
const xor = Buffer.alloc(size * size * 4);
for (let y = 0; y < size; y++) {
const srcRow = (size - 1 - y) * size * 4;
bgra.copy(xor, y * size * 4, srcRow, srcRow + size * 4);
}
// AND 掩码:1bpp,行按 4 字节对齐,全 0(交给 alpha 通道)
const maskRow = Math.ceil(size / 32) * 4;
const mask = Buffer.alloc(maskRow * size, 0);
return Buffer.concat([header, xor, mask]);
}
/**
* @param {Buffer} pngBuffer 任意尺寸的 PNG
* @returns {Buffer|null} ICO 文件内容
*/
function pngToIco(pngBuffer) {
const { nativeImage } = require('electron');
const base = nativeImage.createFromBuffer(pngBuffer);
if (!base || base.isEmpty()) return null;
const images = [];
for (const s of ICO_SIZES) {
const img = base.getSize().width >= s
? base.resize({ width: s, height: s, quality: 'best' })
: base.resize({ width: s, height: s, quality: 'best' }); // 小图放大也比缺尺寸好
const dib = buildDib(img.toBitmap(), s);
images.push({ size: s, data: dib });
}
const dir = Buffer.alloc(6 + images.length * 16);
dir.writeUInt16LE(0, 0);
dir.writeUInt16LE(1, 2);
dir.writeUInt16LE(images.length, 4);
let offset = dir.length;
images.forEach((img, i) => {
const p = 6 + i * 16;
dir.writeUInt8(img.size >= 256 ? 0 : img.size, p);
dir.writeUInt8(img.size >= 256 ? 0 : img.size, p + 1);
dir.writeUInt8(0, p + 2);
dir.writeUInt8(0, p + 3);
dir.writeUInt16LE(1, p + 4);
dir.writeUInt16LE(32, p + 6);
dir.writeUInt32LE(img.data.length, p + 8);
dir.writeUInt32LE(offset, p + 12);
offset += img.data.length;
});
return Buffer.concat([dir, ...images.map((i) => i.data)]);
}
function safeFileName(name) {
return String(name).replace(/[\\/:*?"<>|]/g, '_').replace(/\s+/g, ' ').trim().slice(0, 60) || 'Android App';
}
/**
* PNG-in-ICO:Vista 起 ICO 条目允许直接内嵌 PNG,不用重编码、不丢 alpha。
* APK 图标常是 WebP/大尺寸 PNG,老的 DIB 路线在这里会整包失败。
*/
function pngBytesToIco(png) {
if (!Buffer.isBuffer(png) || png.length < 24 || png.toString('ascii', 1, 4) !== 'PNG') return null;
const w = png.readUInt32BE(16);
const h = png.readUInt32BE(20);
if (!w || !h || w > 1024 || h > 1024) return null;
const dir = Buffer.alloc(22);
dir.writeUInt16LE(0, 0);
dir.writeUInt16LE(1, 2);
dir.writeUInt16LE(1, 4);
dir.writeUInt8(w >= 256 ? 0 : w, 6);
dir.writeUInt8(h >= 256 ? 0 : h, 7);
dir.writeUInt8(0, 8);
dir.writeUInt8(0, 9);
dir.writeUInt16LE(1, 10);
dir.writeUInt16LE(32, 12);
dir.writeUInt32LE(png.length, 14);
dir.writeUInt32LE(22, 18);
return Buffer.concat([dir, png]);
}
/**
* 任意 APK 图标 → ICO。三级兜底,保证快捷方式永远带图标:
* 1) Electron 能直接解(真 PNG/JPEG)→ 多尺寸 DIB ICO;
* 2) decode 回调(渲染进程用 Chromium 解 WebP)→ PNG-in-ICO;
* 3) 品牌占位图标 → PNG-in-ICO。
*/
async function iconToIco(raw, { decode, onFallback } = {}) {
const fail = (why) => { try { if (onFallback) onFallback(why); } catch (_) { /* ignore */ } };
if (!Buffer.isBuffer(raw) || !raw.length) { fail('empty'); return null; }
try {
const { nativeImage } = require('electron');
const img = nativeImage.createFromBuffer(raw);
if (img && !img.isEmpty()) {
const ico = pngToIco(img.toPNG());
if (ico) return ico;
}
} catch (_) { /* 非 PNG/JPEG,走下一级 */ }
if (typeof decode === 'function') {
try {
const png = await decode(raw);
const ico = pngBytesToIco(png);
if (ico) return ico;
fail('decode-output-invalid');
} catch (_) { fail('webp-decode-failed'); }
} else {
fail('no-decoder');
}
try {
const { drawAppIcon } = require('./png');
const ico = pngBytesToIco(drawAppIcon(256));
if (ico) { fail('placeholder'); return ico; }
} catch (_) { /* ignore */ }
return null;
}
/**
* 生成桌面快捷方式
*
* writeShortcutLink 返回 true 并不代表文件真的落盘了:安全软件拦截、
* 桌面目录被重定向到未登录的网盘时都可能「成功但没文件」。所以写完必须
* 回读一次,保证调用方拿到的路径是真实存在的入口。
*
* @param {object} opt { shortcutPath, target, args, iconIcoPath, description, cwd }
*/
function writeShortcut(opt) {
const { shell } = require('electron');
const dir = path.dirname(opt.shortcutPath);
try {
if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
} catch (e) {
throw new Error(`快捷方式目录不可写:${dir}(${e.message})`);
}
if (fs.existsSync(opt.shortcutPath)) {
try { fs.unlinkSync(opt.shortcutPath); } catch (_) { /* ignore */ }
}
const ok = shell.writeShortcutLink(opt.shortcutPath, 'create', {
target: opt.target,
args: opt.args || '',
icon: opt.iconIcoPath || opt.target,
iconIndex: 0,
description: opt.description || '',
cwd: opt.cwd || path.dirname(opt.target),
appUserModelId: opt.appUserModelId,
});
if (!ok) throw new Error('创建快捷方式失败(writeShortcutLink 返回 false)');
if (!fs.existsSync(opt.shortcutPath)) {
throw new Error(`快捷方式未落盘:${opt.shortcutPath}`);
}
return opt.shortcutPath;
}
function removeShortcut(p) {
try {
if (p && fs.existsSync(p)) fs.unlinkSync(p);
return true;
} catch (_) {
return false;
}
}
module.exports = {
pngToIco, pngBytesToIco, iconToIco,
writeShortcut, removeShortcut, safeFileName, ICO_SIZES,
};