从源头构建勤勉Agent

本页面描述从源代码构建Digilent Agent的过程。

注意:这个过程只推荐高级用户使用，大多数用户应该安装一个现有的版本可以在这里．

窗户

  • 安装QT Creator 5.7或更新。
  • 安装QT安装框架2.03或更新。
  • 确保QT和QT安装程序框架二进制文件在系统路径上:
    • C: \ Qt \ 5.11.1 \ mingw53_32 \ bin
    • C: \ Qt \ QtIFW-3.0.4 \ bin
  • 克隆的Digilent代理存储库。
  • 初始化和更新git子模块
    • git子模块初始化
    • git子模块更新
  • 启动QT项目“digilent-agent.pro”。
  • 新闻Ctrl + R新建或F5以调试模式构建。

安装程序

  • 将调试和发布构建的输出硬链接到项目中根目录．例:
    • 新建项目-ItemType Junction -Name debug -Value .\build-digilent-agent-Desktop_Qt_5_11_1_MinGW_32bit-Debug\debug\
    • 新建项目-ItemType Junction -Name release -Value .\build-digilent-agent-Desktop_Qt_5_11_1_MinGW_32bit-Release\release\
  • 输入版本号agent.cpp．
  • 使用QT构建一个发布版本释放项目根目录下的文件夹。
  • 输入版本号安装/配置/ winConfig.xml．
  • TODO - REMOVE -设置版本号安装程序/包/ com.digilent.agent /元/ winConfig.xml．
  • 使用CygWin进入安装程序项目根目录。
  • 使用以下命令运行构建脚本
  • ．/build.sh赢得<VERSION_NUMBER><RELEASE_TYPE>


    前女友。

    ./build赢得1.0.0版本
  • 的中创建安装程序安装程序项目根目录。

Linux

  • (可选)- - -提供GUIIDE和调试)安装QT Creator 5.7或更新。
  • 更新包提要。
    sudo apt-get更新


  • 安装QT5
    Sudo apt-get安装qt5-default


  • 安装QT5串口支持
    Sudo apt-get安装libqt5serialport5-dev


  • 克隆Digilent Agent存储库
    git克隆https://github.com/Digilent/digilent-agent.git


  • 进入repo目录
    cd digilent-agent


  • 初始化和更新子模块(Digilent qtSerial和pgm)
    Git submodule init Git submodule update


  • 运行qmake
    qmake


  • 构建Digilent Agent
    使


  • 运行Digilent Agent(需要UART设备的读写权限)
    。/ digilent-agent


. deb

  • 使用qmake和如上所述的make构建版本。
    • 这一步是确认一切都是正确的设置，技术上可以省略，因为deb构建脚本将重建一切形式的源代码。
  • 在。中打开终端安装程序项目根目录。
  • 使用以下命令运行构建脚本
  • ．/构建deb<VERSION_NUMBER>


    前女友。

    /建立deb 1.0.0
  • 请按照候机室的说明操作。
  • 。deb将在安装程序项目根目录。

Mac

安装QT Creator 5.7或更新。

  • 克隆的Digilent代理存储库。
  • 初始化和更新git子模块
  • git子模块初始化
  • git子模块更新
  • 从命令行生成
    • 运行:
      qmake
    • 使
  • 或从QT Creator构建:
    • 新闻Ctrl + R新建或F5以调试模式构建。
  • 构建.dgm签署
    • 进入安装程序子目录。
      光盘安装程序
    • 运行构建脚本来打包依赖项，签署.app并构建.dmg
      ./build.sh osx  release
      • 其中是发布版本(例如1.0.1)。

或

生成一个Xcode项目:

Qmake -spec macx-xcode digital -agent.pro
  • 添加图片/图标。iconset为digilent-agent/Resources

注意:如果digilent-agent.entitlements在Xcode中是红色的，你可能需要删除文件，并使用Xcode手动创建一个Poperty列表文件名为digilent-agent。项目根目录中的权利。

建立一个新的。dmg

  • 使用QT构建Digilent Agent的发布版本。
  • 使用macdeployqt来构建一个可分发的。app。
    macdeployqt Digilent \代理。应用程序/合作设计= < ID > -always-overwrite
  • 使用磁盘实用工具创建新的磁盘镜像。
    • 命名图像digilent-agent-。dmg中的形式为#.#。# (ex 1.0.3。)
    • 将图像大小设置为刚好能容纳Agent和WaveForms Live离线支持(~20)MB)．以后不能更改大小。
    • 镜像格式设置为读写磁盘镜像。
  • 挂载并打开磁盘映像。
  • 点击认为»图标确保磁盘映像内容被视为图标。
  • 复制粘贴.app文件从QT发行版构建文件夹到挂载的磁盘映像。
  • 的快捷方式应用程序挂载的磁盘映像中的目录。
  • 复制粘贴WaveForms-Live离线支持装入挂载的磁盘映像。
  • 的快捷方式分享挂载的磁盘映像中的目录。
  • (可选)添加背景图片。
    • 将映像文件复制并粘贴到挂载的磁盘映像中。
    • 使用已挂载的磁盘映像进行活动选择视图”显示视图选项．
    • 下背景:部分点击图片
    • 将镜像从挂载的磁盘镜像拖到图片框中。
    • 使用终端隐藏图像文件(将名称改为以'.'开头)。
      cd /卷/ < DISK_IMAGE_NAME >
      mv <文件名>。<文件名>
  • 卸载磁盘映像。
  • 使用Disk Utility将磁盘映像转换为只读副本。
    • »图片转换
    • 选择磁盘镜像，单击开放．
    • 设置图像格式来只读．
    • 点击保存．
  • 分发磁盘映像的只读副本。
  • 保留磁盘映像的读写副本，以简化以后的更新。
，，