Quarter OS 软件包开发帮助文档

软件包概述

在Quarter OS中，提供了第三方软件包管理器 Biscuit，它可以帮助用户轻松地安装、卸载第三方软件包。

Biscuit 软件包管理器支持的软件包类型为 .qap。

QAP，全称为 Quarter OS Application Package，是一种适用于Biscuit Package Manager for Quarter OS的软件包格式。

软件包打包封装

软件包封装器

QAP 软件包封装器位于 devtool 目录下，可以将Python程序打包为QAP软件包。

软件包封装原理

使用 zipfile 模块将所有程序文件压缩成 .zip 压缩包，并重命名为 packagename_version.qap 。

软件包结构

QAP_Package/
├── [主要文件] main.py
├── [主要文件] info.json
├── README.md
├── [其他文件]
└── ……

软件包主程序

import requests

def get_data():
    url = "https://example.com/api/data"
    response = requests.get(url)
    return response.json()

def main():
    data = get_data()
    print(data)

if __name__ == "__main__":
    main()

软件包基本信息文件

{
    "name": "your_package_name",
    "version": "1.0",
    "author": "your_name",
    "description": "The description of your package",
    "category": "tools",
    "min_python_version": "3.10",
    "target_python_version": "3.12",
    "comptb_os": "windows",
    "biscuit_version": "1.0",
    "tags": [
        "tools",
        "python"
    ],
    "depends": [
        "requests"
    ]
}

软件包名称规范

• 只能包含 小写字母，数字和下划线
• 必须以 小写字母 开头
• 示例：example, my_package, demo_package2

软件包分类

• Tools：工具类
• Games：游戏类
• Amusement：娱乐类
• Education：教育类
• Others：其他类

第三方软件包程序开发

头部注释

#!/usr/bin/env python3
# -*- coding: utf-8 -*-

"""
@Name: your_package_name
@Version: 1.0
@Author: Your_Name
@Description: The description of your package.
"""

错误处理

try:
    # 你的程序代码
except KeyboardInterrupt:
    print("Program terminated by user.")
    exit()
except Exception as e:
    print("An error occurred:", e)
    exit()

程序测试

测试版本命名规范：my_package_dev, my_package_test, my_package_beta

第三方软件包发布

当前支持本地安装：biscuit install /path/to/your_package.qap