README_zh_CN.md

串口助手

作者：康林（[email protected])

---

🇺🇸 English

---

简介

• 项目位置:

  • 主库: https://github.com/KangLin/SerialPortAssistant
  • 镜像库:
    • 中国： https://gitee.com/kl222/SerialPortAssistant
    • https://gitlab.com/kl222/SerialPortAssistant
    • https://sourceforge.net/projects/serialportassistant/
    • https://invent.kde.org/kanglin/SerialPortAssistant
    • https://bitbucket.org/kl222/serialportassistant

• 项目主页

• 本项目是一个跨平台的串口助手。
  它能运行在:

  • WINDOWS
  • Linux
  • Android
  • mac、os
    • 本人没有mac设备，请有设备的朋友自行编译和测试
    • 当前可以成功编译，但是没有正确设置加载动态库路径。请会设置的朋友帮助设置。

  详见：Qt5 支持平台、Qt6 支持平台。

• 程序截屏

  • 多语言
    • 中文
      
    • 英语
      

• 多样式

下载

• 从以下位置下载：

  • 
  • 

• 安装说明：

  • ubuntu

    sudo apt install ./serialportassistant_0.5.24_amd64.deb
    # 如果你是老的 Linux 发行系统。你需要用下列命令替换：
    # sudo dpkg -i serialportassistant_0.5.24_amd64.deb
    # sudo apt-get install -f # Install dependencies
    

捐赠

如果你用得满意，可以对本人进行捐赠

开发

依赖

• Qt (LGPL v2.1)

• RabbitCommon: https://github.com/KangLin/RabbitCommon
  RabbitCommon 下载到与本项目同级目录中。如果不在同级目录，则需要指定环境变量： RabbitCommon_DIR

  git clone https://github.com/KangLin/RabbitCommon.git
  

编译

• 下载源码

  git clone https://github.com/KangLin/SerialPortAssistant.git
  

• 下载 RabbitCommon

  git clone https://github.com/KangLin/RabbitCommon.git
  

• 用 QtCreator 编译

  • 直接用 QtCreator 打开工程文件 CMakeLists.txt
  • 如果 RabbitCommon 不在本项目同级目录中，设置参数 RabbitCommon_DIR 指定其位置。
  • 直接编译就可以生成程序

• 用命令行编译

  • 在同一目录中下载源码与依赖

    git clone https://github.com/KangLin/RabbitCommon.git
    git clone https://github.com/KangLin/SerialPortAssistant.git
    

  • 在项目根目录下建立 build 目录

    cd SerialPortAssistant
    mkdir build
    cd build
    # cmake 配置
    cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=`pwd`/install [-DRabbitCommon_DIR=...]
    # 编译
    cmake --build . --config Release --target install
    cd install  # 程序安装在 install/bin 目录下
    

脚本

• build_debpackage.sh

  • 此脚本是 linux 下生成 deb 包的。使用前，请确保安装了下面程序

    sudo apt-get install debhelper fakeroot
    

  • 用系统自带的 QT

    sudo apt-get install \
        qt6-tools-dev qt6-tools-dev-tools qt6-base-dev qt6-base-dev-tools \
        qt6-l10n-tools qt6-translations-l10n qt6-scxml-dev \
        qt6-webengine-dev qt6-webengine-dev-tools libqt6serialport6-dev
    

    详见: ubuntu.yml

• deploy.sh: 此脚本用于产生新的发行版本号和标签。仅程序发布者使用。