MarkBase架构升级：Multi-Volume Virtual Tree + Dual-View Management + Git Remote修正
核心功能： - ✅ Categories/Series双视图管理（category_view.rs + import_markdown.rs） - ✅ FUSE Multi-Volume支持（tree_type参数） - ✅ SSH/SFTP/SCP/rsync协议完整实现（4042行） - ✅ NFS/SMB Module Phase 1-3完成 - ✅ Archive Module Phase 1-4完成（2916行） - ✅ Download Center API完整实现 - ✅ S3兼容API实现（560行） Git配置修正： - ✅ 删除错误origin（gitea.momentry.ddns.net） - ✅ 删除m5max128（指向机器名） - ✅ 设置origin = m5max128gitea.momentry.ddns.net/admin/markbase - ✅ 设置m4minigitea = m4minigitea.momentry.ddns.net/warren/markbase 数据清理： - ✅ 删除38个临时SQLite（保留accusys.sqlite、demo.sqlite） - ✅ 删除.bak、test_*.bin、调试脚本等临时文件 - ✅ 删除临时目录（build/、download files/、raid_test/等） - ✅ 更新.gitignore排除临时文件 架构优化： - 52个文件修改，2434行新增，4739行删除 - Workspace成员整合（16个crate） - 数据库状态：accusys.sqlite保留（主demo测试） 远程同步： - ✅ 准备推送到m5max128gitea（远程Gitea） - ✅ 准备推送到m4minigitea（本地Gitea）
This commit is contained in:
Warren
179
MarkBaseFS/docs/DEVELOPER_ID_PROFILE_GUIDE.md
Normal file
179
MarkBaseFS/docs/DEVELOPER_ID_PROFILE_GUIDE.md
Normal file
@@ -0,0 +1,179 @@
|
||||
# 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
|
||||
Reference in New Issue
Block a user