Aliyun-VOD-Media-Library-Manager/apps/macos/VODManager

火炬 VOD 管理器 - macOS 原生版

基于 SwiftUI + Swift Package Manager 的阿里云 VOD 桌面管理客户端。

特性

• 原生 macOS SwiftUI 界面
• 直接调用阿里云 VOD OpenAPI，无需 Node 后端
• 多账号管理、切换
• 视频列表、搜索、详情
• 批量下载到用户指定目录
• 自定义下载文件名（自动清理非法字符）
• 下载任务历史
• 操作日志

技术栈

• Swift 6 + SwiftUI
• GRDB（SQLite）
• CryptoKit（阿里云 POP 签名）
• URLSession（网络请求与下载）

开发要求

• macOS 14+
• Xcode 15+
• Swift 5.9+

本地运行

cd apps/macos/VODManager
swift build
swift run

或在 Xcode 中打开 Package.swift。

App Store 上架准备

1. 在 Xcode 中创建正式的 macOS App 工程（或打开 Swift Package）。
2. 配置 Signing & Capabilities：
   • App Sandbox 开启
   • 启用 entitlements 文件 VODManager.entitlements
   • Team 与 Bundle Identifier
3. 提交 Mac App Store 审核。

Entitlements 说明

• com.apple.security.app-sandbox：沙盒必须开启
• com.apple.security.network.client：访问阿里云 API
• com.apple.security.files.user-selected.read-write：用户选择下载目录
• com.apple.security.files.downloads.read-write：写入 Downloads 目录

与 Web 版的关系

Web 版（apps/web + apps/server）已废弃，不再维护。所有新功能在 macOS 原生版中实现。