# macOS 发行版和 StoreKit ## 关键限制 * ❌ 未经代码签名请勿分发 → ✅ 始终使用开发者 ID（直接）或 Apple 分发（App Store）进行签名 * ❌ 不要跳过直接分发的公证 → ✅ 自 macOS 10.15 起对于 Gatekeeper 是必需的 * ❌ 不要使用 `Transaction.currentEntitlement(for:)` → ✅ 使用 `Transaction.currentEntitlements(for:)` （复数，返回序列） * ❌ 不要忘记 PrivacyInfo.xcprivacy → ✅ App Store 提交所需 ## 分布决策树应用商店分布？ ├── YES → Apple发行证书+沙箱+审核 │ ├── 基础版（沙箱安全功能） │ └── 通过 IAP/订阅的 Pro 功能 └── 直销？ ├── 开发者ID证书+公证 ├── DMG 或 pkg 安装程序 └── 完整的系统访问权限（无需沙箱）双重策略？ ├── App Store：基础/免费版，沙盒安全 └── Direct：专业版，完整的辅助功能/CGEvent 访问权限 ## 代码签名和公证（直接） # 使用开发者 ID 进行签名 codesign --deep --force --verify --verbose \ --sign“开发者 ID 应用程序：您的姓名 (TEAMID)”\ --选项运行时\ 我的应用程序 # 创建DMG hdiutil create -volname "MyApp" -srcfolder MyApp.app \ -ov -format UDZO MyApp.dmg # 公证 xcrun notarytool 提交 MyApp.dmg \ --apple-id“you@email.com”\ --team-id“TEAMID”\ --password“应用程序特定密码”\ --等等 # 订书钉（附上公证书） xcrun 订书机订书机 MyApp.dmg ## 沙盒权利（App Store） <字典> com.apple.security.app-sandbox com.apple.security.network.client com.apple.security.files.user-selected.read-write com.apple.developer.icloud-container-identifiers iCloud.com.company.app com.apple.security.application-groups <数组><字符串>group.com.company.app ## StoreKit — SubscriptionOfferView 导入 StoreKit // 基本订阅优惠 SubscriptionOfferView（产品ID：“com.app.pro.monthly”） .prefersPromotionalIcon(true) // 带有自定义图标 SubscriptionOfferView(productID: "com.app.pro.monthly") { Image("pro_icon").ressized().frame(宽度：40，高度：40) } // 根据客户状态显示升级/降级 SubscriptionOfferView（groupID：“com.app.subscriptions”，visibleRelationship：.upgrade） // 详细动作 SubscriptionOfferView（产品ID：“com.app.pro.monthly”） .subscriptionOfferViewDetailAction { isShowingStore = true } ## StoreKit — 事务处理 // 检查权利（新的复数 API）对于 Transaction.currentEntitlements 中的等待结果（for：“com.app.pro”）{ if case .verified(let transaction) = 结果 { 让appTxID = transaction.appTransactionID 如果让 OfferPeriod = transaction.offerPeriod { // 处理报价周期 } } } // 跟踪订阅状态 .subscriptionStatusTask(for: "com.app.subscriptions") { 状态 if statuses.contains(其中：{ $0.state == .subscribed }) { 客户状态=.订阅 } 否则{ 客户状态 = .notSubscribed } } // AppTransaction — 唯一下载标识符让 appTransaction = 尝试等待 AppTransaction.shared 让 transactionID = appTransaction.appTransactionID let platform = appTransaction.originalPlatform // .iOS、.macOS、.tvOS、.visionOS ## 在 Xcode 中进行 StoreKit 测试 1.文件→新建→文件从模板→搜索“StoreKit配置文件” 2. 在`.storekit`文件中定义产品 3. 编辑方案 → 选项 → StoreKit 配置 → 选择您的文件 4. 使用事务管理器窗口测试购买场景 ## 登录时启动导入服务管理 func setLaunchAtLogin(_ 启用: Bool) { 做{ 如果启用 { 尝试 SMAppService.mainApp.register() } 否则 { 尝试 SMAppService.mainApp.unregister() } } catch { print("登录时启动错误：\(错误)") } } func isLaunchAtLoginEnabled() -> Bool { SMAppService.mainApp.status == .启用 } ## 常见错误和修复错误|修复 ---|--- “应用程序已损坏”错误 |分发前经过公证和装订 App Store 拒绝授权 |在审查笔记中证明每项权利的合理性 `currentEntitlement(for:)` 已弃用 |使用“currentEntitlements(for:)”（复数）缺少隐私清单 |将 PrivacyInfo.xcprivacy 添加到应用程序目标 StoreKit 产品未在开发中加载 |在方案选项中设置 StoreKit Configuration ## 参考文献 * [公证 macOS 软件]() * [应用程序沙箱设计指南]() * [StoreKit 文档]() * [WWDC 2025：StoreKit 新增功能]()

MacOS 发行版

包含技能