System Extension注册完成 + FSKit Driver待办事项
已完成: ✅ App ID(6770506571) ✅ Bundle ID(com.momentry.markbase.fskit) ✅ Developer ID Application证书导入 ✅ .app Bundle创建(build/MarkBaseFSKit.app) ✅ entitlements.plist配置 限制: - binary未实现FSKit driver(占位符) - 无法通过systemextensionsctl install安装 - 需要完整FSKit接口实现 策略: - 短期:WebDAV(500 MB/s) - 长期:FSKit Driver完整实现(650 MB/s) 文档: - SYSTEM_EXTENSION_MANUAL_INSTALL.md - FSKIT_DRIVER_TODO.md(未来待办)
This commit is contained in:
144
docs/SYSTEM_EXTENSION_MANUAL_INSTALL.md
Normal file
144
docs/SYSTEM_EXTENSION_MANUAL_INSTALL.md
Normal file
@@ -0,0 +1,144 @@
|
||||
# System Extension 手动安装指南
|
||||
|
||||
## 当前状态
|
||||
|
||||
**.app Bundle已准备好:**
|
||||
- Location: build/MarkBaseFSKit.app
|
||||
- Bundle ID: com.momentry.markbase.fskit
|
||||
- Certificate: Developer ID Application: Accusys,Inc (K3TDMD9Y6B)
|
||||
- Team ID: K3TDMD9Y6B
|
||||
- Status: Signed ✅
|
||||
|
||||
---
|
||||
|
||||
## 安装方法
|
||||
|
||||
### 方法1:直接打开(尝试中)
|
||||
|
||||
```bash
|
||||
open build/MarkBaseFSKit.app
|
||||
```
|
||||
|
||||
**预期结果:**
|
||||
- macOS弹出:"MarkBaseFSKit wants to install a system extension"
|
||||
- System Settings → Privacy & Security → Allow按钮出现
|
||||
- 点击Allow → 重启Mac → 安装完成
|
||||
|
||||
**如果无反应:**
|
||||
- 需要将.app复制到Applications目录
|
||||
|
||||
---
|
||||
|
||||
### 方法2:复制到Applications(标准方法)
|
||||
|
||||
```bash
|
||||
# 需要sudo权限
|
||||
sudo cp -r build/MarkBaseFSKit.app /Applications/
|
||||
|
||||
# 打开.app触发安装
|
||||
open /Applications/MarkBaseFSKit.app
|
||||
```
|
||||
|
||||
**安装流程:**
|
||||
1. macOS弹出:"MarkBaseFSKit wants to install a system extension"
|
||||
2. 点击"Open System Settings"
|
||||
3. System Settings → Privacy & Security
|
||||
4. 找到"System Extension from Accusys,Inc"条目
|
||||
5. 点击**Allow**按钮
|
||||
6. macOS要求重启 → Restart
|
||||
7. 重启后System Extension安装完成
|
||||
|
||||
---
|
||||
|
||||
## 验证安装成功
|
||||
|
||||
```bash
|
||||
systemextensionsctl list
|
||||
```
|
||||
|
||||
**预期输出:**
|
||||
```
|
||||
1 extension(s)
|
||||
MarkBaseFSKit (com.momentry.markbase.fskit) [active]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 如果安装失败
|
||||
|
||||
### 可能原因:
|
||||
|
||||
**1. .app Bundle结构问题**
|
||||
- 缺少PkgInfo文件
|
||||
- Info.plist格式错误
|
||||
- entitlements配置不正确
|
||||
|
||||
**解决方案:**
|
||||
```bash
|
||||
# 添加PkgInfo文件
|
||||
echo -n "APPL????" > build/MarkBaseFSKit.app/Contents/PkgInfo
|
||||
|
||||
# 重新签名
|
||||
codesign --sign "Developer ID Application: Accusys,Inc (K3TDMD9Y6B)" \
|
||||
--entitlements entitlements.plist \
|
||||
--identifier "com.momentry.markbase.fskit" \
|
||||
--options runtime \
|
||||
--timestamp \
|
||||
build/MarkBaseFSKit.app
|
||||
```
|
||||
|
||||
**2. System Extension类型不支持**
|
||||
- macOS可能需要特定类型的System Extension
|
||||
- 当前设置:filesystem类型
|
||||
|
||||
**解决方案:**
|
||||
- 检查Info.plist中NSSystemExtension=true
|
||||
- 检查entitlements中com.apple.developer.system-extension权限
|
||||
|
||||
**3. 证书权限问题**
|
||||
- Developer ID Application证书可能需要特定权限
|
||||
|
||||
**解决方案:**
|
||||
- 检查证书是否支持System Extension签名
|
||||
- 查看Portal证书详情
|
||||
|
||||
---
|
||||
|
||||
## System Extension调试
|
||||
|
||||
**检查.app bundle完整性:**
|
||||
```bash
|
||||
codesign -d -vv --entitlements - build/MarkBaseFSKit.app
|
||||
```
|
||||
|
||||
**检查Gatekeeper评估:**
|
||||
```bash
|
||||
spctl -a -vv build/MarkBaseFSKit.app
|
||||
```
|
||||
|
||||
**检查System Extension日志:**
|
||||
```bash
|
||||
log show --predicate 'process == "systemextensionsd"' --last 5m
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 当前需要用户执行
|
||||
|
||||
**步骤1:** 如果直接打开无反应,手动复制到Applications
|
||||
```bash
|
||||
sudo cp -r build/MarkBaseFSKit.app /Applications/
|
||||
```
|
||||
|
||||
**步骤2:** 打开.app触发安装
|
||||
```bash
|
||||
open /Applications/MarkBaseFSKit.app
|
||||
```
|
||||
|
||||
**步骤3:** System Settings批准
|
||||
- Privacy & Security → Allow
|
||||
- 重启Mac
|
||||
|
||||
---
|
||||
|
||||
**最后更新:** 2026-05-18 20:37
|
||||
Reference in New Issue
Block a user