admin
512d7563ee
- 引擎 / 鉴权跨平台 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 需账号交互）
270 lines
12 KiB
YAML
270 lines
12 KiB
YAML
name: CommilitiaDrop
|
||
options:
|
||
bundleIdPrefix: net.commilitia
|
||
deploymentTarget:
|
||
iOS: "26.0"
|
||
macOS: "26.0"
|
||
createIntermediateGroups: true
|
||
# 源码以简体中文撰写；字符串目录承载 zh-Hant / en 翻译。语言跟随系统设置。
|
||
developmentLanguage: zh-Hans
|
||
# 原生数据面：iOS 走 libwebrtc（Safari 同款，与 iOS 网络栈原生集成）。预编译 xcframework 经
|
||
# stasel/WebRTC 以 SPM 分发，仅二进制 target，pin 精确版本避免上游 M 版跳变改 API。替换早先
|
||
# gomobile/pion 路径——pion 的 Go raw socket 不与 iOS Network framework 集成，真机确证不可靠
|
||
# （见 desktop/NATIVE-TRANSFER.md §7 / cdrop-native-data-plane 记忆）。libwebrtc 亦含 macOS 切片
|
||
# （macos-x86_64_arm64 + maccatalyst），故同一 LibWebRtcEngine 可在原生 Mac target 复用。
|
||
packages:
|
||
WebRTC:
|
||
url: https://github.com/stasel/WebRTC
|
||
exactVersion: 149.0.0
|
||
settings:
|
||
base:
|
||
SWIFT_VERSION: "5.0"
|
||
# 模拟器用 ad-hoc 签名（身份 "-"，无需 Apple 账号），使 App Group / Push 等 entitlement 在
|
||
# 模拟器实际生效（否则共享容器不创建、远程通知注册失败）。真机签名须付费 ADP 配
|
||
# team / provisioning profile（账号门控，见 REALDEVICE.md）。macOS 本地开发同走 ad-hoc。
|
||
CODE_SIGN_IDENTITY: "-"
|
||
CODE_SIGNING_REQUIRED: "NO"
|
||
CODE_SIGNING_ALLOWED: "YES"
|
||
targets:
|
||
CommilitiaDrop:
|
||
type: application
|
||
platform: iOS
|
||
deploymentTarget: "26.0"
|
||
sources:
|
||
- path: Sources
|
||
- path: Shared
|
||
dependencies:
|
||
- target: CommilitiaDropShare
|
||
embed: true
|
||
- target: CommilitiaDropWidgets
|
||
embed: true
|
||
# 原生数据面引擎（libwebrtc）：SPM 预编 xcframework，Xcode 自动嵌入 + 签名。仅主 app 链接——
|
||
# Share / 控件扩展不碰数据面，避免超扩展 120MB 内存限。见 LibWebRtcEngine.swift。
|
||
- package: WebRTC
|
||
info:
|
||
path: Sources/Info.plist
|
||
properties:
|
||
CFBundleDisplayName: Commilitia Drop
|
||
# 品牌字标字体 Fredoka SemiBold（Shared/Fonts/，随 bundle 打包），用于 Wordmark（与 web 一致）。
|
||
UIAppFonts:
|
||
- Fredoka-SemiBold.ttf
|
||
# cdrop:// URL scheme：Share Extension 交接后经 cdrop://share 深链唤起主 app 选设备发送。
|
||
CFBundleURLTypes:
|
||
- CFBundleURLName: net.commilitia.Commilitia-Drop
|
||
CFBundleURLSchemes:
|
||
- cdrop
|
||
# 声明支持的语言，使系统控件（EditButton 的「编辑」、滑动删除的「删除」等系统字符
|
||
# 串）跟随设备语言本地化，而非永远英文。开发区域设简体。
|
||
CFBundleDevelopmentRegion: zh-Hans
|
||
CFBundleLocalizations:
|
||
- zh-Hans
|
||
- zh-Hant
|
||
- en
|
||
UILaunchScreen: {}
|
||
# 界面方向：iPhone 竖屏 + 横屏（不含上下颠倒，遵 iPhone 惯例）；iPad 支持全部 4 向——通用 App
|
||
# 若不锁全屏（UIRequiresFullScreen 未设），iPad 多任务（Split View / Slide Over）要求支持全部方向，
|
||
# 否则构建告警「All interface orientations must be supported...」。
|
||
UISupportedInterfaceOrientations:
|
||
- UIInterfaceOrientationPortrait
|
||
- UIInterfaceOrientationLandscapeLeft
|
||
- UIInterfaceOrientationLandscapeRight
|
||
"UISupportedInterfaceOrientations~ipad":
|
||
- UIInterfaceOrientationPortrait
|
||
- UIInterfaceOrientationPortraitUpsideDown
|
||
- UIInterfaceOrientationLandscapeLeft
|
||
- UIInterfaceOrientationLandscapeRight
|
||
# 后台续传：BGContinuedProcessingTask 的通配标识符须在此声明，系统才允许注册 / 提交
|
||
# （见 BackgroundTaskManager）。默认资源（CPU + 网络）无需额外 entitlement。
|
||
BGTaskSchedulerPermittedIdentifiers:
|
||
- "net.commilitia.Commilitia-Drop.transfer.*"
|
||
# 远程通知后台模式：APNs 推送送达 / 后台处理（如「收到文件」通知）。
|
||
UIBackgroundModes:
|
||
- remote-notification
|
||
# 让接收文件落地的 Documents 目录在 Files app「我的 iPhone / Commilitia Drop」下
|
||
# 可见、可就地打开（收到的文件有处可开、可被其他 app 取用）。
|
||
UIFileSharingEnabled: true
|
||
LSSupportsOpeningDocumentsInPlace: true
|
||
NSAppTransportSecurity:
|
||
NSAllowsLocalNetworking: true
|
||
NSLocalNetworkUsageDescription: "Commilitia Drop 需要访问本地网络以发现同内网设备并建立直连传输。"
|
||
NSBonjourServices:
|
||
- "_cdrop._tcp"
|
||
NSCameraUsageDescription: "Commilitia Drop 使用相机扫描二维码登录新设备。"
|
||
# 图库选择：从相册选取图片 / 视频发送（PhotosPicker，见 RootView #14）。
|
||
NSPhotoLibraryUsageDescription: "Commilitia Drop 需要访问照片库，以便从相册选取图片或视频发送给其他设备。"
|
||
settings:
|
||
base:
|
||
PRODUCT_BUNDLE_IDENTIFIER: net.commilitia.Commilitia-Drop
|
||
TARGETED_DEVICE_FAMILY: "1,2"
|
||
ASSETCATALOG_COMPILER_APPICON_NAME: AppIcon
|
||
# APNs 推送的 aps-environment entitlement（见 CDrop.entitlements）。模拟器取令牌可用；
|
||
# 真机签名须付费 ADP 开 Push 能力（账号门控）。
|
||
CODE_SIGN_ENTITLEMENTS: CDrop.entitlements
|
||
# Share Extension：抓分享文件 → App Group 收件箱 → 深链主 app 选设备发送（只交接、不跑引擎，
|
||
# 见 PLAN §I5）。只编 ShareViewController + 共享的 AppGroup，绝不拉主 app Sources（避超 120MB）。
|
||
CommilitiaDropShare:
|
||
type: app-extension
|
||
platform: iOS
|
||
deploymentTarget: "26.0"
|
||
sources:
|
||
- path: Share
|
||
- path: Shared
|
||
# i18n JSON 随扩展 bundle 一并打包，使分享引导界面的 t() 文案随设备语言（同控件扩展）。
|
||
- path: Sources/Resources/i18n
|
||
info:
|
||
path: Share/Info.plist
|
||
properties:
|
||
CFBundleDisplayName: Commilitia Drop
|
||
# 品牌字标字体（分享引导界面的 Wordmark 用），随扩展 bundle 打包 + 注册。
|
||
UIAppFonts:
|
||
- Fredoka-SemiBold.ttf
|
||
NSExtension:
|
||
NSExtensionPointIdentifier: com.apple.share-services
|
||
NSExtensionPrincipalClass: $(PRODUCT_MODULE_NAME).ShareViewController
|
||
NSExtensionAttributes:
|
||
NSExtensionActivationRule:
|
||
NSExtensionActivationSupportsFileWithMaxCount: 20
|
||
NSExtensionActivationSupportsImageWithMaxCount: 20
|
||
NSExtensionActivationSupportsMovieWithMaxCount: 20
|
||
settings:
|
||
base:
|
||
PRODUCT_BUNDLE_IDENTIFIER: net.commilitia.Commilitia-Drop.share
|
||
TARGETED_DEVICE_FAMILY: "1,2"
|
||
CODE_SIGN_ENTITLEMENTS: Share/CDropShare.entitlements
|
||
# 控制中心剪贴板两控件（WidgetKit ControlWidget，iOS 18+，PLAN §I4）。纯原生 REST + 控件专用
|
||
# 设备会话（不跑引擎）。i18n JSON 一并打包使控件标签随设备语言（t() 经 no-subdir 回退读 bundle）。
|
||
CommilitiaDropWidgets:
|
||
type: app-extension
|
||
platform: iOS
|
||
deploymentTarget: "26.0"
|
||
sources:
|
||
- path: Widgets
|
||
- path: Shared
|
||
- path: Sources/Resources/i18n
|
||
info:
|
||
path: Widgets/Info.plist
|
||
properties:
|
||
CFBundleDisplayName: Commilitia Drop
|
||
NSExtension:
|
||
NSExtensionPointIdentifier: com.apple.widgetkit-extension
|
||
settings:
|
||
base:
|
||
PRODUCT_BUNDLE_IDENTIFIER: net.commilitia.Commilitia-Drop.widgets
|
||
TARGETED_DEVICE_FAMILY: "1,2"
|
||
CODE_SIGN_ENTITLEMENTS: Widgets/CDropWidgets.entitlements
|
||
# 单元 / 集成测试（模拟器，无需签名）：原生数据面 libwebrtc 引擎的环回端到端测试——两个
|
||
# LibWebRtcEngine 在同进程内交叉连，跑完整线协议（offer/answer/ICE + meta/分片/done + ack +
|
||
# 收尾）验证文件字节完整性。宿主即主 app（@testable import 取内部类型 + 经 app 链接 WebRTC）。
|
||
CommilitiaDropTests:
|
||
type: bundle.unit-test
|
||
platform: iOS
|
||
deploymentTarget: "26.0"
|
||
sources:
|
||
- path: Tests
|
||
dependencies:
|
||
- target: CommilitiaDrop
|
||
- package: WebRTC
|
||
settings:
|
||
base:
|
||
PRODUCT_BUNDLE_IDENTIFIER: net.commilitia.Commilitia-Drop.tests
|
||
TEST_HOST: "$(BUILT_PRODUCTS_DIR)/CommilitiaDrop.app/CommilitiaDrop"
|
||
BUNDLE_LOADER: "$(TEST_HOST)"
|
||
GENERATE_INFOPLIST_FILE: "YES"
|
||
# 原生 macOS 客户端：桌面壳（MacApp/）替代 iOS 标签栏，@main 的 #if os(macOS) 分支驱动单窗口 +
|
||
# 菜单栏。与 iOS 同 bundle（net.commilitia.Commilitia-Drop，同 App Store 记录 / 同 App Group）。
|
||
# 当前为脚手架：仅编 MacApp/（导航骨架 + 菜单栏占位）；引擎（LibWebRtcEngine + 离屏 WebView）与
|
||
# 复用视图随后续阶段并入。ARCHS arm64（本机 Apple Silicon）；本地 ad-hoc 签名（base 继承）。
|
||
CommilitiaDropMac:
|
||
type: application
|
||
platform: macOS
|
||
deploymentTarget: "26.0"
|
||
sources:
|
||
- path: MacApp
|
||
- path: Shared
|
||
# 复用 iOS 引擎与鉴权（跨平台 in-place，UIKit 处 #if 守卫 / AppKit 分支）。仅纳入「引擎 + 登录」
|
||
# 最小集：Engine 全部 + Auth（除 iOS 专属 LoginView，Mac 另写原生登录）+ 若干单例 + i18n。iOS UI
|
||
# 树（RootView / MessagesView / ScannerView / AppDelegate 等）暂不纳入，随 Phase 3b 复用。
|
||
- path: Sources/Engine
|
||
- path: Sources/Auth
|
||
excludes:
|
||
- LoginView.swift
|
||
- path: Sources/RecordsStore.swift
|
||
- path: Sources/PushRegistry.swift
|
||
- path: Sources/LocalNetworkPermission.swift
|
||
- path: Sources/DeviceNameStore.swift
|
||
- path: Sources/BackgroundTaskManager.swift
|
||
- path: Sources/Resources/i18n
|
||
dependencies:
|
||
# 原生数据面 libwebrtc（LibWebRtcEngine）。macOS 切片缺子头，构建经 just mac-prep 补齐
|
||
# （scripts/patch-macos-webrtc-headers.sh）。
|
||
- package: WebRTC
|
||
info:
|
||
path: Support/macOS/App-Info.plist
|
||
properties:
|
||
CFBundleName: Commilitia Drop
|
||
CFBundleDisplayName: Commilitia Drop
|
||
LSMinimumSystemVersion: "26.0"
|
||
CFBundleDevelopmentRegion: zh-Hans
|
||
CFBundleLocalizations:
|
||
- zh-Hans
|
||
- zh-Hant
|
||
- en
|
||
# ASWebAuthenticationSession 的 OAuth 回调经 cdrop:// scheme 回到 app（同 iOS）。
|
||
CFBundleURLTypes:
|
||
- CFBundleURLName: net.commilitia.Commilitia-Drop
|
||
CFBundleURLSchemes:
|
||
- cdrop
|
||
# 本地网络：libwebrtc 收集 host 候选、同内网直连须本地网络权限（macOS 15+ 亦弹窗）。
|
||
NSLocalNetworkUsageDescription: "Commilitia Drop 需要访问本地网络以发现同内网设备并建立直连传输。"
|
||
NSBonjourServices:
|
||
- "_cdrop._tcp"
|
||
settings:
|
||
base:
|
||
PRODUCT_BUNDLE_IDENTIFIER: net.commilitia.Commilitia-Drop
|
||
PRODUCT_NAME: CommilitiaDropMac
|
||
ARCHS: arm64
|
||
# App Group entitlement（Support/macOS/AppMac.entitlements）在 macOS 属受限能力，即便
|
||
# ad-hoc 签名也须 provisioning profile；脚手架阶段（本地免账号编译 / 自测）暂不挂，待桌面
|
||
# 剪贴板 / 小组件共享落地 + Developer ID 签名（Phase 6）再引用该文件。见 AppMac.entitlements。
|
||
# 原生数据面 macOS 冒烟（P0 闸）：把 LibWebRtcEngine.swift 直接编入独立测试 bundle（无宿主 app，
|
||
# 同模块无需 @testable import），跑与 iOS 同一份环回端到端测试——两个引擎同进程交叉连，验证
|
||
# libwebrtc 的 macOS 切片上线协议（offer/answer/ICE + 分片 / 背压 / ack / finalize）逐字节闭环。
|
||
# 证实原生数据面在 Mac 可用，是 Mac 复用 iOS 引擎的技术前提。
|
||
CommilitiaDropMacTests:
|
||
type: bundle.unit-test
|
||
platform: macOS
|
||
deploymentTarget: "26.0"
|
||
sources:
|
||
- path: Tests
|
||
- path: Sources/Engine/LibWebRtcEngine.swift
|
||
dependencies:
|
||
- package: WebRTC
|
||
settings:
|
||
base:
|
||
PRODUCT_BUNDLE_IDENTIFIER: net.commilitia.Commilitia-Drop.mac.tests
|
||
ARCHS: arm64
|
||
GENERATE_INFOPLIST_FILE: "YES"
|
||
schemes:
|
||
CommilitiaDrop:
|
||
build:
|
||
targets:
|
||
CommilitiaDrop: all
|
||
test:
|
||
targets:
|
||
- CommilitiaDropTests
|
||
gatherCoverageData: false
|
||
run:
|
||
config: Debug
|
||
CommilitiaDropMac:
|
||
build:
|
||
targets:
|
||
CommilitiaDropMac: all
|
||
test:
|
||
targets:
|
||
- CommilitiaDropMacTests
|
||
gatherCoverageData: false
|
||
run:
|
||
config: Debug
|
||
archive:
|
||
config: Release
|