 admin
|
34f0db215c
|
Mac 后台常驻（隐藏 Dock + 关窗续跑）：引擎 / 监听上移 App 级
实现②隐藏 Dock 图标 + ③可靠后台刷新，交付单窗口、可后台常驻的 App。
- 新增 MacBackgroundController（@MainActor App 级单例）：持有 engine + auth（脱离窗口 @State，生命周期与 App 一致）。把引擎离屏 WebView 挂常驻隐藏 NSWindow（始终在窗口层级、避 WebKit 无窗口挂起，且脱离主窗口生命周期——关主窗口引擎不销毁，SSE / presence / 传输 / 剪贴板续跑）+ App 级 ProcessInfo.beginActivity 防 App Nap + 按登录态启停剪贴板 monitor / 全局热键。observeAuth（withObservationTracking 桥 Observation→命令式）观察 auth.session 驱动 start/stop
- 新增 MacAppDelegate（@NSApplicationDelegateAdaptor）：applicationDidFinishLaunching 应用 Dock 策略 + bootstrap 后台运行时；applicationShouldTerminateAfterLastWindowClosed=false——关最后一个窗口不退出，菜单栏常驻续跑
- CommilitiaDropMacApp：engine / auth 改由 MacBackgroundController 持有（不再窗口 @State）；MacAppRoot 只做登录门界面切换、不挂引擎生命周期。MacRootView 移除内嵌 EngineWebView + 移除窗口 onAppear/onDisappear 的 monitor/hotkey（全上移 controller）——关窗引擎 / 同步 / 热键不再停
- 设置加「后台」区：隐藏 Dock 图标开关（@AppStorage macHideDock → NSApp.setActivationPolicy .accessory/.regular，默认 regular 显示）+ 后台常驻说明；剪贴板自动同步开关改调 controller.refreshClipboardMonitor；登出只 auth.logout（引擎复位交 controller 随会话变 nil 统一处理）。菜单栏「打开主窗口」先 NSApp.activate 再 openWindow（accessory / 关窗后窗口可前置可见）
- 三项能力齐备：①菜单栏图标（既有 MenuBarExtra）②隐藏 Dock（新增，可设置切换）③可靠后台刷新（新增：引擎 / monitor / 热键 App 级持有 + 隐藏窗口托 WebView + App 级 App Nap 防护 + 关窗不退出续跑）
- 验证：just mac-build（CommilitiaDropMac.app）+ iOS 模拟器（CommilitiaDrop.app）均 BUILD SUCCEEDED；ad-hoc 启动冒烟通过（进程存活、无崩溃报告、干净退出）。运行期后台同步须用户登录后自测（Broker OAuth 需账号）
|
2026-07-11 12:26:34 +08:00 |
|
|
admin
|
512d7563ee
|
原生 macOS 引擎 + Broker 登录接通（Phase 3a）
- 引擎 / 鉴权跨平台 in-place（iOS 路径 #if 守卫、逐字不变，仅加 macOS/AppKit 分支）：EngineController（import 守卫 + 剪贴板 UIPasteboard→NSPasteboard 上下行两处 + device_type 平台条件）、EngineWebView（UIViewRepresentable→typealias 统一后分 NSViewRepresentable）、Theme（动态色 Color(nsColor:dynamicProvider) 同 RGB）、DeviceNameStore（Host.current().localizedName）、PushRegistry（NSApplication.registerForRemoteNotifications）、Auth/BrokerLogin（presentationAnchor→NSApplication.keyWindow）、Auth/AuthManager（死 import UIKit 守卫）
- BackgroundTaskManager：整文件 #if os(iOS)（BGContinuedProcessingTask 为 API_UNAVAILABLE(macos)、编译级拒绝）+ macOS 同签名 no-op stub，使 EngineController.syncBackgroundTask 调用点无须改动
- device_type 修正（非机械）：Mac 原生客户端 boot 注入 device_type=macos（与桌面 Wails 客户端一致，后端 / 各端已识别），不再硬编 ios——否则其他端设备列表图标错、且触发其 isWakeable 的 contains("ios") 误判本 Mac 可推送唤醒
- CommilitiaDropMac target 纳入「引擎 + 登录」最小集：Shared + Sources/Engine + Sources/Auth（除 iOS 专属 LoginView）+ RecordsStore / PushRegistry / LocalNetworkPermission / DeviceNameStore / BackgroundTaskManager + Resources/i18n；依赖 WebRTC；Info.plist 加 cdrop:// 回调 scheme（ASWebAuthenticationSession OAuth 回调）+ 本地网络（NSLocalNetworkUsageDescription / NSBonjourServices _cdrop._tcp）
- Mac 壳接引擎：CommilitiaDropMacApp（@State auth + engine，MacAppRoot 登录门 + 会话激活分桶记录）、MacLoginView（Broker 账户登录，免相机）、MacRootView（背景挂离屏引擎 WebView 保活 + 设备真实 presence 列表 + 设置账号/登出/引擎日志）、MacMenuContent（账号 + 在线设备数）。传输/文件/消息详情暂占位，随 Phase 3b 复用 iOS 视图
- 验证：just mac-build（CommilitiaDropMac.app）+ iOS 模拟器（CommilitiaDrop.app）均 BUILD SUCCEEDED。运行期登录 / 引擎联通待真机自测（Broker OAuth 需账号交互）
|
2026-07-07 22:22:30 +08:00 |
|
|
admin
|
29e5c0a739
|
原生 macOS 客户端脚手架 + 元数据完整命名去缩写
- 命名去缩写：xcodegen 项目 + 四 target CDrop*→CommilitiaDrop*（CommilitiaDrop / …Share / …Widgets / …Tests）；3 个 widget/control kind net.commilitia.cdrop.*→net.commilitia.Commilitia-Drop.*（旧装控件将成孤儿，需在设备重加）；Tests @testable import CommilitiaDrop。刻意不动线协议 / 身份标识——bundle ID 家族、URL scheme cdrop://、Bonjour _cdrop._tcp、keychain service、DataChannel cdrop-file、entitlements 文件名——以免破跨端互通或丢会话
- 新增 macOS app target CommilitiaDropMac（platform macOS / deploymentTarget 26.0 / ARCHS arm64 / 与 iOS 同 bundle net.commilitia.Commilitia-Drop，同 App Store 记录 + 同 App Group）：sources 仅 MacApp/，Info.plist 经 xcodegen 生成，本地 ad-hoc 免账号编译
- Mac 壳 MacApp/（Allman，#if os(macOS) 守卫，独立 @main 不与 iOS CDropApp 冲突）：CommilitiaDropMacApp（@main + 单窗口 Window + windowResizability contentMinSize + 去 ⌘N + MenuBarExtra window 风格）、MacRootView（NavigationSplitView 侧栏五区骨架 传输/文件/消息/设备/设置 + 占位详情 MacPlaceholder + 品牌头）、MacMenuContent（菜单栏占位）
- Support/macOS/AppMac.entitlements：App Group group.net.commilitia.Commilitia-Drop 预置待用；macOS 下 App Group 属受限能力须 provisioning profile，故脚手架阶段 project.yml 暂不引用，待 Phase 6 Developer ID 签名再挂
- 根 Justfile：ios-sim-build / ios-device 跟随重命名（项目 / scheme / .app 路径）；新增 mac-build（xcodegen + xcodebuild -sdk macosx，本地 ad-hoc）
- 验证：CommilitiaDropMac.app 与 CommilitiaDrop.app（iOS 模拟器）均 BUILD SUCCEEDED；WebRTC 走 -clonedSourcePackagesDirPath 复用已缓存 xcframework
|
2026-07-07 21:43:51 +08:00 |
|