admin
9d46e26f50
- P0 闸达成：新增 macOS 独立单测 target CommilitiaDropMacTests（把 LibWebRtcEngine.swift 直接编入测试 bundle，无宿主 app、同模块无需 @testable），跑与 iOS 同一份环回端到端测试——两个引擎同进程交叉连，20MB 伪随机源逐字节比对。macOS 上线协议（offer/answer/ICE + 分片 / 背压 / ack / finalize）在 libwebrtc 闭环，证实原生数据面在 Mac 可用（≈3s 通过）。是 Mac 复用 iOS 引擎的技术前提 - 修 stasel/WebRTC 149.0.0 原生 macOS 切片缺头：macos-x86_64_arm64 随包只带 umbrella WebRTC.h、缺全部 80+ 子头（ios / maccatalyst / simulator 三切片各 93 头齐全），umbrella #import 的子头找不到致 import WebRTC 在原生 macOS 编不过；切片二进制本身有效（arm64+x86_64 dylib）。scripts/patch-macos-webrtc-headers.sh 从同包 ios-arm64 切片补齐（子头为平台守卫 ObjC 声明、跨切片同构；排除 3 个 UIKit 绑定视图头 + 从 umbrella 去掉本包缺失的 RTCMTLNSVideoView.h）。幂等，须 SPM resolve 之后、build 之前跑 - LibWebRtcEngineTests.swift 导入条件化：仅 #if os(iOS) 时 @testable import CommilitiaDrop（macOS 侧引擎编在同模块、无需 import），iOS 与 macOS 共用同一份测试文件验证同构闭环 - Justfile：mac-prep（xcodegen + -resolvePackageDependencies + 补头脚本）→ mac-build / mac-test 均依赖之；build / test 加 -disableAutomaticPackageResolution 防 build 期再解析冲掉补丁 - 验证：just mac-test 从残缺态复现全绿——resolve + 补头（1→90）+ 编译 + 环回测试通过
148 lines
7.8 KiB
Makefile
148 lines
7.8 KiB
Makefile
set dotenv-load := true
|
||
|
||
default:
|
||
@just --list
|
||
|
||
dev-back:
|
||
go run ./cmd/cdropd
|
||
|
||
dev-front:
|
||
cd web && npm run dev
|
||
|
||
build-back:
|
||
mkdir -p dist
|
||
go build -o dist/cdropd ./cmd/cdropd
|
||
|
||
build-front:
|
||
cd web && npm run build
|
||
|
||
build: build-back build-front
|
||
|
||
test:
|
||
go test ./...
|
||
|
||
typecheck-front:
|
||
cd web && npm run typecheck
|
||
|
||
fmt:
|
||
gofmt -w .
|
||
|
||
vet:
|
||
go vet ./...
|
||
|
||
# 生成一对 VAPID 密钥（Web Push 用）。输出两行 env，写进部署密钥后固定不变——
|
||
# 更换会使所有既有浏览器订阅失效。两者皆设才启用推送。
|
||
vapid-keygen:
|
||
go run ./cmd/vapidgen
|
||
|
||
# ---- desktop client (Wails · macOS 主开发，Windows 在 Parallels 验证) ----
|
||
|
||
# wails CLI 在 go install 后落在 $(go env GOPATH)/bin/wails，
|
||
# 用绝对路径避免依赖 shell PATH 配置。
|
||
wails := `go env GOPATH` + "/bin/wails"
|
||
|
||
# 起 wails dev 热重载，前端走 Vite dev server。
|
||
desktop-dev:
|
||
cd desktop && {{wails}} dev
|
||
|
||
# 构建 macOS universal .app（含 darwin/arm64 + darwin/amd64）。
|
||
# 不加 -clean，让 mac/win 产物在 build/bin/ 共存；清理走 desktop-clean。
|
||
#
|
||
# ⚠️ 先手动构建前端再 `wails build -s`（跳过 wails 自带前端步骤）：wails build 的
|
||
# frontend:build 在本仓库结构下不可靠（不实际重建 web/ → 嵌入旧 JS）。显式构建
|
||
# web → desktop/frontend/dist，再用 -s 让 go:embed 嵌入这份新 dist。
|
||
desktop-build-mac:
|
||
cd web && npm run build -- --outDir ../desktop/frontend/dist --emptyOutDir
|
||
cd desktop && {{wails}} build -s -platform darwin/universal
|
||
|
||
# 交叉编译 Windows amd64 .exe。macOS 原生即可——Windows 侧无 cgo（darwin 的
|
||
# NSStatusBar/NSPasteboard CGO 走 build tag 排除，WebView2 是纯 Go），不需 mingw。
|
||
# 与 mac 同：先手动构建前端再 -s（wails 自带 frontend:build 在本仓库不可靠）。
|
||
# 产物 build/bin/desktop.exe；真测试经 RDP 到 Windows 机器跑。
|
||
desktop-build-win:
|
||
cd web && npm run build -- --outDir ../desktop/frontend/dist --emptyOutDir
|
||
cd desktop && {{wails}} build -s -platform windows/amd64
|
||
|
||
# 清空 build/bin/ 产物。
|
||
desktop-clean:
|
||
rm -rf desktop/build/bin
|
||
|
||
# 环境自检。
|
||
desktop-doctor:
|
||
{{wails}} doctor
|
||
|
||
# ---- iOS 真机 ----
|
||
|
||
# 列出已连接的真机（手机插 USB 后取 UDID，填进门户 Devices + just ios-device）。
|
||
ios-devices:
|
||
xcrun devicectl list devices
|
||
|
||
# 拉取品牌字标字体 Fredoka（logo / Wordmark 用，不入库——虽为开源 OFL 仍统一从 Google Fonts 拉，
|
||
# 保持仓库精简）。幂等：已存在则跳过。ios-sim-build / ios-device 构建前已 chain 本步。前置：curl；造
|
||
# Fredoka 静态实例需 python3 + fonttools（python3 -m pip install --user fonttools）。UI 界面字体已改用
|
||
# 系统原生字体（不再拉 Orbit Gothic / Maple Mono）；见 ios/CDrop/Shared/Fonts/README.md。
|
||
ios-fonts:
|
||
mkdir -p ios/CDrop/Shared/Fonts
|
||
[ -f ios/CDrop/Shared/Fonts/Fredoka-SemiBold.ttf ] || just ios-fonts-fredoka
|
||
|
||
# Fredoka 字标：从 Google Fonts 变量字体实例化出静态 SemiBold（wght=600, wdth=100）。
|
||
ios-fonts-fredoka:
|
||
curl -fsSL "https://raw.githubusercontent.com/google/fonts/main/ofl/fredoka/Fredoka%5Bwdth%2Cwght%5D.ttf" -o /tmp/Fredoka-VF.ttf
|
||
python3 -m fontTools.varLib.instancer /tmp/Fredoka-VF.ttf wght=600 wdth=100 -o ios/CDrop/Shared/Fonts/Fredoka-SemiBold.ttf --update-name-table
|
||
rm -f /tmp/Fredoka-VF.ttf
|
||
|
||
# 模拟器编译验证（无需签名 / Apple 账号）：拉字体 + xcodegen + xcodebuild iphonesimulator。原生数据面
|
||
# 引擎走 SPM 的 libwebrtc（首次构建自动拉取 WebRTC.xcframework），无需预构建步骤。用于改动自检。
|
||
ios-sim-build:
|
||
just ios-fonts
|
||
cd ios/CDrop && xcodegen generate
|
||
cd ios/CDrop && xcodebuild -project CommilitiaDrop.xcodeproj -scheme CommilitiaDrop -sdk iphonesimulator -destination 'generic/platform=iOS Simulator' -derivedDataPath build/DD build
|
||
|
||
# 内部：生成工程 + 解析 SPM 依赖 + 补齐 macOS WebRTC 头。stasel/WebRTC 149 的原生 macOS 切片随包
|
||
# 只带 umbrella、缺全部子头（`import WebRTC` 编不过；二进制有效），须从 ios 切片补齐，见
|
||
# scripts/patch-macos-webrtc-headers.sh。mac-build / mac-test 共用；须 resolve 之后 build 之前跑。
|
||
mac-prep:
|
||
cd ios/CDrop && xcodegen generate
|
||
cd ios/CDrop && xcodebuild -project CommilitiaDrop.xcodeproj -scheme CommilitiaDropMac -sdk macosx -derivedDataPath build/DD-mac -resolvePackageDependencies
|
||
bash ios/CDrop/scripts/patch-macos-webrtc-headers.sh ios/CDrop/build/DD-mac
|
||
|
||
# macOS 原生客户端本地编译（ad-hoc 签名，无需 Apple 账号）。当前为脚手架（MacApp/ 导航骨架 +
|
||
# 菜单栏占位）；引擎 / 复用视图 / 桌面功能随后续阶段并入。产物 build/DD-mac/Build/Products/Debug/
|
||
# CommilitiaDropMac.app（本地打开自测）。
|
||
mac-build: mac-prep
|
||
cd ios/CDrop && xcodebuild -project CommilitiaDrop.xcodeproj -scheme CommilitiaDropMac -sdk macosx -destination 'platform=macOS' -derivedDataPath build/DD-mac -disableAutomaticPackageResolution build
|
||
|
||
# 原生数据面 macOS 冒烟（P0 闸）：跑 CommilitiaDropMacTests 环回端到端测试——两个 LibWebRtcEngine
|
||
# 同进程交叉连，20MB 逐字节验证 libwebrtc macOS 切片上线协议闭环。证实原生数据面在 Mac 可用。
|
||
mac-test: mac-prep
|
||
cd ios/CDrop && xcodebuild test -project CommilitiaDrop.xcodeproj -scheme CommilitiaDropMac -sdk macosx -destination 'platform=macOS' -derivedDataPath build/DD-mac -disableAutomaticPackageResolution
|
||
|
||
# 真机构建 + 装机（自动 provisioning，经 ASC API Key）。前置：付费 ADP；App ID 的 App Groups /
|
||
# Push 能力（门户建好或自动建）；根目录 gitignore 的 .env 配齐：CDROP_TEAM_ID / CDROP_ASC_KEY_PATH
|
||
# （.p8 路径）/ CDROP_ASC_KEY_ID / CDROP_ASC_ISSUER_ID。-allowProvisioningUpdates 自动登记连接的
|
||
# 设备 + 建 profile（绕过手动 profile 的设备选择坑）。模拟器构建不需这些（base ad-hoc）。原生数据面
|
||
# 经 SPM 拉 libwebrtc，无 gomobile 预构建步骤（早先 ios-engine recipe 已随 pion-on-iOS 废弃移除）。
|
||
# 用法：just ios-device <设备UDID>（UDID 见 just ios-devices）。
|
||
ios-device udid:
|
||
[ -n "$CDROP_TEAM_ID" ] && [ -n "$CDROP_ASC_KEY_PATH" ] && [ -n "$CDROP_ASC_KEY_ID" ] && [ -n "$CDROP_ASC_ISSUER_ID" ] || { echo "缺 .env（CDROP_TEAM_ID / CDROP_ASC_KEY_PATH / CDROP_ASC_KEY_ID / CDROP_ASC_ISSUER_ID）——见 ios/CDrop/REALDEVICE.md"; exit 1; }
|
||
just ios-fonts
|
||
cd ios/CDrop && xcodegen generate
|
||
cd ios/CDrop && xcodebuild -project CommilitiaDrop.xcodeproj -scheme CommilitiaDrop -configuration Debug -destination "platform=iOS,id={{udid}}" -derivedDataPath build/DD-device -allowProvisioningUpdates -authenticationKeyPath "$CDROP_ASC_KEY_PATH" -authenticationKeyID "$CDROP_ASC_KEY_ID" -authenticationKeyIssuerID "$CDROP_ASC_ISSUER_ID" DEVELOPMENT_TEAM="$CDROP_TEAM_ID" CODE_SIGN_STYLE=Automatic CODE_SIGN_IDENTITY="Apple Development" build
|
||
xcrun devicectl device install app --device {{udid}} ios/CDrop/build/DD-device/Build/Products/Debug-iphoneos/CommilitiaDrop.app
|
||
|
||
# ---- deploy plumbing ----
|
||
|
||
# 一次性预热：把 Go modules + node_modules 烤进 cdrop-base:latest。
|
||
# 仅 go.mod/go.sum 或 web/package*.json 改动时需要重跑。
|
||
# 用宿主原生 arch（macOS arm64 → linux/arm64），让 BUILDPLATFORM 跨编译走原生。
|
||
docker-base:
|
||
docker buildx build -f docker/Dockerfile.base -t cdrop-base:latest --load .
|
||
|
||
# 应用镜像：从 cdrop-base 起步只编译源码，最终落 linux/amd64 distroless。
|
||
# dev mode 部署时 export VITE_CDROP_DEV_TOKEN=<同后端 token> 把它烤进前端 bundle。
|
||
docker-image:
|
||
docker buildx build --platform linux/amd64 \
|
||
--build-arg VITE_CDROP_DEV_TOKEN="${VITE_CDROP_DEV_TOKEN:-}" \
|
||
--build-arg VITE_CDROP_STUN_URLS="${VITE_CDROP_STUN_URLS:-}" \
|
||
-f docker/Dockerfile -t cdrop:latest --load .
|