建與發(fā)布完整指南：如何快速編譯、簽名并分發(fā)這款免費開源錄屏演示工具)
OpenScreen 構(gòu)建與發(fā)布完整指南如何快速編譯、簽名并分發(fā)這款免費開源錄屏演示工具【免費下載鏈接】openscreenRecord your screen, ship a demo. Free and open-source, GPU-accelerated, no watermarks, no subscriptions. Windows, macOS, Linux. Actively maintained.項目地址: https://gitcode.com/gh_mirrors/opens/openscreenOpenScreen 是一款免費開源的屏幕錄制與演示視頻編輯工具支持 Windows、macOS 和 Linux 三大平臺基于 Electron Rust 原生合成器構(gòu)建GPU 加速渲染、無水印、無訂閱。本文帶你從源碼編譯、安裝包打包、代碼簽名與公證一路走到完整的 CI/CD 發(fā)布流水線幫助你理解一個現(xiàn)代開源桌面應(yīng)用是如何構(gòu)建并分發(fā)到用戶手中的。一、構(gòu)建體系全景為什么 OpenScreen 的編譯比普通前端項目復(fù)雜OpenScreen 不只是Vite Electron的組合。一次完整的安裝包構(gòu)建需要協(xié)調(diào)三類產(chǎn)物產(chǎn)物類別內(nèi)容工具鏈前端與主進程React 渲染層、Electron 主進程、preload 橋接Node.js 22 TypeScript Vite原生捕獲/合成助手屏幕捕獲 helper、D3D11/Metal 合成器插件CMake MSVC / SwiftPM / Rust Cargo第三方運行時FFmpeg 動態(tài)庫、Whisper 語音轉(zhuǎn)寫二進制CMake 預(yù)編譯下載所有命令都集中在 package.json 的 scripts 中官方構(gòu)建文檔見 technical-documentation/engineering/build-and-packaging.md。二、編譯前置條件三臺機器的工具鏈清單通用Node.js 22.22.1 與 npm 10.9.4package.json#engines中已嚴格鎖定版本然后執(zhí)行npm ci安裝依賴。WindowsVisual Studio C 生成工具、Windows SDK、CMake Ninja、Rust MSVC 工具鏈。macOS完整 Xcode僅 Command Line Tools 不夠 Rust 工具鏈。LinuxCargo、CMake以及 Vulkan 驅(qū)動合成器渲染依賴無 GPU 時可回退 lavapipe 軟件光柵化。?? 一個關(guān)鍵坑原生插件compositor_view.node不提交進倉庫在 Windows 上打包請始終用npm run build:win而不是泛化的npm run build——后者不會重編譯原生插件且舊版插件會靜默失效新特性不生效但不報錯。打包前的守衛(wèi)腳本 scripts/before-pack.cjs 會檢查插件是否比 Rust 源碼舊并在產(chǎn)物不完整時直接中止構(gòu)建。三、從源碼到安裝包四條核心構(gòu)建命令npm run dev # 開發(fā)模式Vite 熱更新 啟動 Electron npm run build:win # 捕獲助手 → FFmpeg → 合成器插件 → 打包 NSIS 安裝器 npm run build:mac # ScreenCaptureKit 助手 → 源碼編譯 FFmpeg(LGPL) → 打包 DMG npm run build:linux # AppImage / deb / pacman / rpm 四種格式打包階段的瘦身技巧都寫在 electron-builder.json5 中Vite 已預(yù)打包全部業(yè)務(wù)代碼因此整個node_modules被排除約省 238 MB壁紙、字體、分割模型走extraResources而非塞進 asarelectronLanguages只保留 15 種受支持語言約省 20 MB。四、代碼簽名與公證讓安裝包被系統(tǒng)信任macOS 是簽名最完整的一條路徑。當(dāng) CI 中配置齊全部 Apple 憑據(jù)時每個 tag包括 RC 預(yù)發(fā)布都會執(zhí)行Developer ID 簽名 →notarytool公證 → staple 票據(jù) → Gatekeeper 校驗。涉及的倉庫 Secrets 包括MAC_CERTIFICATE_P12、MAC_CSC_NAME、APPLE_ID、APPLE_TEAM_ID等缺任何一項則回退到 ad-hoc 簽名。憑據(jù)輪換與細節(jié)見 technical-documentation/engineering/release-and-secrets.md。Windows 分兩條路NSIS.exe目前未配置代碼簽名SmartScreen 會提示未知發(fā)布者而 Microsoft Store 的 AppX 包在微軟認證流程中由微軟簽名——這是官方推薦的受信任通道。提交 Store 需配置 Entra ID 應(yīng)用憑據(jù)AZURE_AD_APPLICATION_SECRET等且僅限穩(wěn)定版提交RC 版本被明確排除避免未認證版本推送到所有用戶機器。Linux 的簽名等價物是依賴聲明。各發(fā)行版包格式的depends列表在 electron-builder.json5 中手寫并替換默認值例如補上libgbm1、libgomp1、xdg-desktop-portal再由 scripts/verify-linux-package.sh 在干凈的發(fā)行版容器里真實安裝并跑ldd驗證防止開發(fā)機上能跑、干凈機器上崩的發(fā)布事故。五、CI/CD 流水線15 個工作流的四層架構(gòu)所有工作流位于.github/workflows/官方架構(gòu)參考 technical-documentation/engineering/ci-workflows.md層級工作流觸發(fā)條件Tier 1 應(yīng)用 CIci.yml推送到 main / PRlint、類型檢查、單測、Vite 構(gòu)建冒煙Tier 2 發(fā)布構(gòu)建build.yml任意v*tag 或手動 dispatchWindows NSIS AppX、macOS 雙架構(gòu) DMG、Linux 四格式Tier 2.5 版本管理prerelease.yml/promote.yml手動觸發(fā)切 RC → 晉升穩(wěn)定版Tier 3 軟件源Homebrew / WinGet / Nix / AUR穩(wěn)定版發(fā)布后自動扇出Tier 4 自動化Discord 通知、診斷包等PR 事件 / 定時任務(wù)發(fā)布節(jié)奏release-please 風(fēng)格的凍結(jié)分支契約prerelease.yml創(chuàng)建并凍結(jié)release/vX.Y.Z分支、打vX.Y.Z-rc.Ntag 并顯式 dispatchbuild.ymlRC 通過手動 e2e 清單驗證后promote.yml在分支上把版本改為穩(wěn)定號、打穩(wěn)定 tag、將版本同步 PR 合回 main再觸發(fā)正式發(fā)布。build.yml的發(fā)布步驟會校驗 tag 與package.json版本號一致防止用 main 分支的二進制發(fā)布舊版本號這類事故。產(chǎn)物流轉(zhuǎn)各平臺安裝器上傳為 30 天保留的 Actions 工件 →publish-release校驗后發(fā)布為 GitHub Release同時生成latest.yml更新源與.blockmap差量塊圖供electron-updater做增量更新→ 穩(wěn)定版事件自動觸發(fā)四個軟件源更新工作流。Linux 還有一條獨立支線nix/package.nix 直接跑 Vite不經(jīng) electron-builder構(gòu)建 Nix 包bump-nix-package.yml在穩(wěn)定版發(fā)布后自動開 PR 更新版本與依賴哈希flake.nix 則提供nix develop開發(fā)外殼一條命令獲得完整的 Node/Electron/原生構(gòu)建環(huán)境。六、要點速查清單?編譯鎖定 Node 22.22.1npm ci后用平臺專屬build:*命令切勿用泛化build打包 Windows 產(chǎn)物簽名macOS 全流程簽名 公證含 RCWindows 信任通道走 Store 認證Linux 靠依賴聲明 干凈容器驗證發(fā)布凍結(jié)release/vX.Y.Z分支 → RC 驗證 → 晉升穩(wěn)定版 → 自動扇出 Homebrew/WinGet/Nix/AUR關(guān)鍵文件electron-builder.json5打包與簽名配置、.github/workflows/build.yml發(fā)布構(gòu)建矩陣、scripts/before-pack.cjs打包前完整性守衛(wèi)想動手試試克隆倉庫git clone https://gitcode.com/gh_mirrors/opens/openscreen裝好對應(yīng)平臺工具鏈后一條npm run build:linux或你的平臺命令就能得到屬于你自己的、帶版本號簽名的 OpenScreen 安裝包。【免費下載鏈接】openscreenRecord your screen, ship a demo. Free and open-source, GPU-accelerated, no watermarks, no subscriptions. Windows, macOS, Linux. Actively maintained.項目地址: https://gitcode.com/gh_mirrors/opens/openscreen創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 OpenScreen 構(gòu)建與發(fā)布完整指南：如何快速編譯、簽名并分發(fā)這款免費開源錄屏演示工具
OpenScreen 構(gòu)建與發(fā)布完整指南如何快速編譯、簽名并分發(fā)這款免費開源錄屏演示工具【免費下載鏈接】openscreenRecord your screen, ship a demo. Free and open-source, GPU-accelerated, no watermarks, no subscriptions. Windows, macOS, Linux. Actively maintained.項目地址: https://gitcode.com/gh_mirrors/opens/openscreenOpenScreen 是一款免費開源的屏幕錄制與演示視頻編輯工具支持 Windows、macOS 和 Linux 三大平臺基于 Electron Rust 原生合成器構(gòu)建GPU 加速渲染、無水印、無訂閱。本文帶你從源碼編譯、安裝包打包、代碼簽名與公證一路走到完整的 CI/CD 發(fā)布流水線幫助你理解一個現(xiàn)代開源桌面應(yīng)用是如何構(gòu)建并分發(fā)到用戶手中的。一、構(gòu)建體系全景為什么 OpenScreen 的編譯比普通前端項目復(fù)雜OpenScreen 不只是Vite Electron的組合。一次完整的安裝包構(gòu)建需要協(xié)調(diào)三類產(chǎn)物產(chǎn)物類別內(nèi)容工具鏈前端與主進程React 渲染層、Electron 主進程、preload 橋接Node.js 22 TypeScript Vite原生捕獲/合成助手屏幕捕獲 helper、D3D11/Metal 合成器插件CMake MSVC / SwiftPM / Rust Cargo第三方運行時FFmpeg 動態(tài)庫、Whisper 語音轉(zhuǎn)寫二進制CMake 預(yù)編譯下載所有命令都集中在 package.json 的 scripts 中官方構(gòu)建文檔見 technical-documentation/engineering/build-and-packaging.md。二、編譯前置條件三臺機器的工具鏈清單通用Node.js 22.22.1 與 npm 10.9.4package.json#engines中已嚴格鎖定版本然后執(zhí)行npm ci安裝依賴。WindowsVisual Studio C 生成工具、Windows SDK、CMake Ninja、Rust MSVC 工具鏈。macOS完整 Xcode僅 Command Line Tools 不夠 Rust 工具鏈。LinuxCargo、CMake以及 Vulkan 驅(qū)動合成器渲染依賴無 GPU 時可回退 lavapipe 軟件光柵化。?? 一個關(guān)鍵坑原生插件compositor_view.node不提交進倉庫在 Windows 上打包請始終用npm run build:win而不是泛化的npm run build——后者不會重編譯原生插件且舊版插件會靜默失效新特性不生效但不報錯。打包前的守衛(wèi)腳本 scripts/before-pack.cjs 會檢查插件是否比 Rust 源碼舊并在產(chǎn)物不完整時直接中止構(gòu)建。三、從源碼到安裝包四條核心構(gòu)建命令npm run dev # 開發(fā)模式Vite 熱更新 啟動 Electron npm run build:win # 捕獲助手 → FFmpeg → 合成器插件 → 打包 NSIS 安裝器 npm run build:mac # ScreenCaptureKit 助手 → 源碼編譯 FFmpeg(LGPL) → 打包 DMG npm run build:linux # AppImage / deb / pacman / rpm 四種格式打包階段的瘦身技巧都寫在 electron-builder.json5 中Vite 已預(yù)打包全部業(yè)務(wù)代碼因此整個node_modules被排除約省 238 MB壁紙、字體、分割模型走extraResources而非塞進 asarelectronLanguages只保留 15 種受支持語言約省 20 MB。四、代碼簽名與公證讓安裝包被系統(tǒng)信任macOS 是簽名最完整的一條路徑。當(dāng) CI 中配置齊全部 Apple 憑據(jù)時每個 tag包括 RC 預(yù)發(fā)布都會執(zhí)行Developer ID 簽名 →notarytool公證 → staple 票據(jù) → Gatekeeper 校驗。涉及的倉庫 Secrets 包括MAC_CERTIFICATE_P12、MAC_CSC_NAME、APPLE_ID、APPLE_TEAM_ID等缺任何一項則回退到 ad-hoc 簽名。憑據(jù)輪換與細節(jié)見 technical-documentation/engineering/release-and-secrets.md。Windows 分兩條路NSIS.exe目前未配置代碼簽名SmartScreen 會提示未知發(fā)布者而 Microsoft Store 的 AppX 包在微軟認證流程中由微軟簽名——這是官方推薦的受信任通道。提交 Store 需配置 Entra ID 應(yīng)用憑據(jù)AZURE_AD_APPLICATION_SECRET等且僅限穩(wěn)定版提交RC 版本被明確排除避免未認證版本推送到所有用戶機器。Linux 的簽名等價物是依賴聲明。各發(fā)行版包格式的depends列表在 electron-builder.json5 中手寫并替換默認值例如補上libgbm1、libgomp1、xdg-desktop-portal再由 scripts/verify-linux-package.sh 在干凈的發(fā)行版容器里真實安裝并跑ldd驗證防止開發(fā)機上能跑、干凈機器上崩的發(fā)布事故。五、CI/CD 流水線15 個工作流的四層架構(gòu)所有工作流位于.github/workflows/官方架構(gòu)參考 technical-documentation/engineering/ci-workflows.md層級工作流觸發(fā)條件Tier 1 應(yīng)用 CIci.yml推送到 main / PRlint、類型檢查、單測、Vite 構(gòu)建冒煙Tier 2 發(fā)布構(gòu)建build.yml任意v*tag 或手動 dispatchWindows NSIS AppX、macOS 雙架構(gòu) DMG、Linux 四格式Tier 2.5 版本管理prerelease.yml/promote.yml手動觸發(fā)切 RC → 晉升穩(wěn)定版Tier 3 軟件源Homebrew / WinGet / Nix / AUR穩(wěn)定版發(fā)布后自動扇出Tier 4 自動化Discord 通知、診斷包等PR 事件 / 定時任務(wù)發(fā)布節(jié)奏release-please 風(fēng)格的凍結(jié)分支契約prerelease.yml創(chuàng)建并凍結(jié)release/vX.Y.Z分支、打vX.Y.Z-rc.Ntag 并顯式 dispatchbuild.ymlRC 通過手動 e2e 清單驗證后promote.yml在分支上把版本改為穩(wěn)定號、打穩(wěn)定 tag、將版本同步 PR 合回 main再觸發(fā)正式發(fā)布。build.yml的發(fā)布步驟會校驗 tag 與package.json版本號一致防止用 main 分支的二進制發(fā)布舊版本號這類事故。產(chǎn)物流轉(zhuǎn)各平臺安裝器上傳為 30 天保留的 Actions 工件 →publish-release校驗后發(fā)布為 GitHub Release同時生成latest.yml更新源與.blockmap差量塊圖供electron-updater做增量更新→ 穩(wěn)定版事件自動觸發(fā)四個軟件源更新工作流。Linux 還有一條獨立支線nix/package.nix 直接跑 Vite不經(jīng) electron-builder構(gòu)建 Nix 包bump-nix-package.yml在穩(wěn)定版發(fā)布后自動開 PR 更新版本與依賴哈希flake.nix 則提供nix develop開發(fā)外殼一條命令獲得完整的 Node/Electron/原生構(gòu)建環(huán)境。六、要點速查清單?編譯鎖定 Node 22.22.1npm ci后用平臺專屬build:*命令切勿用泛化build打包 Windows 產(chǎn)物簽名macOS 全流程簽名 公證含 RCWindows 信任通道走 Store 認證Linux 靠依賴聲明 干凈容器驗證發(fā)布凍結(jié)release/vX.Y.Z分支 → RC 驗證 → 晉升穩(wěn)定版 → 自動扇出 Homebrew/WinGet/Nix/AUR關(guān)鍵文件electron-builder.json5打包與簽名配置、.github/workflows/build.yml發(fā)布構(gòu)建矩陣、scripts/before-pack.cjs打包前完整性守衛(wèi)想動手試試克隆倉庫git clone https://gitcode.com/gh_mirrors/opens/openscreen裝好對應(yīng)平臺工具鏈后一條npm run build:linux或你的平臺命令就能得到屬于你自己的、帶版本號簽名的 OpenScreen 安裝包。【免費下載鏈接】openscreenRecord your screen, ship a demo. Free and open-source, GPU-accelerated, no watermarks, no subscriptions. Windows, macOS, Linux. Actively maintained.項目地址: https://gitcode.com/gh_mirrors/opens/openscreen創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考