Window-rs——用Rust编写windows原生程序

系统 Windows
微软的最近发布了Rust for Windows v0.9。更新中包括全面的调用支持,Rust可以直接原生调用任何Windows API可以极大的拓展Rust在Windows下的开发能力和范围。本文我们通过实例来学习Rust for Windows(windows-rs) 。

时下如果语言界要评选一个网红的话,无疑会是Rust。Rust凭借着自己出色的安全性和高效性被各大平台所接纳,Linux内核,安卓底层开发,Windows底层开发相继都采纳并给出了对应的借口。微软的Windows也是,最近发布了Rust for Windows v0.9。更新中包括全面的调用支持,Rust可以直接原生调用任何Windows API可以极大的拓展Rust在Windows下的开发能力和范围。本文我们通过实例来学习Rust for Windows(windows-rs) 。

概述

本次更新提供了很多新的特性和更新,根据官方的信息包括:

  • 添加了对Win32和COM API的支持,统一了Windows板条箱。这些Windows API有新的项目win32metadata来添加。为了方便和统一,项目名称由“Rust/WinRT”更改为“Rust for Windows”。
  • 添加了几个示例 ,演示了如何调用各种Windows API(包括Win32,COM和WinRT API)。
  • Windows 板条箱在crates.io发布,现在支持MIT或Apache双开源版权。
  • 内置生成的binding,无需再手动编写。
  • Windows支持在Linux上构建。
  • Win32 API的许多改进和修复,例如对数组类型,各种字符串类型和更新的元数据的支持。
  • 添加了对COM接口的更自然和惯用的支持,例如返回值,以及对涉及C样式联合和嵌套类型之类的其他API的支持。
  • 缩短了构建时间并改善了错误处理。
  • 保留原始的API大小写,这会影响使用Windows crate的现有代码。通过类似于QueryInterface的函数转换为通用函数,从而可以更安全,更方便地调用许多与COM相关的函数。

环境配置

Window板条箱使用需要首先要在Windows下配置Rust开发环境,还在Rust环境的安装也非常简单傻瓜化。

安装rustup

首先从Rust官方(rust-lang.org)下载安装包rustup-init.exe(记得下载当前Windows对应的32位或者64位版本)。

然后直接执行安装包,安装程序为自动配置好系统路径,以后就可以直接在命令行下使用了,比如cargo包管理器。

安装C++ build tools

Windows下的rust编译还依赖Microsoft C++ build tools工具,不安装,后面在编译时,会报错说“link.exe”无法找到。

需要从微软VS下载出下载vs_buildtools,选中C++工具和Windows SDK组件并安装。

安装VS Code及其Rust插件

另外,为了方便一般建议安装VS Code及其Rust插件:

crates-io国内源

配置Rust 板条箱的国内源,由于官方crates-io国内下载太慢,甚至容易失败,所以先配置国内源(比如ustc)

在用户目录C:\Users\CC\.cargo创建一个config文件,内容配置为:

示例

首先,通过cargo创建一个新的Rust项目:

  1. cargo new hello-chongchong 

以上命令这将创建一个新目录并hello-chongchong创建基本项目框架目录和文件。

进入该目录,并使用--lib 命令嵌套创建依赖的库项目:

  1. cargo new --lib bindings 

然后通过

  1. code . 

在VS Code打开该项目,截图如下:

修改项目Cargo.toml文件中,添加以下依赖项,依赖项告诉Cargo现在它依赖于新创建的win库。

  1. [dependencies] 
  2. bindings = {path = " bindings"

现在,在win文件夹下的Cargo.toml文件中,添加对Windows板条箱的依赖项,版本指定为最新的0.9.1。这样就可以通过允许Cargo打包下载,构建和缓存Windows支持。

  1. [dependencies] 
  2. windows = "0.9.1" 
  3. [build-dependencies] 
  4. windows = "0.9.1" 

然后在bindings目录下创建一个新的源文件build.rs,并输入一下源码:

  1. // build.rs 
  2. fn main() { 
  3. windows::build!( 
  4. Windows::Win32::WindowsAndMessaging::MessageBoxA 
  5. ); 

在代码中,使用 windows::build 宏指定要使用的类型,可以再次列出需要使用的所API,Windows板条箱将直接元数据生成必要的绑定。

然后修改win/src目录中为以下代码:

  1. windows::include_bindings!(); 

这样,就可以在主项目main.rs文件中,任意调用指定的Windows API。此处我们创建一个“Hello Chongchong!”消息对话框。

  1. use bindings::Windows::Win32::WindowsAndMessaging::{MessageBoxA, MESSAGEBOX_STYLE}; 
  2. fn main() { 
  3. unsafe { 
  4. MessageBoxA(None, "Hello Chongchong!", "Message", MESSAGEBOX_STYLE::MB_OK); 

注意,任何Win32函数和COM接口方法,都需要用unsafe方式调用。

然后通过cargo build编译该项目,并通过cargo run 会弹出一下对话框。

新版本的板条箱中再带了几个例子,可以在windows-rs项目仓库的examples目录。

总结

Rust for Windows 给rust在Windows开发应用带来了福音,虽然一些API可能早就被广泛地使用了,但是现在有了官方的支持,可以在文档、示例和稳定性等各方面都有极大的改善。

 

责任编辑:赵宁宁 来源: 今日头条
相关推荐

2023-09-26 19:20:09

微软开源windows

2023-06-19 14:14:24

Rust程序Web

2023-06-23 14:15:09

Rust编程

2021-06-03 07:45:25

Rust Git 终端 UI

2017-08-03 08:34:54

gRPCCRust

2021-04-29 08:00:00

Windows微软安全

2012-01-09 13:55:35

Java

2011-05-17 14:53:35

C

2009-08-14 15:06:08

Windows服务程序

2011-06-16 10:09:25

QT Windows DLL

2023-08-31 08:33:57

sudo-rs程序Unix

2022-02-07 16:40:12

RustGNU Coreut命令

2011-06-27 13:57:42

JavaScript

2023-06-12 08:00:48

Napi-rsRust 前端工具

2009-10-21 09:28:34

Windows 7程序锁

2011-11-23 09:06:00

2023-09-25 15:30:14

云原生云计算

2021-10-26 21:30:11

GitUIRustGit

2016-03-31 11:31:02

Ubuntu on W微软Windows 10

2009-11-18 09:57:06

点赞
收藏

51CTO技术栈公众号