目录

QDK 快速开发指南中文版

QDK 是用于构建威联通 QTS 系统 QPKG 应用的一套开发工具. QPKG 应用不仅能让用户方便地安装和删除软件包,还能让应用开发者/维护者完全控制应用在 NAS 上的安装过程.

QDK 项目地址:

QDK 快速开发指南中文版, 基于 QDK_Quick_Start_Guide_v4_eng.pdf 结合最新版本 QDK 2.3.10 改动翻译.

什么是 QDK

  • QDK 用于在 QNAP Turbo NAS 上构建 QPKG 文件/应用
  • QDK 最初是对 QPKG SDK 的第一个正式版本的简单修改
  • 许可协议 : GPL

下载 QDK

https://download.qnap.com/QPKG/QDK/QDK_2.3.10.zip

安装 QDK

直接通过 [ App Center ] 应用中心安装:

创建 QPKG

生成开发环境

  • SSH 连接到 NAS

  • 用命令生成第一个 QPKG : qbuild --create-env MyQPKG

  • MyQPKG 命名的文件夹就创建好了

    1
    2
    3
    4
    5
    6
    
    $ cd MyQPKG/
    $ ls
    arm_64/  arm-x19/  arm-x31/
    arm-x41/  build_sign.csv  config/
    icons/  package_routines  qpkg.cfg
    shared/  x86/  x86_64/  x86_ce53xx/
    

修改配置

  • 编辑 qpkg.cfg 文件内容
    • QPKG_NAME : 应用名字
    • QPKG_VER : 应用版本
    • QPKG_AUTHOR : 应用作者

可以使用 vi 或者其他文本编辑器进行编辑

/images/hugo/qdk-quick-start-guide-zh/QQ拼音截图20200517153124.png

自定义 QPKG 安装命令

  • package_routines 内容 :
    • pkg_pre_install() : 安装前执行的命令
    • pkg_install() : 安装中执行的命令
    • pkg_post_install() : 安装后执行的命令
    • PKG_PRE_REMOVE : 卸载前执行的命令
    • PKG_MAIN_REMOVE : 卸载中执行的命令
    • PKG_POST_REMOVE : 卸载后执行的命令
  • shared/MyQPKG.sh 内容 :
    • Start : 当启动应用时执行的命令
    • Stop : 当停止应用时执行的命令
/images/hugo/qdk-quick-start-guide-zh/QQ拼音截图20200517154214.png

添加文件到 QPKG

  • 根据不同的功能分类将应用所需的文件复制到下面相应的目录 :
    • shared/ : 不同架构平台共享的文件
    • arm_64/ arm-x19/ arm-x31/ arm-x41/ x86/ x86_64/ x86_ce53xx/ : 对应架构平台私有的文件
    • icons/ : 图标文件, 需要三个 gif 文件, 分别是:
      • MyQPKG.gif : 正常图标, 大小 64 x 64 px
      • MyQPKG_80.gif : 大图标, 大小 80 x 80 px
      • MyQPKG_gray.gif : 灰色图标, 用于在应用中心停止后显示的图标, 大小 64 x 64 px
    • config/ : 自定义应用所需配置文件

生成 QPKG 文件

  • 使用下面的命令生成 QPKG 文件 :

    1
    2
    3
    4
    
    $ qbuild
    Creating archive with data files...
    Creating archive with control files...
    Creating QPKG package...
    
  • QPKG 文件生成在子目录 build 内 :

    1
    2
    3
    
    $ cd build/
    $ ls
    MyQPKG_0.1.qpkg  MyQPKG_0.1.qpkg.md5
    

关于更多详细开发内容

完整开发文档英文版