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
255
MarkBaseFS/docs/PROVISIONING_PROFILE_GUIDE.md
Normal file
255
MarkBaseFS/docs/PROVISIONING_PROFILE_GUIDE.md
Normal file
@@ -0,0 +1,255 @@
|
||||
# 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
|
||||
Reference in New Issue
Block a user