立應(yīng)用開(kāi)發(fā)的質(zhì)量把控與工程實(shí)踐指南)
“Show HN: My first app got 97% on MacSources”如果單看標(biāo)題你可能會(huì)覺(jué)得這又是一個(gè) app 上架后的“曬分帖”。但真正值得琢磨的是一個(gè)獨(dú)立開(kāi)發(fā)者的第一個(gè) macOS 應(yīng)用為什么能在第三方評(píng)測(cè)網(wǎng)站拿到 97% 的高分這個(gè)分?jǐn)?shù)背后對(duì)應(yīng)的工程質(zhì)量、用戶體驗(yàn)和發(fā)布流程才是大多數(shù)開(kāi)發(fā)者真正缺的東西。這篇博客不打算從標(biāo)題里“考古”那個(gè) app 的具體功能——因?yàn)轭}目本身就只給了標(biāo)題沒(méi)有任何產(chǎn)品細(xì)節(jié)。我們要做的是把“我的第一個(gè) app 在 MacSources 拿到 97%”當(dāng)做一個(gè)工程目標(biāo)來(lái)拆解一個(gè) macOS 獨(dú)立開(kāi)發(fā)者應(yīng)該如何在功能開(kāi)發(fā)、交互設(shè)計(jì)、穩(wěn)定性、隱私合規(guī)、上架分發(fā)這幾個(gè)環(huán)節(jié)做到位才有機(jī)會(huì)進(jìn)入高分區(qū)間。如果你是第一次做 Mac app或者是做完了 app 但還沒(méi)想清楚怎么把質(zhì)量做扎實(shí)這篇文章可以直接收藏。下面會(huì)從架構(gòu)選型、開(kāi)發(fā)規(guī)范、沙盒與公證、隱私權(quán)限、性能優(yōu)化、第三方測(cè)評(píng)視角、常見(jiàn)扣分點(diǎn)、自檢清單這幾個(gè)維度完整過(guò)一遍并且提供可以復(fù)制的 Swift/SwiftUI 代碼、Shell 命令和 Xcode 配置思路。1. 從一個(gè)標(biāo)題拆出可執(zhí)行的質(zhì)量指標(biāo)MacSources 是國(guó)外一個(gè)長(zhǎng)期關(guān)注 Apple 生態(tài)的科技媒體會(huì)報(bào)道 macOS、iOS 應(yīng)用、配件和系統(tǒng)功能也會(huì)給一些有代表性的軟件做評(píng)測(cè)。從標(biāo)題里“97%”這個(gè)數(shù)字能推斷出MacSources 大概率對(duì)應(yīng)用有一個(gè)從功能到體驗(yàn)的綜合評(píng)分體系。97% 放在任何一套評(píng)分體系里都屬于高分檔意味著產(chǎn)品在評(píng)測(cè)編輯手里幾乎沒(méi)有出現(xiàn)大問(wèn)題。這里要先做個(gè)說(shuō)明這篇博客不會(huì)去假設(shè) MacSources 的具體評(píng)分公式因?yàn)槟菍儆诿襟w內(nèi)部標(biāo)準(zhǔn)外部無(wú)法拿到準(zhǔn)確口徑。但可以確定的是一個(gè)第三方 Mac 軟件評(píng)測(cè)如果要打高分通常會(huì)觀察以下六個(gè)維度評(píng)測(cè)維度編輯會(huì)關(guān)注什么開(kāi)發(fā)者在哪個(gè)階段控制功能完整度核心功能是否可用、異常路徑是否兜住需求設(shè)計(jì)與功能測(cè)試交互與界面是否符合 macOS 人機(jī)交互習(xí)慣UI 設(shè)計(jì)與響應(yīng)式布局性能與資源占用啟動(dòng)速度、內(nèi)存、CPU、耗電性能測(cè)試與代碼審查穩(wěn)定性是否崩潰、卡死、數(shù)據(jù)丟失崩潰監(jiān)控與回歸測(cè)試隱私與安全沙盒、權(quán)限說(shuō)明、數(shù)據(jù)收集是否克制工程架構(gòu)與合規(guī)審查兼容性是否支持主流 macOS 版本、芯片架構(gòu)多版本與多架構(gòu)適配這六項(xiàng)放在任何一款 mac app 上都成立。把它們作為開(kāi)發(fā)過(guò)程中的“硬指標(biāo)”比盯著愿望清單做功能更實(shí)際。2. 第一個(gè) macOS App 的技術(shù)選型思路標(biāo)題里沒(méi)有給出 app 是用什么技術(shù)寫(xiě)的但從 2025 年的 Mac 開(kāi)發(fā)環(huán)境來(lái)看新項(xiàng)目最穩(wěn)妥的起點(diǎn)是 Swift SwiftUI配合 Xcode 16 以上的工具鏈。SwiftUI 的聲明式 UI 能明顯降低界面代碼量也能自動(dòng)適配暗色模式、動(dòng)態(tài)字體和 macOS 最新的窗口樣式。如果你是從 iOS 轉(zhuǎn)過(guò)來(lái)的開(kāi)發(fā)者SwiftUI 上手很快但有幾個(gè) macOS 特有概念需要提前補(bǔ)課WindowGroup、Window、WindowScene 管理多窗口。MenuBarExtra 編寫(xiě)菜單欄常駐應(yīng)用。Commands 處理菜單欄命令比如 Preferences、開(kāi)新窗口、退出。NSApplicationDelegateAdaptor 做生命周期監(jiān)聽(tīng)。App Sandbox 和用戶選擇的文件讀寫(xiě)權(quán)限。一個(gè)適合第一個(gè) macOS 應(yīng)用的最小代碼骨架類似這樣import SwiftUI main struct MyMacApp: App { StateObject private var appState AppState() var body: some Scene { WindowGroup { ContentView() .environmentObject(appState) .frame(minWidth: 800, minHeight: 600) } .commands { CommandGroup(replacing: .appInfo) { Button(關(guān)于 MyMacApp) { appState.showAbout true } } } } }這個(gè)骨架雖然簡(jiǎn)單但已經(jīng)包含了一個(gè)高標(biāo)準(zhǔn) Mac app 的關(guān)鍵習(xí)慣用 AppState 統(tǒng)一管理可觀察狀態(tài)、給窗口設(shè)置最小尺寸、自定義 Commands 菜單而不是接受“毛坯”默認(rèn)菜單。很多第一個(gè) App 最后被評(píng)測(cè)編輯扣分問(wèn)題往往不在動(dòng)畫(huà)和特效上而在窗口邏輯和默認(rèn)菜單欄設(shè)置上。macOS 用戶對(duì)“像不像 Mac 原生軟件”非常敏感。3. 使用 Xcode 工程結(jié)構(gòu)和模塊化設(shè)計(jì)做第一個(gè) Mac app 時(shí)最容易踩的坑是把所有代碼塞進(jìn) ContentView.swift 和 AppDelegate。當(dāng)功能少的時(shí)候問(wèn)題不明顯一旦開(kāi)始做菜單欄快捷操作、后臺(tái)任務(wù)、文件導(dǎo)入導(dǎo)出、偏好設(shè)置代碼就會(huì)迅速膨脹。建議從第一天就按目錄拆分MyMacApp/ ├── App/ │ ├── MyMacApp.swift │ ├── AppState.swift │ └── AppDelegate.swift ├── Features/ │ ├── Home/ │ │ ├── HomeView.swift │ │ └── HomeViewModel.swift │ ├── Settings/ │ │ ├── SettingsView.swift │ │ └── SettingsStore.swift │ └── Export/ │ ├── ExportWorker.swift │ └── ExportOptionsView.swift ├── Services/ │ ├── FileService.swift │ ├── NetworkService.swift │ └── LicenseService.swift ├── Models/ │ └── AppModels.swift └── Supporting/ ├── Assets.xcassets └── Info.plist這種分層不需要完整引入復(fù)雜的架構(gòu)框架只要確保 View、ViewModel、Service、Model 之間的關(guān)注點(diǎn)被分開(kāi)就能解決大多數(shù)“第一個(gè) app”在后期維護(hù)時(shí)的失控問(wèn)題。評(píng)測(cè)編輯雖然不會(huì)直接看源碼但代碼組織直接決定 bug 修復(fù)效率換句話講它決定你能不能在評(píng)測(cè)周期內(nèi)快速把問(wèn)題改完。4. 文件訪問(wèn)、沙盒與權(quán)限流程如果你從 iOS 或者網(wǎng)頁(yè)開(kāi)發(fā)轉(zhuǎn)過(guò)來(lái)第一件需要重新學(xué)習(xí)的事是 macOS 沙盒權(quán)限。Mac app 在 App Store 必須開(kāi)啟沙盒即使繞過(guò) App Store 分發(fā)用戶的系統(tǒng)也會(huì)默認(rèn)限制未簽名、未公證應(yīng)用的文件訪問(wèn)能力。評(píng)分高的產(chǎn)品幾乎都在權(quán)限彈窗和用戶授權(quán)流程上做得很細(xì)致。沙盒文件訪問(wèn)的核心原則是“盡量讓用戶主動(dòng)選擇文件而不要直接全盤(pán)掃文件”。例如讓用戶導(dǎo)入文件時(shí)推薦使用 NSOpenPanel 而不是直接訪問(wèn)固定目錄import AppKit import UniformTypeIdentifiers func selectInputFile() - URL? { let panel NSOpenPanel() panel.canChooseFiles true panel.canChooseDirectories false panel.allowsMultipleSelection false panel.allowedContentTypes [.item] if panel.runModal() .OK { return panel.url } return nil }如果應(yīng)用確實(shí)需要訪問(wèn)用戶指定的一個(gè)文件夾例如做批量圖片壓縮或 Markdown 文件庫(kù)可以使用 Security-Scoped Bookmark 保存用戶授權(quán)避免每次啟動(dòng)都彈窗// 保存授權(quán) let bookmarkData try url.bookmarkData( options: .withSecurityScope, includingResourceValuesForKeys: nil, relativeTo: nil ) UserDefaults.standard.set(bookmarkData, forKey: folderBookmark) // 恢復(fù)授權(quán) var isStale false let restoredURL try URL( resolvingBookmarkData: storedData, options: .withSecurityScope, relativeTo: nil, bookmarkDataIsStale: isStale ) let accessOK restoredURL.startAccessingSecurityScopedResource()在 macOS 13 之后的系統(tǒng)上還需要注意 App Sandbox 配合隱私庫(kù)的整體策略。你不應(yīng)該用“繞過(guò)權(quán)限機(jī)制”的方式去讀取用戶文件因?yàn)樵跍y(cè)評(píng)環(huán)境里未聲明用途卻訪問(wèn)隱私數(shù)據(jù)是高風(fēng)險(xiǎn)問(wèn)題。5. 一鍵啟動(dòng)與安裝包分發(fā)從 dmg 到 Notarization標(biāo)題里沒(méi)有提分發(fā)渠道但對(duì) Mac 應(yīng)用開(kāi)發(fā)者來(lái)說(shuō)上線測(cè)試和第三方評(píng)測(cè)通常意味著要交付一個(gè)可以直接雙擊安裝的 dmg 文件而不是讓評(píng)測(cè)編輯從 Xcode 里跑工程。你需要提前把打包、簽名和公證流程自動(dòng)化以防拿到高分卻卡在“編輯根本裝不上”。一個(gè)標(biāo)準(zhǔn)的分發(fā)鏈路如下使用 Xcode 的 Archive 功能導(dǎo)出 Release 包。使用 Developer ID Application 證書(shū)簽名。將 .app 放置到干凈的 dmg 磁盤(pán)鏡像中。使用 Developer ID Installer 或直接對(duì) dmg 做公證。通過(guò) stapler 將公證票據(jù)貼到應(yīng)用上。最常用的公證命令是# 先導(dǎo)出 Release 構(gòu)建之后對(duì) app 做簽名 codesign --deep --force --verify --verbose \ --sign Developer ID Application: Your Name (TEAMID) \ build/MyMacApp.app # 壓縮并提交公證 ditto -c -k --keepParent build/MyMacApp.app MyMacApp.zip xcrun notarytool submit MyMacApp.zip \ --apple-id youremail.com \ --team-id TEAMID \ --password app-specific-password \ --wait # 公證通過(guò)后將票據(jù)粘貼到應(yīng)用上 xcrun stapler staple build/MyMacApp.app這里有一個(gè)細(xì)節(jié)值得注意即使你打算直接在官網(wǎng)分發(fā) zip 包公證也會(huì)顯著減少 Gatekeeper 對(duì)“未驗(yàn)證開(kāi)發(fā)者”的攔截。用戶雙擊應(yīng)用時(shí)系統(tǒng)提示會(huì)從紅色警告變成普通的“打開(kāi)”確認(rèn)框。無(wú)論是評(píng)測(cè)編輯還是普通用戶安裝體驗(yàn)都會(huì)順暢很多。如果不想用命令行Xcode 的 Organizer 窗口里也提供了 Distribute App 圖形化向?qū)нx擇 Developer ID 和 Upload 即可完成大部分流程。但工程化項(xiàng)目建議把簽名和公證寫(xiě)成腳本方便每次發(fā)布前做一致性檢查。6. 應(yīng)用體積、啟動(dòng)速度和后臺(tái)行為第三方評(píng)測(cè)很少只看功能是否多他們往往更在意一個(gè) app 是否對(duì)系統(tǒng)“友好”。即使你的 app 功能全面如果首次啟動(dòng)要卡 3 秒、在后臺(tái)長(zhǎng)期占用 20% CPU評(píng)分一定上不去。建議把以下指標(biāo)寫(xiě)進(jìn)每次 Release 的自檢表指標(biāo)建議觀察方式常見(jiàn)超標(biāo)原因冷啟動(dòng)時(shí)間使用 Instruments Time Profiler初始化了不需要的數(shù)據(jù)庫(kù)、網(wǎng)絡(luò)請(qǐng)求阻塞主線程應(yīng)用體積檢查 .app 包大小內(nèi)置過(guò)多無(wú)用字體、資源、重復(fù)框架后臺(tái) CPU 占用Activity Monitor 持續(xù)觀察定時(shí)器未失效、重復(fù)輪詢網(wǎng)絡(luò)內(nèi)存占用Xcode Memory Gauge緩存不清理、圖片未縮略加載硬盤(pán)寫(xiě)入使用 fs_usage 或 Instruments頻繁寫(xiě) UserDefaults、無(wú)必要日志在 SwiftUI 應(yīng)用里一個(gè)很常見(jiàn)的隱藏問(wèn)題是用了復(fù)雜的視圖刷新邏輯每次用戶切換窗口都重復(fù)計(jì)算。某些界面可以通過(guò) Reduce 狀態(tài)更新范圍解決struct ContentView: View { State private var index 0 let items [Tab A, Tab B, Tab C] var body: some View { Picker(選擇, selection: $index) { ForEach(items.indices, id: \.self) { i in Text(items[i]).tag(i) } } .pickerStyle(.segmented) // 只刷新當(dāng)前內(nèi)容區(qū)避免每次切換重構(gòu)全部視圖 ZStack { if index 0 { HomeView() } else if index 1 { ListView() } else { SettingsView() } } .id(index) // 明確隔離切換后的狀態(tài) } }性能優(yōu)化的終極目標(biāo)不是“代碼跑得飛快”而是“用戶和評(píng)測(cè)方都沒(méi)有感知到它在耗資源”。這種克制感在 Mac 軟件測(cè)評(píng)里是一種很強(qiáng)的加分項(xiàng)。7. 從第三方評(píng)測(cè)視角補(bǔ)齊用戶體驗(yàn)獲得 MacSources 的 97% 評(píng)分很大程度上不是因?yàn)榧夹g(shù)功能多搶眼而是整個(gè)產(chǎn)品符合評(píng)測(cè)編輯對(duì)“優(yōu)質(zhì) Mac app”的預(yù)期。也就是說(shuō)隱藏的錨點(diǎn)是“體驗(yàn)完整度”。下面幾個(gè)體驗(yàn)點(diǎn)最容易在開(kāi)發(fā)時(shí)被忽略。第一菜單欄應(yīng)用名的命名。很多開(kāi)發(fā)者只注意 dmg 文件名忽略了 .app 包內(nèi)部 Info.plist 的 CFBundleDisplayName。用戶安裝后菜單欄頂部會(huì)顯示一個(gè)不合適的字符串觀感立刻變差。keyCFBundleDisplayName/key stringMyMacApp/string keyCFBundleName/key stringMyMacApp/string keyCFBundleShortVersionString/key string1.0.0/string keyCFBundleVersion/key string1/string keyLSMinimumSystemVersion/key string13.0/string第二打開(kāi)外部鏈接時(shí)應(yīng)該使用系統(tǒng)瀏覽器。macOS 開(kāi)發(fā)者如果直接在 app 內(nèi)寫(xiě)死加載網(wǎng)頁(yè)遇到沙盒環(huán)境會(huì)失敗。正確方式是用 NSWorkspace.shared.open。import AppKit func openExternalLink(_ urlString: String) { guard let url URL(string: urlString) else { return } NSWorkspace.shared.open(url) } // 示例調(diào)用 openExternalLink(https://example.com/help)第三退出行為和窗口關(guān)閉行為需要符合 macOS 習(xí)慣。很多從 Windows 遷移理念的 app 會(huì)在右上角放一個(gè)“退出”大按鈕但在 macOS 上紅色關(guān)閉按鈕只關(guān)閉窗口并不退出整個(gè) app。菜單欄 CommandQ 退出才是最主流的方式。如果你想做“關(guān)閉主窗口即退出”的類型可以顯式設(shè)置import AppKit class AppDelegate: NSObject, NSApplicationDelegate { func applicationShouldTerminateAfterLastWindowClosed(_ sender: NSApplication) - Bool { // 菜單欄常駐類 app 返回 false普通窗口類 app 返回 true return true } }這類細(xì)節(jié)并不難做但它決定了評(píng)測(cè)編輯在寫(xiě)評(píng)測(cè)時(shí)會(huì)用“原生”還是“移植”來(lái)定位你的產(chǎn)品。8. 崩潰與數(shù)據(jù)安全分?jǐn)?shù)之外的底線一個(gè)人開(kāi)發(fā) macOS app如果沒(méi)有完整的崩潰收集機(jī)制很多問(wèn)題要等用戶差評(píng)之后才知道。評(píng)測(cè)編輯通常會(huì)在短時(shí)間內(nèi)高強(qiáng)度使用功能如果觸發(fā)崩潰直接從高分名單掉落。第三方評(píng)測(cè)關(guān)注穩(wěn)定性不是沒(méi)有道理的。他們常見(jiàn)的測(cè)試操作包括快速切換頁(yè)面、連續(xù)導(dǎo)入導(dǎo)出文件、在窗口和菜單欄之間點(diǎn)擊、鎖屏喚醒后繼續(xù)使用、用低電量 Mac 測(cè)試性能模式等等。這里面的壓力操作普通功能測(cè)試階段往往不會(huì)覆蓋。建議在開(kāi)發(fā)早期接一個(gè)崩潰收集服務(wù)至少要能在自己設(shè)備上看 crash log# 從本機(jī)導(dǎo)出崩潰日志方便定位 Release 版錯(cuò)誤 log show --predicate process MyMacApp --last 30m crash.log對(duì)于更工程化的團(tuán)隊(duì)也可以使用商業(yè)或開(kāi)源的 Crash Reporter SDK。當(dāng)你收到評(píng)測(cè)者反饋“某個(gè)功能打不開(kāi)”時(shí)不能只靠猜必須能迅速對(duì)應(yīng)到版本和調(diào)用棧。同時(shí)考慮數(shù)據(jù)安全。Mac app 如果處理的是用戶文檔寫(xiě)入文件時(shí)不應(yīng)該直接覆蓋原文件最好先寫(xiě)臨時(shí)文件再 atomic 替換import Foundation func safeWrite(data: Data, to url: URL) throws { var tempURL url tempURL.appendPathExtension(tmp) try data.write(to: tempURL, options: .atomic) if FileManager.default.fileExists(atPath: url.path) { try FileManager.default.removeItem(at: url) } try FileManager.default.moveItem(at: tempURL, to: url) }如果評(píng)測(cè)編輯在測(cè)試過(guò)程中發(fā)現(xiàn)應(yīng)用導(dǎo)致原文件損壞或丟失那不只是評(píng)分問(wèn)題而是產(chǎn)品是否還能繼續(xù)發(fā)布的問(wèn)題。9. macOS 版本和芯片架構(gòu)適配截至 Intel Mac 仍有一部分存量用戶Apple Silicon 已經(jīng)成為絕對(duì)主流。第三方評(píng)測(cè)站通常不會(huì)只用一臺(tái)電腦測(cè)試他們可能在新舊系統(tǒng)之間切換也會(huì)關(guān)注 Universal 2 架構(gòu)的應(yīng)用是否能原生運(yùn)行。在 Xcode 中把 ARCHS 設(shè)為 Standard Architectures 會(huì)讓構(gòu)建同時(shí)包含 arm64 和 x86_64 版本。對(duì)個(gè)人開(kāi)發(fā)者來(lái)說(shuō)如果不需要支持特別老的系統(tǒng)默認(rèn) Universal 2 是一個(gè)安全選擇。建議部署的最低 macOS 版本不宜設(shè)得太保守或多變。如果你的 app 使用了 SwiftUI 較新的 API又聲明支持 11.0那就會(huì)導(dǎo)致運(yùn)行時(shí)報(bào)錯(cuò)。標(biāo)題雖然沒(méi)提具體系統(tǒng)版本但合理策略是使用自己手頭能完整測(cè)試的最小系統(tǒng)版本作為最低支持版本。不要僅憑 API availability 推斷兼容性。對(duì)最低系統(tǒng)版本做一次完整回歸因?yàn)樾掳?Xcode 編譯器可能在舊系統(tǒng)上出現(xiàn)運(yùn)行時(shí)錯(cuò)誤。可以使用available來(lái)保護(hù)新版 API 調(diào)用避免災(zāi)難問(wèn)題import SwiftUI struct ContentView: View { var body: some View { if #available(macOS 14.0, *) { Text(支持新版本系統(tǒng)) .fontDesign(.rounded) } else { Text(舊系統(tǒng)使用普通字體) } } }第一個(gè) app 最怕的是為了“支持所有舊系統(tǒng)”把開(kāi)發(fā)復(fù)雜度無(wú)限拉高。與其覆蓋過(guò)寬導(dǎo)致難以驗(yàn)證不如把最常用的三個(gè)大版本測(cè)試充分。10. 隱私清單與數(shù)據(jù)收集克制2023 年之后Apple 對(duì) App Store 應(yīng)用要求提供隱私清單說(shuō)明應(yīng)用是否收集數(shù)據(jù)、是否使用第三方 SDK、是否訪問(wèn)“必要理由”的 API。這些要求對(duì)第三方評(píng)測(cè)也是一種參考信號(hào)如果你的 app 需要訪問(wèn)用戶文件、網(wǎng)絡(luò)、剪貼板卻沒(méi)有在說(shuō)明里寫(xiě)清理由評(píng)測(cè)編輯很可能對(duì)隱私表現(xiàn)扣分。獨(dú)立開(kāi)發(fā)的 app 能拿高分通常在隱私處理上非常克制。核心原則只有一條能不收集就不收集能本地處理就本地處理。比如一款 OCR 工具如果把用戶截圖直接上傳到個(gè)人服務(wù)器評(píng)測(cè)編輯很難給出高分反過(guò)來(lái)如果完全離線、只在本地識(shí)別并且在 Info.plist 中清晰聲明給用戶的信任感會(huì)完全不同。如果你確實(shí)需要網(wǎng)絡(luò)服務(wù)應(yīng)該做成用戶主動(dòng)觸發(fā)、可撤銷授權(quán)的形式import SwiftUI final class PrivacySettings: ObservableObject { AppStorage(allowAnalytics) var allowAnalytics: Bool false AppStorage(allowNetwork) var allowNetwork: Bool false } struct PrivacySettingsView: View { ObservedObject var settings PrivacySettings() var body: some View { Form { Toggle(允許發(fā)送匿名使用統(tǒng)計(jì), isOn: $settings.allowAnalytics) Toggle(允許訪問(wèn)網(wǎng)絡(luò)以獲取更新, isOn: $settings.allowNetwork) } .padding() } }這樣的設(shè)置面板雖然看起來(lái)很簡(jiǎn)單但在評(píng)測(cè)視角里代表開(kāi)發(fā)者有隱私意識(shí)。Mac 老用戶非常在意的就是“功能雖然免費(fèi)但不知道在背后上傳什么”。11. 從 90% 到 97%如何找出評(píng)測(cè)扣分點(diǎn)如果第三方評(píng)測(cè)給的是 90%大多數(shù)人會(huì)滿足想拿 97%就要在發(fā)布前主動(dòng)“找茬”。這里給出一套不需要評(píng)測(cè)媒體也能執(zhí)行的問(wèn)題掃描流程。第一讓從未用過(guò)該 app 的人完成核心操作任務(wù)。記錄他是否會(huì)卡在“不知道怎么導(dǎo)入”“不知道保存到哪”。很多第一個(gè) app 的功能入口都在開(kāi)發(fā)者腦子里但普通用戶找不到。第二模擬斷網(wǎng)、磁盤(pán)滿、文件被鎖定等異常場(chǎng)景。評(píng)測(cè)編輯不會(huì)只測(cè)正常路徑。一個(gè)剛能用但“全鏈路異常處理缺失”的產(chǎn)品遇到任何一次網(wǎng)絡(luò)失敗就可能直接白屏或無(wú)響應(yīng)。第三做完整的權(quán)限撤銷測(cè)試。用戶在系統(tǒng)設(shè)置里關(guān)掉你的權(quán)限后下一次操作應(yīng)該能引導(dǎo)用戶重新授權(quán)而不是默默失敗。第四用干凈的系統(tǒng)賬號(hào)測(cè)試“全新安裝”流程。不要用開(kāi)發(fā)者一直裝著自己 app 的電腦做最終驗(yàn)收否則很多現(xiàn)實(shí)問(wèn)題會(huì)被掩蓋。第五檢查所有外部文案和提示。拼寫(xiě)錯(cuò)誤、解釋不清的錯(cuò)誤彈窗、含糊的確認(rèn)按鈕都會(huì)讓評(píng)測(cè)體驗(yàn)打折。錯(cuò)誤信息要寫(xiě)清楚“為什么失敗”和“接下來(lái)能做什么”。12. 常見(jiàn)問(wèn)題與排查方法獨(dú)立開(kāi)發(fā)者做 Mac app上架前后最常遇到的就是環(huán)境、簽名與權(quán)限問(wèn)題。下面的表可以當(dāng)一個(gè)快速定位入口。問(wèn)題現(xiàn)象可能原因排查方式解決方案用戶無(wú)法打開(kāi)提示已損壞缺少簽名或公證票Gatekeeper 日志、codesign 驗(yàn)證重新簽名并做 notarytool 公證啟動(dòng)后提示沒(méi)有權(quán)限讀取文件沙盒權(quán)限未配置或未使用 OpenPanel檢查 App Sandbox entitlement使用文檔讀取接口或 Security-Scoped Bookmark在舊版 macOS 上閃退使用了更高版本 API 且無(wú) availability 保護(hù)查看崩潰日志、檢查 available增加系統(tǒng)版本判斷或提高最低系統(tǒng)版本菜單欄圖標(biāo)不顯示沒(méi)有給 MenuBarExtra 正確設(shè)置圖片模板模式檢查 Assets 圖片使用 Template 圖片并避免彩色著色打包 dmg 體積過(guò)大包含了 Debug 符號(hào)或無(wú)用的架構(gòu)查看 .app 包內(nèi)文件Release 構(gòu)建去除調(diào)試符號(hào)精簡(jiǎn)資源無(wú)法連接開(kāi)發(fā)者賬號(hào)公證證書(shū)/專用密碼配置錯(cuò)誤檢查 team ID 和 Apple ID生成 app-specific password用戶反饋數(shù)據(jù)丟失直接覆蓋原文件代碼審查寫(xiě)入邏輯改成臨時(shí)文件 atomic replace13. 最佳實(shí)踐給第一個(gè) Mac app 的發(fā)布建議如果你正在開(kāi)發(fā)自己的第一個(gè) Mac app并且想像標(biāo)題那樣在 MacSources 這類媒體測(cè)評(píng)上拿高分建議在發(fā)布前把下面幾件事固化成檢查清單工程從 Xcode 模板創(chuàng)建不用第三方非標(biāo)準(zhǔn)構(gòu)建系統(tǒng)降低環(huán)境依賴。Release 構(gòu)建啟用編譯器優(yōu)化不把 Debug 包發(fā)給評(píng)測(cè)方。給應(yīng)用提供“真實(shí)可用的圖標(biāo)”和“正確的菜單欄名稱”這比加一百個(gè)功能更能建立信任。至少完整測(cè)試一次全新用戶的首次啟動(dòng)體驗(yàn)不依賴本地開(kāi)發(fā)環(huán)境中的數(shù)據(jù)。產(chǎn)品頁(yè)介紹與 app 實(shí)際功能保持嚴(yán)格一致避免評(píng)測(cè)編輯發(fā)現(xiàn)“被宣傳誤導(dǎo)”。如果涉及網(wǎng)絡(luò)上傳、音頻錄制、文件掃描要有最小授權(quán)說(shuō)明。每輪修復(fù)后重新打包公證并讓測(cè)試者使用官網(wǎng)或 TestFlight 分發(fā)的完整包而不是 Xcode 直接 Run。最后給自己留一個(gè)“質(zhì)量復(fù)盤(pán)日”把構(gòu)建產(chǎn)物安裝到一臺(tái)最普通的 Mac 上像真實(shí)用戶一樣從頭到尾把所有功能用一遍把所有按鈕點(diǎn)一遍把所有窗口排列組合一遍。很多時(shí)候97% 和 90% 的差距其實(shí)就少在這一遍徹底的自測(cè)上。