Skip to content

Windows 上的安卓应用运行器:双击 APK 即装,应用以独立窗口与桌面图标运行,自持 QEMU 运行时

11.7 KB
Raw Blame
'use strict';
/**
 * 本地持久化:应用清单 + 设置
 * 数据目录:%APPDATA%\apkstart
 */
const fs = require('fs');
const path = require('path');
const os = require('os');

const DATA_DIR = path.join(process.env.APPDATA || path.join(os.homedir(), 'AppData', 'Roaming'), 'apkstart');
const ICON_DIR = path.join(DATA_DIR, 'icons');
const APK_DIR = path.join(DATA_DIR, 'apks');
const APPS_FILE = path.join(DATA_DIR, 'apps.json');
const SETTINGS_FILE = path.join(DATA_DIR, 'settings.json');

const DEFAULT_SETTINGS = {
  adbPath: '',
  device: '127.0.0.1:5555',
  engine: {
    mode: 'builtin',         // builtin(自带运行时,默认) | attach(连接已有运行时,高级)
    qemuPath: '',
    systemImage: '',
    memoryMB: 0,             // 0 = 由 doctor 按机器内存自动决定
    cores: 0,                // 0 = 自动
    autoMemory: true,        // 零配置:自动推导内存/核心/磁盘/渲染参数
    idleShutdownMinutes: 15,
    startVisible: true,
    // 必须带窗口:无头模式 SurfaceFlinger 不出 VSYNC,应用进程活着但屏幕上什么都没有。
    // 带窗口的模拟器是原生 60fps + 原生鼠标键盘,ApkStart 只负责把它打扮成应用窗口。
    headless: false,
    gpuMode: 'auto',         // auto = 按 emulator 版本自动挑后端并逐级降级
    // 上次「拉起就崩」的渲染后端(格式 `<emulator版本>|<gpu>`);auto 模式下下次把它排到最后,
    // 免得每次开机都先白等 20 多秒再退到软件渲染。升级运行时会自动失效。
    badGpu: '',
    forceTcg: false,         // 保留给高级排障;正常路径已由 doctor 自动回退
    audio: true,             // 安卓应用的声音(提示音/视频)。关闭可省一点 CPU
    // ---- 轻量容器(默认全开省资源,用户可逐项关掉)----
    liteMode: true,          // 收敛 vCPU 配额,避免 qemu 占满物理核拖慢 Windows
    // 一句话策略:save(省资源)/ balanced(均衡)/ smooth(流畅,视频·游戏优先)。
    // 界面上只暴露这一个选项,保存时自动翻译成 liteMode / priorityMode / renderSize,
    // 底部仍然保留细项开关给高级用户。
    resourceMode: 'balanced',
    // 数据分区容量(GB):应用、游戏缓存和它们的更新包都装在这里。
    // 0 = 自动(按磁盘剩余给 6/8GB)。改大后在下次开安卓时**就地扩容**,不丢已装应用。
    dataPartitionGB: 0,
    // 渲染分辨率:越低越流畅、越省电;auto = 按加速状态选 720x1280 / 540x960
    renderSize: 'auto',
    // 网络加速:给模拟器指定国内公共 DNS。安卓默认的 10.0.2.3 要走主机 DNS,
    // VPN / 公司网 / 某些运营商下解析会拖到几百毫秒,视频类应用首屏会明显发卡。
    fastDns: true,
    // 快照:quickboot 内存快照让二次启动只要几秒,代价是磁盘上多一份约 2~3GB 的
    // ram.bin。磁盘紧张时可以关掉(只影响启动速度,不影响应用数据)。
    keepSnapshot: true,
    // 日志上限(KB):超过就滚动备份一份,避免长期使用把磁盘写满
    logLimitKB: 2048,
    // 鼠标键位:左键由模拟器原生映射为「确认/点击」,无需开关。
    // 右键返回与平滑滚轮需要低级钩子,但只在应用窗口前台时装,失焦即卸载。
    mouseRightBack: true,    // 右键 = 安卓返回(拦下 Qt 默认的「右键也当点击」误触)
    mouseWheelMode: 'smooth', // smooth = 合并后注入一次滑动 | native = 交给 Qt | off = 不处理
    mouseSideButtons: false, // 侧键返回/前进:默认关闭,开启才多装一项映射
    deepTrim: false,         // 深度裁剪系统后台包(Play 商店/向导等),默认不动系统
    // balanced=让出前台 | performance=qemu Normal | game=qemu High + 低延迟输入
  priorityMode: 'balanced',
    // 预热:启动 ApkStart 后在后台把安卓环境引导好,第一次点应用几乎不用等。
    // 代价是常驻约 1GB 内存(和 WSA / 应用宝电脑版一样的取舍),可随时关掉。
    prewarm: true,
  },
  runtime: {
    dir: '',                 // 空 = %APPDATA%\apkstart\runtime
    qemuUrl: '',             // 手动指定 QEMU 安装包地址
    isoUrl: '',              // 手动指定系统镜像地址
    isoPath: '',             // 系统镜像(ISO)路径
    diskPath: '',            // 安装系统的虚拟磁盘
    diskSizeGB: 24,
    headless: false,         // 不显示虚拟机窗口(仅调试)
    installMode: 'guided',   // guided(引导手动安装) | auto(实验性自动安装)
    emulatorUrl: '',         // 手动指定 emulator 包地址(空 = 自动从 SDK 索引解析最新版)
    sysimgUrl: '',           // 手动指定系统镜像包地址
    compatImage: false,      // ARM 兼容模式:改用 Google Play 镜像(内置 native bridge,可装 ARM-only 应用)
    // 轻量版的运行时整包:默认从本项目 GitHub Release 下载(与「软件更新」同源),
    // 拿不到时自动退回 dl.google.com 分组件下载。可在这里换成自建镜像地址。
    preferGithubRuntime: true,
    runtimePackUrl: '',
    // GitHub 加速镜像前缀(可选)。国内直连 GitHub Releases 经常只有几十 KB/s,
    // 填成 https://ghfast.top/ 之类的镜像前缀即可把 downloads 请求转过去。
    // 留空 = 直连(也会先用 8 线程分块试,能跑满带宽)。
    mirrorPrefix: '',
    // 下载并发数:分块下载的连接数。默认 8,弱网/被限速时可调到 16。
    downloadConnections: 8,
    // 更新/下载的源选择。auto = 同时问 GitHub 与 Gitee、并对每个下载地址实测
    // 128KB 速度,谁快用谁;也可以强制只走某一边(企业网络只放行一个域名时有用)。
    sourcePreference: 'auto',
    // 自动尝试公共 GitHub 加速镜像(ghfast / gh-proxy)。关掉后只用直连 + 自定义前缀。
    // 这两个是第三方服务,只是转发公开的 release 文件,不涉及账号信息。
    autoMirror: true,
    // Gitee 的 releases 接口对公开仓库也要求 access_token(无 token 直接 404),
    // 想用 Gitee 作为更新源就在这里填一个只读 token;留空则只用 GitHub + 镜像。
    giteeToken: '',
  },
  sharedDir: path.join(os.homedir(), 'ApkStartShared'),
  deviceSharedDir: '/sdcard/ApkStartShared',
  autoConnect: true,
  createShortcutOnInstall: true,
  createStartMenuShortcut: true, // 开始菜单快捷方式 = 让 Windows 搜索能搜到应用
  shortcutDir: '',           // 空 = 桌面
  freeform: false,           // 共享一个运行时窗口,不再用 Android freeform 小窗
  hideAfterLaunch: false,    // 主进程必须常驻,否则一退出就把 Android 运行时杀掉了
  notifyOnInstall: true,
  autoStart: true,           // 开机自启,默认开启,用户无需设置
  autoDeploy: true,          // 首次运行自动完成全部部署,不再分 1~5 步
  // 启动欢迎卡:lastDate 记录上次自动弹出的日期(手动打开时一天最多一次),
  // disabled = 用户勾了「不再自动弹出」。
  welcome: { lastDate: '', disabled: false },
  display: {
    mode: 'window',          // window(竖屏窗口,可自由拉伸) | fullscreen(自动适配屏幕)
    portrait: '900x1600',    // 窗口模式的竖屏分辨率,可在设置里调大小
    density: 0,              // 0 = 按分辨率自动推导
    rememberBounds: true,    // 记住每个应用的窗口位置/大小
    autoFullscreenOnLaunch: false,
    // 横屏 = 把 AVD 物理面板换成 1280x720 并重启(唯一能得到正立+铺满的方式)。
    // 持久化在这里,重启 ApkStart 后仍按这个方向开机。
    landscape: false,
  },
};

