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:
Warren
2026-05-18 20:45:50 +08:00
parent 14863d323e
commit 71fa48a626
29 changed files with 3625 additions and 0 deletions

View 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