首页
/ Winpty技术文档

Winpty技术文档

2024-12-28 19:24:31作者:管翌锬

1. 安装指南

安装环境

  • Windows XP至Windows 10,包括服务器版本
  • Cygwin或MSYS安装
  • GNU make
  • MinGW g++工具链,用于编译C++11代码以构建winpty.dllwinpty-agent.exe
  • 针对Cygwin或MSYS的g++工具链,用于构建winpty.exe

Winpty要求两个g++工具链,因为它被分为两部分。winpty.dllwinpty-agent.exe二进制文件与原生的Windows命令提示符窗口接口,因此它们是用原生MinGW工具链编译的。winpty.exe二进制文件与MSYS/Cygwin终端接口,因此它是用MSYS/Cygwin工具链编译的。

MinGW分为两个发行版——MinGW(创建32位二进制文件)和MinGW-w64(创建32位和64位二进制文件)。两者通常都是可接受的。

Cygwin软件包

Cygwin默认的g++编译器针对的是Cygwin本身,但Cygwin也打包了MinGW-w64编译器。目前必要的软件包包括:

  • mingw64-i686-gcc-g++mingw64-x86_64-gcc-g++。根据CPU架构选择合适的编译器。
  • gcc-g++
  • make

目前(截至2016年1月23日),只有MinGW-w64编译器是可接受的。MinGW编译器(例如来自mingw-gcc-g++软件包)已不再维护且存在太多错误。

MSYS软件包

对于原始的MSYS,使用mingw-get工具(MinGW安装管理器),并至少选择以下组件:

  • mingw-developer-toolkit
  • mingw32-base
  • mingw32-gcc-g++
  • msys-base
  • msys-system-builder

运行./configure时,请确保mingw32-g++在您的PATH中。它将位于C:\MinGW\bin目录。

MSYS2软件包

对于MSYS2,使用pacman并至少安装以下软件包:

  • msys/gcc
  • mingw32/mingw-w64-i686-gccmingw64/mingw-w64-x86_64-gcc。根据CPU架构选择合适的编译器。
  • make

MSYS2提供了三个开始菜单快捷方式来启动MSYS2:

  • MinGW-w64 Win32 Shell
  • MinGW-w64 Win64 Shell
  • MSYS2 Shell

要构建winpty,请使用与MSYS2架构匹配的MinGW-w64 {Win32,Win64}快捷方式。这些快捷方式将把来自{mingw32,mingw64}/mingw-w64-{i686,x86_64}-gcc软件包的g++编译器放入PATH中。

或者,不安装mingw32/mingw-w64-i686-gccmingw64/mingw-w64-x86_64-gcc,而是安装mingw-w64-cross-gccmingw-w64-cross-crt-git软件包。这些软件包将交叉编译器安装到/opt/bin,然后任何三个快捷方式都可以使用。

构建Unix适配器

在项目目录中,运行./configure,然后是make,最后是make install。默认情况下,winpty被安装到/usr/local。通过向make install传递PREFIX=<path>来覆盖此默认值。

2. 项目的使用说明

使用Unix适配器

要在mintty或Cygwin sshd中运行Windows控制台程序,请将winpty添加到命令行:

$ winpty powershell
Windows PowerShell
版权所有 (C) 2009 Microsoft Corporation。保留所有权利。

PS C:\rprichard\proj\winpty> 10 + 20
30
PS C:\rprichard\proj\winpty> exit

3. 项目API使用文档

请参考src/include/winpty.h中的函数原型,了解由winpty.dll导出的函数。

只有winpty.exe二进制文件使用Cygwin;所有其他二进制文件在不使用Cygwin的情况下工作,并且可以用MinGW或MSVC编译。要使用MSVC编译,请下载gyp并在src子目录下运行gyp -I configurations.gypi。这将生成一个winpty.sln和相关的项目文件。有关处理MSVC版本和不同架构的注释,请参阅src/winpty.gypsrc/configurations.gypi文件。

使用MSVC编译winpty目前需要MSVC 2013或更新版本。

4. 项目安装方式

请参考上述“安装指南”部分进行项目安装。确保根据您的操作系统和架构选择正确的编译器和依赖项。安装完成后,可以通过命令行使用winpty。

登录后查看全文
热门项目推荐

项目优选

收起
docsdocs
OpenHarmony documentation | OpenHarmony开发者文档
Dockerfile
152
1.97 K
kernelkernel
deepin linux kernel
C
22
6
ops-mathops-math
本项目是CANN提供的数学类基础计算算子库,实现网络在NPU上加速计算。
C++
426
34
communitycommunity
本项目是CANN开源社区的核心管理仓库,包含社区的治理章程、治理组织、通用操作指引及流程规范等基础信息
239
9
openGauss-serveropenGauss-server
openGauss kernel ~ openGauss is an open source relational database management system
C++
145
190
openHiTLSopenHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
988
394
nop-entropynop-entropy
Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台,包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分,采用java语言实现,可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用
Java
8
0
ohos_react_nativeohos_react_native
React Native鸿蒙化仓库
C++
193
274
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
936
554
金融AI编程实战金融AI编程实战
为非计算机科班出身 (例如财经类高校金融学院) 同学量身定制,新手友好,让学生以亲身实践开源开发的方式,学会使用计算机自动化自己的科研/创新工作。案例以量化投资为主线,涉及 Bash、Python、SQL、BI、AI 等全技术栈,培养面向未来的数智化人才 (如数据工程师、数据分析师、数据科学家、数据决策者、量化投资人)。
Python
75
69