function ensureDirs() {
  for (const d of [DATA_DIR, ICON_DIR, APK_DIR]) {
    if (!fs.existsSync(d)) fs.mkdirSync(d, { recursive: true });
  }
}

function readJson(file, fallback) {
  try {
    let text = fs.readFileSync(file, 'utf8');
    // 去掉可能的 UTF-8 BOM。带 BOM 时 JSON.parse 会直接抛错,于是整个配置
    // 静默回落到默认值 —— 用户会看到「设置全丢了」,却完全不知道为什么。
    // 这个文件会被设置页、同步工具、甚至用户手工编辑,必须容忍 BOM。
    if (text.charCodeAt(0) === 0xfeff) text = text.slice(1);
    return JSON.parse(text);
  } catch (_) {
    return fallback;
  }
}

function writeJson(file, data) {
  ensureDirs();
  const tmp = file + '.tmp';
  fs.writeFileSync(tmp, JSON.stringify(data, null, 2), 'utf8');
  fs.renameSync(tmp, file);
}

function deepMerge(base, patch) {
  const out = { ...base };
  for (const [k, v] of Object.entries(patch || {})) {
    if (v && typeof v === 'object' && !Array.isArray(v) && base[k] && typeof base[k] === 'object') {
      out[k] = deepMerge(base[k], v);
    } else {
      out[k] = v;
    }
  }
  return out;
}

