Files
markbase/MarkBaseFS/docs/PROVISIONING_PROFILE_GUIDE.md
Warren 1300a4e223
Some checks failed
Test / test (push) Has been cancelled
Test / build (push) Has been cancelled
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)
2026-06-12 12:59:54 +08:00

5.8 KiB
Raw Blame History

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. 点击 ContinueRegister

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手动安装

# 复制到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

# 在Xcode中Build
Product → Build

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

Step 7: 运行Application触发安装

# 运行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: 验证安装

# 测试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