JPwise-docs

Appearance

CoDesign.Linux Debian 包构建操作指南 ​

步骤一：准备工作环境 ​

1.1 使用QtCreator编译zrx文件 ​

首先在QtCreator中编译生成所需的zrx执行文件：

bash
# 打开QtCreator项目文件
 ../CoDesign.Cad.PlugIn.pro 或者 CoDesign.JP.Cad.PlugIn.pro

确保在文件夹/Out或者/Out-JP下编译生成以下文件：

  • libCoDesign.Cad.PlugIn.zrx - 主要的CAD插件文件

1.2 确认配置文件内容 ​

检查并确认以下配置文件：

CoResource程序配置文件：

bash
# 检查CoResource目录下的配置文件
ls -la GoodWayCodesignInstall/opt/apps/GoodWayCodesign/Bin/zrx/CoResource/

CoTemplate图纸信息配置文件：

bash
# 检查CoTemplate目录下的模板文件
ls -la GoodWayCodesignInstall/opt/apps/GoodWayCodesign/Bin/zrx/CoTemplate/

1.3 进入项目根目录 ​

bash
cd /home/Pai/Codesign.Deb

1.4 检查完整目录结构 ​

确认以下目录结构存在且文件完整：

text
GoodWayCodesignInstall/
├── DEBIAN/
│   ├── control          # 包元数据信息
│   └── postinst         # 安装后脚本
└── opt/apps/GoodWayCodesign/
    ├── Bin/zrx/         # 插件主体文件
    │   ├── libCoDesign.Cad.PlugIn.zrx  # 编译生成的主要插件
    │   ├── CoResource/  # 程序配置文件目录
    │   └── CoTemplate/  # 图纸信息配置文件目录
    └── etc/system/      # ZWCAD 插件注册
        └── zwcad.rx

步骤二：检查文件权限 ​

2.1 设置脚本权限 ​

bash
chmod 755 GoodWayCodesignInstall/DEBIAN/postinst

2.2 确保插件文件权限 ​

bash
chmod +x GoodWayCodesignInstall/opt/apps/GoodWayCodesign/Bin/zrx/libCoDesign.Cad.PlugIn.zrx

步骤三：验证包信息 ​

3.1 检查control文件 ​

查看包的元数据信息：

bash
cat GoodWayCodesignInstall/DEBIAN/control

3.2 确认版本号 ​

记录版本号用于后续命名（例如：1.0.0）

步骤四：构建Debian包 ​

4.1 基本构建命令 ​

bash
dpkg-deb --build GoodWayCodesignInstall

4.2 指定输出文件名（推荐） ​

bash
dpkg-deb --build GoodWayCodesignInstall GoodWayCodesignInstall_1.0.0_amd64.deb

命名规范说明：

  • 格式：{包名}_{版本号}_{架构}.deb
  • 包名：GoodWayCodesignInstall
  • 版本号：从control文件获取
  • 架构：amd64

步骤五：验证构建结果 ​

5.1 检查生成的包文件 ​

bash
ls -la *.deb

5.2 查看包信息 ​

bash
dpkg-deb --info GoodWayCodesignInstall_1.0.0_amd64.deb

5.3 查看包内容 ​

bash
dpkg-deb --contents GoodWayCodesignInstall_1.0.0_amd64.deb

步骤六：测试安装 ​

6.1 安装包 ​

bash
sudo dpkg -i GoodWayCodesignInstall_1.0.0_amd64.deb

6.2 验证安装 ​

bash
dpkg -l | grep goodwaycodesign

6.3 测试postinst脚本（可选） ​

bash
sudo bash -x GoodWayCodesignInstall/DEBIAN/postinst configure

步骤七：清理和维护 ​

7.1 卸载测试包 ​

bash
sudo apt purge goodwaycodesign

7.2 清理构建产物（如需要） ​

bash
rm -f *.deb

重要提醒 ​

  • ✅ 构建前确保所有文件权限正确
  • ✅ 版本号必须与control文件一致
  • ✅ postinst脚本会自动配置ZWCAD搜索路径
  • ✅ 建议在测试环境先验证安装过程
  • ⚠️ 构建过程需要适当的系统权限