FnDepot 第三方应用源规范文档

用户8360

2月25日修改

版本: 1.1.1

更新日期: 2026-02-25

更新内容:

•
新增多架构（Multi-Arch）原生支持。​

•
扩展 fnpack.json 字段支持按架构定义版本、大小、描述及下载地址。​

•
优化 FPK 安装包命名规则，支持架构自动识别。​

•
保持对旧版单架构配置的完全向下兼容。​

1.
概述 (Overview)​

FnDepot 是运行于 FNOS 上的去中心化第三方应用管理器。本文档定义了 FnDepot 应用源的构建规范、目录结构及元数据标准。开发者需严格遵循本规范，以确保应用源能被 FnDepot 客户端正确解析、索引。​

2.
仓库规范 (Repository Standards)​

为了保证解析效率与编写方便，项目在制作时尽可能采用了飞牛官方开发文档的键名，方便开发者识别和同步，应用源仓库必须满足以下硬性条件：​

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 数据结构

{

FnDepot 第三方应用源规范文档​