# Developer ID Provisioning Profile申请指南

## 申请日期：2026-05-27
## 目标：解决System Extension API签名问题

---

## 问题回顾

**当前困境**：
- Application使用ad-hoc签名 → System Extension API不工作
- Application使用Developer ID签名但Provisioning Profile不匹配 → Application无法启动
- 手动签名 → 破坏Bundle完整性

**根本原因**：
- 现有Provisioning Profile（MarkbaseFS Development Profile）包含Apple Development证书
- 但系统中只有Developer ID Application证书
- 两者不匹配，导致无法正确签名

**解决方案**：
- 申请**Developer ID**类型的Provisioning Profile
- Profile将包含Developer ID Application证书
- Application可以正确签名并运行

---

## 申请步骤（详细）

### Step 1: 登录Apple Developer Portal

**URL**: https://developer.apple.com/account

**登录信息**：
- Apple ID: `warren@accusys.com.tw`
- Password: 您的Apple ID密码

---

### Step 2: 进入Provisioning Profiles页面

**位置**: Certificates, Identifiers & Profiles → Profiles

**操作**：
- 点击左侧菜单 **Profiles**
- 点击右上角 **+** 按钮（创建新Profile）

---

### Step 3: 选择正确的Profile类型（关键步骤！）

**⚠️ 重要：选择正确的类型**

**您将看到以下选项**：

#### Development（不要选择这些）
- ❌ iOS App Development
- ❌ macOS App Development
- ❌ DriverKit App Development

#### Distribution（不要选择这些）
- ❌ Ad Hoc
- ❌ App Store Connect
- ❌ Mac App Store Connect

#### **Developer ID（选择这个！）**
- ✅ **Developer ID**

**点击选择**: **Developer ID**

---

### Step 4: 配置Developer ID Profile

**配置页面内容**：

1. **选择App ID**：
   - 选择：`com.accusys.markbase` (MarkBaseFS)

2. **选择Certificate**：
   - 选择：`Developer ID Application: Accusys,Inc (K3TDMD9Y6B)`
   - ✅ 这是系统中已有的证书

3. **Profile Name**：
   - 输入：`MarkBaseFS Developer ID Profile`
   - 或其他您喜欢的名称

4. **点击Generate**

---

### Step 5: Download Profile

**操作**：
- 点击 **Download** 按钮
- Profile文件将下载到 `~/Downloads/`
- 文件名类似：`MarkBaseFS_Developer_ID_Profile.provisionprofile`

---

### Step 6: 通知我完成

**一旦下载完成，请告诉我**：
- "已完成下载"
- 或提供Profile文件位置

---

## 预期Profile内容

**Developer ID Profile包含**：
- ✅ Team ID: `K3TDMD9Y6B`
- ✅ Certificate: `Developer ID Application: Accusys,Inc (K3TDMD9Y6B)`
- ✅ App ID: `com.accusys.markbase`
- ✅ System Extension capability
- ✅ 有效期：通常1年

**与现有Profile的区别**：

| Profile类型 | 包含证书 | 状态 |
|------------|---------|------|
| **现有Profile** | Apple Development | ❌ 不匹配 |
| **新Profile** | Developer ID Application | ✅ 匹配系统中证书 |

---

## 完成后我会执行

**下载完成后，我会立即**：
1. 安装新Profile到Xcode
2. 修改project.yml使用新Profile
3. 重新编译Application
4. 验证签名正确
5. 运行Application触发System Extension API
6. 检查System Settings批准对话框
7. 用户批准后验证FSKit发现Extension

---

## 时间估算

| 步骤 | 时间 | 说明 |
|------|------|------|
| 登录 | 1分钟 | Apple Developer Portal |
| 创建Profile | 2-3分钟 | 选择类型并配置 |
| 下载 | 1分钟 | 下载.provisionprofile文件 |
| 我执行后续 | 3-5分钟 | 安装、编译、运行、验证 |
| **总计** | **7-10分钟** | 完整流程 |

---

## 关键提醒

**⚠️ 选择类型时务必注意**：
- **不要选择** "macOS App Development"
- **必须选择** "Developer ID"
- 这是最关键的区别

**如果看不到"Developer ID"选项**：
- 可能需要在左侧选择"Mac"类别
- 或滚动查看所有选项
- 或查看Distribution部分

---

## 下一步操作

**请立即开始**：
1. 登录 https://developer.apple.com/account
2. 进入 Profiles → 点击 **+**
3. **选择 Developer ID**
4. 配置并Generate
5. Download
6. 通知我完成

**我已经准备好后续所有步骤，等待您的Profile文件！**

---

**最后更新：** 2026-05-27 13:30