docs(macos): installing the unsigned build on macOS 15+ and its limitations

已關閉 適合新手
#1,594 0 則留言 0 個 reaction 已指派 0 人 在 GitHub 檢視

維護者通常 1 天內回覆

還沒有人認領這個 Issue。

評估

難度
2/5
預估耗時
1-3 小時
新手友好度
78/100
Issue 類型
文件
描述清晰度
描述清楚
活躍度
活躍
技術堆疊
dart, flutter

研究方向

閱讀 docs/macos-signing.md 和 README 中關於 macOS 安裝與簽署的部分。查看引用的 Keychain 問題以及 #1587 和 #1591,了解需要記錄的行為,然後更新這兩份文件,補上 macOS 14 和 15+ 的安裝步驟、一致的 entitlements、sandbox 限制和交叉連結。完成標準是兩份文件都一致地說明所要求的步驟和限制。

由索引模型根據 Issue 內容生成。

描述

documentation P3

Problem

docs/macos-signing.md and the README do not describe running an unsigned macOS build, and the existing text is outdated or inconsistent.

  • Only "right-click → Open" is documented. On macOS 15+ that no longer bypasses Gatekeeper; users must use System Settings → Privacy & Security → Open Anyway, or xattr -dr com.apple.quarantine.
  • Running straight from ~/Downloads triggers App Translocation (read-only random path), which breaks in-place updates (#1587).
  • Step 4 of the document says signing applies Release.entitlements, the last bullet says ReleaseSigned.entitlements.
  • No note that unsigned builds are sandboxed (#1591) and what stops working.

Tasks

  • README: "Installing the unsigned macOS build" (steps for macOS 14 and 15+, move to /Applications first, xattr alternative).
  • docs/macos-signing.md: fix the entitlements contradiction; add a limitations table for unsigned/sandboxed builds.
  • Cross-link the Keychain and updater issues.
主要語言
Dart
星號
23
分支
1
平均合併
49 分鐘
30 天內合併 PR
496

環境準備

在 Codespaces 中開啟

在瀏覽器裡用你自己的 GitHub 帳號啟動這個專案的開發容器。

從這裡開始

  1. 先讀完整個 Issue,再讀專案的貢獻指南。
  2. 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
  3. Fork 儲存庫,在一個分支上完成修改。
  4. 送出 Pull Request,並在描述裡引用這個 Issue 編號。

QueryaHub/Querya-Desktop 的其他 Issue

查看 QueryaHub/Querya-Desktop 的全部 Issue

相似的 Issue

更多 Dart Issue

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。