Phase 4 剩余三项: - 首次引导向导(setup/first_run + ui/setup_wizard):服务自检(含 C# 助手共存 提示)→ 打印机检测与 HiTi 驱动安装指引(官网链接/重新检测,mac 与 win 文案 分支,允许无打印机完成)→ 开机自启开关 + scheme 注册;侧栏底部常驻设置区 (自启开关 + 重新运行引导) - 开机自启(setup/autostart):mac 写 LaunchAgent(RunAtLoad 一次性,不用 KeepAlive——托盘退出不能被拉回);Windows 走 HKCU Run(reg 命令免 win32 依赖) - URL scheme 闭环:单实例唤醒端口 38210(setup/single_instance)——zaxprint:// 唤起或重复双击启动第二进程时通知常驻实例弹窗后自退,跨平台一致(弃用 app_links 的 mac 事件转发不确定性);Windows 启动时幂等注册 HKCU scheme; 前端 cardPrinter.ts 加 launchAgent()(zaxprint://open),开卡抽屉离线时显示 "启动打印助手"按钮,点击唤起后 1s×6 轮询自动上线(biz 前端改动待用户提交) Phase 5: - tool/package_macos.sh:构建 → ad-hoc 就地签名(--deep,勿加 --options=runtime: hardened runtime 库校验会因 ad-hoc 无 Team ID 拒载 framework,实测踩坑)→ hdiutil dmg;实测产出 22MB dmg + 签名后冒烟通过 - windows/installer.iss:Inno Setup 安装包脚本(快捷方式/桌面图标/开机自启 Tasks/zaxprint scheme 注册与卸载清理/HiTi SDK DLL 随 Release 目录打包) 依赖 +url_launcher +shared_preferences;13 测试全过、analyze 零问题。
102 lines
3.2 KiB
Dart
102 lines
3.2 KiB
Dart
import 'dart:io';
|
||
|
||
import '../utils/command_runner.dart';
|
||
|
||
/// 开机自启:mac 写 LaunchAgent(RunAtLoad 一次性——托盘退出不能被拉回,故不用 KeepAlive);
|
||
/// Windows 写 HKCU Run 注册表键(reg 命令实现,免 win32 依赖)。
|
||
/// 自启指向当前可执行文件(Platform.resolvedExecutable),以安装位置为准。
|
||
class Autostart {
|
||
static const macLabel = 'com.zax.desktop-plugin';
|
||
static const winRunName = 'ZaxDesktopPlugin';
|
||
|
||
static bool get isSupported => Platform.isMacOS || Platform.isWindows;
|
||
|
||
static String? get _macPlistPath {
|
||
final home = Platform.environment['HOME'];
|
||
if (home == null) return null;
|
||
return '$home/Library/LaunchAgents/$macLabel.plist';
|
||
}
|
||
|
||
/// 自启是否已开启。
|
||
static Future<bool> isEnabled() async {
|
||
if (Platform.isMacOS) {
|
||
final path = _macPlistPath;
|
||
return path != null && File(path).existsSync();
|
||
}
|
||
if (Platform.isWindows) {
|
||
final r = await runCommand(
|
||
'reg',
|
||
['query', r'HKCU\Software\Microsoft\Windows\CurrentVersion\Run', '/v', winRunName],
|
||
tolerateExit: true,
|
||
);
|
||
return r.contains(winRunName);
|
||
}
|
||
return false;
|
||
}
|
||
|
||
/// 开启自启(mac 顺带把 C# 助手的 LaunchAgent 状态返回,供向导提示端口关系)。
|
||
static Future<void> enable() async {
|
||
if (Platform.isMacOS) {
|
||
final path = _macPlistPath;
|
||
if (path == null) throw StateError('无法定位用户目录');
|
||
final exe = Platform.resolvedExecutable;
|
||
await Directory(File(path).parent.path).create(recursive: true);
|
||
await File(path).writeAsString('''
|
||
<?xml version="1.0" encoding="UTF-8"?>
|
||
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
|
||
<plist version="1.0">
|
||
<dict>
|
||
<key>Label</key>
|
||
<string>$macLabel</string>
|
||
<key>ProgramArguments</key>
|
||
<array>
|
||
<string>$exe</string>
|
||
</array>
|
||
<key>RunAtLoad</key>
|
||
<true/>
|
||
<key>LaunchOnlyOnce</key>
|
||
<true/>
|
||
</dict>
|
||
</plist>
|
||
''');
|
||
return;
|
||
}
|
||
if (Platform.isWindows) {
|
||
final exe = Platform.resolvedExecutable;
|
||
await runCommand('reg', [
|
||
'add', r'HKCU\Software\Microsoft\Windows\CurrentVersion\Run',
|
||
'/v', winRunName, '/t', 'REG_SZ', '/d', '"$exe"', '/f',
|
||
]);
|
||
return;
|
||
}
|
||
throw UnsupportedError('当前平台不支持开机自启');
|
||
}
|
||
|
||
static Future<void> disable() async {
|
||
if (Platform.isMacOS) {
|
||
final path = _macPlistPath;
|
||
if (path != null && File(path).existsSync()) {
|
||
await File(path).delete();
|
||
}
|
||
return;
|
||
}
|
||
if (Platform.isWindows) {
|
||
await runCommand(
|
||
'reg',
|
||
['delete', r'HKCU\Software\Microsoft\Windows\CurrentVersion\Run', '/v', winRunName, '/f'],
|
||
tolerateExit: true, // 不存在时也算关闭成功
|
||
);
|
||
return;
|
||
}
|
||
throw UnsupportedError('当前平台不支持开机自启');
|
||
}
|
||
|
||
/// C# 版助手的 LaunchAgent 是否在(本机灰度共存提示用;mac only)。
|
||
static bool get legacyCsharpAgentInstalled {
|
||
if (!Platform.isMacOS) return false;
|
||
final home = Platform.environment['HOME'];
|
||
return home != null &&
|
||
File('$home/Library/LaunchAgents/com.zax.cardprinteragent.plist').existsSync();
|
||
}
|
||
}
|