分享
FnDepot 第三方应用源规范文档
输入“/”快速插入内容
FnDepot 第三方应用源规范文档
用户8360
用户8360
2月25日修改
版本: 1.1.1
更新日期: 2026-02-25
更新内容:
•
新增多架构(Multi-Arch)原生支持。
•
扩展 fnpack.json 字段支持按架构定义版本、大小、描述及下载地址。
•
优化 FPK 安装包命名规则,支持架构自动识别。
•
保持对旧版单架构配置的完全向下兼容。
1.
概述 (Overview)
FnDepot 是运行于 FNOS 上的去中心化第三方应用管理器。本文档定义了 FnDepot 应用源的构建规范、目录结构及元数据标准。开发者需严格遵循本规范,以确保应用源能被 FnDepot 客户端正确解析、索引。
2.
仓库规范 (Repository Standards)
为了保证解析效率与编写方便,项目在制作时尽可能采用了飞牛官方开发文档的键名,方便开发者识别和同步,应用源仓库必须满足以下硬性条件:
项目
要求
说明
托管平台
GitHub
仅支持 GitHub 托管的仓库。
仓库可见性
Public
仓库必须设为公开,私有仓库无法被客户端索引。
仓库命名
FnDepot
[强制] 仓库名称必须严格命名为 FnDepot。
分支策略
main
客户端默认拉取默认分支的内容。
3.
目录结构 (Directory Structure)
FnDepot 采用扁平化的目录结构。仓库根目录必须包含全局索引文件 fnpack.json,每个应用拥有独立的子目录。
FnDepot/ # [Root] 仓库根目录
│
├── fnpack.json # [Core] 全局元数据索引文件
│
├── {app_name}/ # [Dir] 应用目录 (需与 fnpack.json 中的app_name一致)
│ ├── ICON.PNG # [Asset] 应用图标 (强制全大写)
│ ├── {app_name}_{arch}.fpk # [Bin] 多架构安装包 (推荐: 如 fntermx_arm.fpk)
│ ├── {app_name}.fpk # [Bin] 兼容模式安装包 (文件名须与目录名一致)
│ ├── README.md # [Doc] 应用详情文档 (Markdown)
│ └── Preview/ # [Asset] 预览图目录
│ ├── 01.png
│ └── 02.jpg
│
└── ... (其他应用目录)
3.1 命名约定
•
应用唯一标识 (app_name):
◦
仅允许使用小写字母 (a-z)、数字 (0-9) 和 连字符 (-)。
•
应用目录名称必须与 fnpack.json 中的键名(Key)完全一致。
•
大小写敏感:Linux 文件系统对大小写敏感,请严格遵守文件名规范。
4.
元数据规范 (fnpack.json)
fnpack.json 是应用源的核心数据库,位于仓库根目录。它是一个标准的 JSON 对象,其键(Key)为应用的 app_name。
4.1 数据结构
{