# System Extension 注册完整流程

## 已完成步骤

### 步骤1：App ID创建 ✅

**关键信息：**
- Apple ID: `6770506571`
- Bundle ID: `com.momentry.markbase.fskit`
- Team ID: `K3TDMD9Y6B`
- Platform: iOS, iPadOS, macOS, tvOS, watchOS, visionOS

**Portal操作：**
- ✅ 已创建App ID
- ⏳ 需填写Description：MarkBaseFS
- ⏳ 点击Save保存

---

## 待完成步骤

### 步骤2：创建Certificate

**Portal操作：**
1. 左侧菜单 → **Certificates**
2. 点击 **+** 按钮
3. 选择：**Mac App Development**
4. 点击 **Continue**

**本地操作：**
- CSR已生成：`~/Desktop/markbase_developer.csr`
- 私钥已生成：`~/Desktop/markbase_developer.key`

**上传CSR：**
- 点击 **Choose File**
- 选择：`~/Desktop/markbase_developer.csr`
- 点击 **Continue**

**Portal生成：**
- Certificate生成成功
- 点击 **Download** 按钮
- 保存到：`~/Downloads/`（文件名通常是`developer_certificate.cer`）

---

### 步骤3：导入证书

**运行脚本：**
```bash
./scripts/install_system_extension_final.sh
```

**或手动执行：**
```bash
security import ~/Downloads/developer_certificate.cer \
  -k ~/Library/Keychains/login.keychain-db \
  -T /usr/bin/codesign
```

**验证导入：**
```bash
security find-identity -v -p codesigning
# 输出应显示：1 valid identities found
```

---

### 步骤4：构建签名应用

**需要Xcode项目：**
- 创建 `MarkBaseFSKit.xcodeproj`
- 配置 `PRODUCT_BUNDLE_IDENTIFIER = com.momentry.markbase.fskit`
- 配置 `DEVELOPMENT_TEAM = K3TDMD9Y6B`

**或使用现有binary：**
```bash
codesign --sign "Apple Development" \
  --entitlements entitlements.plist \
  --identifier com.momentry.markbase.fskit \
  target/release/fskit_mount
```

---

### 步骤5：安装System Extension

**使用系统命令：**
```bash
systemextensionsctl install \
  --team K3TDMD9Y6B \
  --bundleID com.momentry.markbase.fskit \
  --type filesystem \
  build/Release/MarkBaseFSKit.app
```

**或运行脚本：**
```bash
./scripts/install_system_extension_final.sh
```

---

### 步骤6：用户批准（必须手动）

**macOS弹出提示：**
1. "MarkBaseFSKit wants to install a system extension"
2. 打开 **System Settings → Privacy & Security**
3. 点击 **Allow** 按钮
4. 重启Mac完成安装

**验证安装：**
```bash
systemextensionsctl list
# 输出应显示：1 extension(s)
# MarkBaseFSKit (com.momentry.markbase.fskit) [active]
```

---

## 关键配置文件

### entitlements.plist

```xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>com.apple.developer.system-extension</key>
    <true/>
    <key>com.apple.developer.system-extension.install</key>
    <true/>
    <key>com.apple.security.files.user-selected.read-write</key>
    <true/>
</dict>
</plist>
```

---

## 文件清单

|文件 |位置 |用途 |
|------|------|------|
| CSR文件 | ~/Desktop/markbase_developer.csr | 上传到Portal |
| 私钥文件 | ~/Desktop/markbase_developer.key | 本地保存（不要上传）|
| 证书文件 | ~/Downloads/developer_certificate.cer | Portal下载 |
| 安装脚本 | scripts/install_system_extension_final.sh | 一键安装 |
| Entitlements | entitlements.plist | 权限配置 |

---

## 时间估算

|步骤 |时间 |
|------|------|
| App ID创建 | 5分钟 ✅（已完成）|
| CSR生成 | 1分钟 ✅（已完成）|
| Certificate创建 | 3分钟 ⏳ |
| 证书下载 | 1分钟 ⏳ |
| 导入+安装 | 2分钟 ⏳ |
| 用户批准 | 1分钟 ⏳（手动）|
| **总计** | **13分钟** |

---

## 下一步操作

**立即需要：**

1. **Portal填写Description**
   - Description: `MarkBaseFS`
   - 点击 **Save**

2. **Portal创建Certificate**
   - Certificates → +按钮
   - Mac App Development
   - 上传 `~/Desktop/markbase_developer.csr`

3. **下载证书**
   - Portal Download → `~/Downloads/`

4. **运行安装脚本**
   - `./scripts/install_system_extension_final.sh`

---

**最后更新：** 2026-05-18 18:05