/**
 * 资源策略 → 具体开关。
 *   save     :2 vCPU + 低优先级 + 540x960,老笔记本 / 挂机用;
 *   balanced :vCPU 取物理核的一半(2~4)+ 让出前台 + 720x1280;
 *   smooth   :不限制 vCPU + 与前台同优先级 + 720x1280,视频与游戏优先。
 * 分辨率先不动 1080p:quickboot 快照指纹与它绑定,改一次就要重冷启动,而 720p
 * 在手机比例的窗口里已经看不出区别,性能却差一档。
 */
function resourcePreset(mode) {
  switch (String(mode || '')) {
    case 'save':
      return { resourceMode: 'save', liteMode: true, priorityMode: 'balanced', renderSize: '540x960' };
    case 'smooth':
      return { resourceMode: 'smooth', liteMode: false, priorityMode: 'game', renderSize: '720x1280' };
    case 'balanced':
    default:
      return { resourceMode: 'balanced', liteMode: true, priorityMode: 'balanced', renderSize: 'auto' };
  }
}

const store = {
  DATA_DIR, ICON_DIR, APK_DIR,

  getSettings() {
    const s = deepMerge(DEFAULT_SETTINGS, readJson(SETTINGS_FILE, {}));
    // 旧版本默认无头运行:应用进程能起来但屏幕上没有窗口,等效于「打不开」。
    // 无条件迁移到带窗口模式,且不再允许通过旧配置把它关掉。
    s.engine.headless = false;
    // 旧版本退出壳层时会杀掉整个 Android 运行时,导致桌面图标点开闪一下就没了。
    s.hideAfterLaunch = false;
    // 旧版本用 Android freeform 小窗,现在整个模拟器窗口就是应用窗口,
    // 应用必须铺满这块屏幕,否则会出现「窗口里再套一个小窗」。
    s.freeform = false;
    return s;
  },

  saveSettings(patch) {
    const next = deepMerge(this.getSettings(), patch);
    // 只改了「资源策略」时,把它翻译成具体的三个开关,避免两套配置各说各话
    if (patch && patch.engine && patch.engine.resourceMode) {
      Object.assign(next.engine, resourcePreset(next.engine.resourceMode));
    }
    writeJson(SETTINGS_FILE, next);
    return next;
  },

  getApps() {
    const data = readJson(APPS_FILE, { apps: [] });
    return Array.isArray(data.apps) ? data.apps : [];
  },

  saveApps(apps) {
    writeJson(APPS_FILE, { apps });
  },

  upsertApp(app) {
    const apps = this.getApps();
    const i = apps.findIndex((a) => a.package === app.package);
    if (i >= 0) apps[i] = { ...apps[i], ...app };
    else apps.push(app);
    this.saveApps(apps);
    return app;
  },

  removeApp(pkg) {
    const apps = this.getApps().filter((a) => a.package !== pkg);
    this.saveApps(apps);
  },

  getApp(pkg) {
    return this.getApps().find((a) => a.package === pkg) || null;
  },

  iconPath(pkg) {
    return path.join(ICON_DIR, `${pkg}.png`);
  },

  apkPath(pkg, version = 'cur') {
    return path.join(APK_DIR, `${pkg}-${version}.apk`);
  },

  ensureDirs,
  DEFAULT_SETTINGS,
};

module.exports = store;