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