# Apple Developer Provisioning Profile申请指南

## 申请日期：2026-05-27
## 目标：MarkBaseFS System Extension安装

---

## 准备信息

### Application信息
- **Bundle ID**: `com.accusys.markbase`
- **Team ID**: `K3TDMD9Y6B`
- **Certificate**: `Developer ID Application: Accusys,Inc (K3TDMD9Y6B)`
- **Apple ID**: `warren@accusys.com.tw`

### Extension信息
- **Bundle ID**: `com.accusys.markbase.fskitmodule`
- **Type**: System Extension (FSKit Module)
- **Status**: 已公证 (Submission ID: b3d625b3-b68e-4c96-b215-98f706872b4a)

### Required Capabilities
- `com.apple.developer.system-extension.install`
- `com.apple.developer.fskit.fsmodule` (Extension需要)

---

## 申请步骤

### Step 1: 登录Apple Developer Portal

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

1. 使用Apple ID登录: `warren@accusys.com.tw`
2. 进入 **Certificates, Identifiers & Profiles**

---

### Step 2: 创建App ID（如果不存在）

**位置**: Identifiers → App IDs

**检查是否存在**: `com.accusys.markbase`

**如果不存在，创建新的App ID：**

1. 点击 **+** 按钮
2. 选择类型：**App IDs**
3. 填写信息：
   - **Description**: `MarkBaseFS Application`
   - **Bundle ID**: `Explicit`
   - **Bundle ID**: `com.accusys.markbase`
4. **Capabilities**（必须选择）：
   - ✅ **System Extension** (关键capability)
5. 点击 **Continue** → **Register**

---

### Step 3: 创建Provisioning Profile

**位置**: Profiles → Provisioning Profiles

**创建流程：**

1. 点击 **+** 按钮
2. 选择类型：
   - **Development** (用于测试，推荐先使用)
   - 或 **Distribution** (用于生产，可选)

3. **选择App ID**: `com.accusys.markbase`

4. **选择证书**: 
   - `Developer ID Application: Accusys,Inc (K3TDMD9Y6B)`
   - 或 `Mac Development` (如果选择Development profile)

5. **选择设备**:
   - 选择您的Mac设备（UUID可在Xcode中查看）

6. **Profile Name**: 
   - `MarkBaseFS Development Profile`
   - 或 `MarkBaseFS Distribution Profile`

7. 点击 **Generate**

8. **Download** provisioning profile文件

---

### Step 4: 安装Provisioning Profile到Xcode

**方法1：双击安装**
- 双击下载的 `.provisionprofile` 文件
- Xcode自动安装

**方法2：手动安装**
```bash
# 复制到Xcode目录
cp ~/Downloads/*.provisionprofile \
   ~/Library/MobileDevice/Provisioning\ Profiles/
```

**验证安装**：
- Xcode → Preferences → Accounts
- 选择Team: `K3TDMD9Y6B`
- 查看Provisioning Profiles列表

---

### Step 5: 配置Xcode项目

**在Xcode中配置：**

1. 打开项目：`MarkBaseFS.xcodeproj`
2. 选择Target: `MarkBaseFS`
3. **Signing & Capabilities** 标签页：
   - ✅ **Automatically manage signing** (推荐)
   - Team: `K3TDMD9Y6B`
   - Provisioning Profile: 选择刚创建的profile

4. **Capabilities** 标签页：
   - 添加 **System Extension** capability
   - (Xcode会自动添加entitlements)

5. **Build Settings** 标签页：
   - Code Signing Identity: `Developer ID Application`
   - Provisioning Profile: 选择profile名称

---

### Step 6: Build Application

```bash
# 在Xcode中Build
Product → Build

# 或使用命令行
xcodebuild -project MarkBaseFS.xcodeproj \
  -target MarkBaseFS \
  -configuration Debug \
  -profile "MarkBaseFS Development Profile" \
  build
```

---

### Step 7: 运行Application触发安装

```bash
# 运行Application
"/Users/accusys/markbase/MarkBaseFS/build/Debug/MarkBaseFS.app/Contents/MacOS/MarkBaseFS"

# Application会自动触发System Extension API
# 等待用户批准对话框出现
```

---

### Step 8: 用户批准流程

**System Preferences操作：**

1. 打开 **System Preferences**
2. 进入 **Privacy & Security**
3. 找到 **System Extensions** 部分
4. 查看待批准的Extension：
   - `com.accusys.markbase.fskitmodule`
5. 点击 **Allow**

---

### Step 9: 验证安装

```bash
# 测试FSKit发现
swift /Users/accusys/markbase/MarkBaseFS/test_fskit_discovery.swift

# 检查System Extensions列表
systemextensionsctl list

# 检查Extension位置
ls -la /Library/SystemExtensions/
```

---

## 预期结果

| 检查项 | 预期结果 | 说明 |
|--------|---------|------|
| **Provisioning Profile** | ✅ 安装成功 | Xcode中可见 |
| **Application Build** | ✅ 编译成功 | 无签名错误 |
| **System Extension API** | ✅ 触发成功 | 提交安装请求 |
| **用户批准** | ⏳ 需要操作 | System Preferences |
| **FSKit发现** | ✅ Extension发现 | 安装后验证 |
| **Mount功能** | ✅ 可用 | 测试文件系统 |

---

## 常见问题

### Q1: Provisioning Profile申请失败？

**可能原因**：
- Team ID错误
- Bundle ID已存在（检查是否已创建）
- Certificate未激活

**解决方法**：
- 检查Team ID: `K3TDMD9Y6B`
- 检查Bundle ID是否已注册
- 重新生成Certificate

### Q2: Xcode无法找到Provisioning Profile？

**解决方法**：
1. 检查profile是否正确安装
2. Xcode → Preferences → Accounts → Download Manual Profiles
3. 重启Xcode

### Q3: System Extension capability不可选？

**解决方法**：
- 需要先创建App ID并启用System Extension capability
- Apple Developer Portal中配置

---

## 时间估算

| 步骤 | 预估时间 |
|------|----------|
| 登录Apple Developer | 1分钟 |
| 创建App ID | 2-3分钟 |
| 创建Provisioning Profile | 2-3分钟 |
| 安装Profile到Xcode | 1分钟 |
| Build Application | 2-3分钟 |
| 用户批准 | 1分钟 |
| **总计** | **10-15分钟** |

---

## 下一步操作

**请在Apple Developer Portal完成步骤后：**

1. 下载Provisioning Profile文件
2. 将文件路径告诉我
3. 我会立即安装并build Application
4. 运行Application触发System Extension API
5. 验证安装结果

---

**准备状态：** 所有技术准备已100%完成，等待Provisioning Profile申请。

**最后更新：** 2026-05-27 05:01