Microsoft MVP성태의 닷넷 이야기
C/C++: 165. CLion으로 만든 Rust Win32 DLL을 C#과 연동 [링크 복사], [링크+제목 복사],
조회: 1795
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 

CLion으로 만든 Rust Win32 DLL을 C#과 연동

우선, CLion에서 rust를 사용하기 위해서는,

CLion - Rust
; https://www.jetbrains.com/help/clion/rust-support.html#install

Rustup
; https://rustup.rs/

rustup-init.exe를 다운로드해 실행부터 해줍니다. 그럼 %USERPROFILE%\.cargo\bin 디렉터리에 rust 환경이 구축되는데요, 따라서 편의상 환경변수 PATH 설정에 해당 경로를 추가하는 것을 권장합니다.

그다음 CLion의 Plugins를 통해 "Rust" 확장을 설치하면 준비는 끝입니다. 참고로, Visual Studio와 함께 C++ 구성요소를 미리 설치해 두는 것이 좋습니다. 왜냐하면 나중에 Rust 프로젝트를 처음 생성하는 시점에 시스템의 C/C++ 컴파일러를 설정하는 옵션이 뜰 텐데, 그때 Visual C++ 환경을 선택해 주면 됩니다.




문법 공부는 천천히 시간 나는 대로 아래의 사이트를 통해 하시고, ^^

The Rust Programming Language (번역본)
; https://doc.rust-kr.org/

곧바로 실습을 위해 CLion으로 다음과 같이 Rust Library 프로젝트를 생성하면,

rust_dll_prj_1.png

기본적으로 ./src/lib.rs 파일이 생성되고 아래의 내용을 갖습니다.

pub fn add(left: usize, right: usize) -> usize {
    left + right
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn it_works() {
        let result = add(2, 2);
        assert_eq!(result, 4);
    }
}

(CLion을 통해 생성한 프로젝트 구조는 명령행에서 "cargo new testapp2 --lib"를 실행한 것과 같습니다.)

CLion은 라이브러리 프로젝트에 대해 빌드 Configuration 설정을 "Test" 유형으로만 생성하기 때문에 이 상태에서는 "Build" 메뉴를 선택해도 rlib 파일을 생성하지 않습니다.

따라서 CLion의 "Terminal" 화면에서 "cargo build"를 입력해 빌드해야 하는데요,

PS F:\rust_prj\testapp2> cargo build
   Compiling testapp2 v0.1.0 (F:\rust_prj\testapp2)
    Finished dev [unoptimized + debuginfo] target(s) in 0.27s      

그럼, ./target/debug 디렉터리에 "libtestapp2.rlib" 파일이 생성됩니다.




일단, 위와 같이 생성한 rlib 파일은 러스트 전용 라이브러리로써 Win32 DLL과는 다릅니다. 따라서 (C# 등에서 이용하려면) 출력을 Win32 DLL로 바꿔야 하는데요, 이를 위해 프로젝트에 추가된 Cargo.toml 파일에 crate-type 값을 다음과 같이 설정해 줍니다.

[package]
name = "testapp2"
version = "0.1.0"
edition = "2021"

# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html

[lib]
crate-type = ["cdylib"]

[dependencies]

이후, CLion의 "Edit Configurations"를 이용해 DLL로 빌드하는 모드를 하나 더 추가한 다음,

rust_dll_prj_2.png

다시 빌드하면 이제 ./target/debug 디렉터리에 testapp2.dll 파일이 생성됩니다.




여기까지 하면, 비록 DLL은 생성되지만 add 함수가 외부로 노출된 상태는 아닙니다. Visual C++에서처럼 dllexport와 같은 처리를 해야 하는데요, 이를 위해 rust에서는 #[no_mangle]과 함께 extern 예약어를 적용해야 합니다.

#[no_mangle]
pub extern fn add(left: usize, right: usize) -> usize {
    left + right
}

이후 다시 빌드하고, dumpbin.exe를 이용해 DLL 정보를 확인하면,

F:\rust_prj\testapp2\target\debug> dumpbin /EXPORTS testapp2.dll
...[생략]...

    00000000 characteristics
    FFFFFFFF time date stamp
        0.00 version
           1 ordinal base
           1 number of functions
           1 number of names

    ordinal hint RVA      name

          1    0 00001000 add = add

...[생략]...


F:\rust_prj\testapp2\target\debug> dumpbin /HEADERS testapp2.dll
...[생략]...

FILE HEADER VALUES
            8664 machine (x64)
               5 number of sections
        660B6574 time date stamp Tue Apr  2 10:55:00 2024
               0 file pointer to symbol table
               0 number of symbols
              F0 size of optional header
            2022 characteristics
                   Executable
                   Application can handle large (>2GB) addresses
                   DLL

OPTIONAL HEADER VALUES
             20B magic # (PE32+)
...[생략]...

일반적인 64bit PE32+ 포맷으로 add 함수를 export 시킨 것을 확인할 수 있습니다.




Rust 컴파일러가 출력한 결과물이 64비트 DLL이니까, calling convention 고민은 하지 않아도 됩니다.

자, 그럼 C#에서 Rust DLL을 연결해 호출해 볼까요? ^^ 간단하게 Console 프로젝트를 하나 만들고, 이렇게 DllImport로 연결하면,

using System.Runtime.InteropServices;

namespace ConsoleApp1;

internal class Program
{
    [DllImport("testapp2.dll")]
    static extern uint add(uint left, uint right);

    static void Main(string[] args)
    {
        Console.WriteLine($"Hello, Rust!: {add(5, 6)}");
    }
}

빌드 후 정상적으로 add 함수가 불리는 것을 확인할 수 있습니다. Rust 문법만 공부하면 심심할 테니, 이렇게 C#과 연동해 보면 좀 더 재미가 있을 것입니다. ^^

참고로, 관련해서 아래의 문서도 좀 보시고. ^^

Creating A DLL With Rust
; https://samrambles.com/guides/window-hacking-with-rust/creating-a-dll-with-rust/index.html

rust-analyzer.vs
; https://marketplace.visualstudio.com/items?itemName=kitamstudios.RustAnalyzer




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]







[최초 등록일: ]
[최종 수정일: 4/15/2024]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 



2024-05-04 05시37분
정성태

... 46  47  48  [49]  50  51  52  53  54  55  56  57  58  59  60  ...
NoWriterDateCnt.TitleFile(s)
12420정성태11/19/20207960오류 유형: 684. Visual C++ - MSIL .netmodule or module compiled with /GL found; restarting link with /LTCG; add /LTCG to the link command line to improve linker performance
12419정성태11/19/20209231VC++: 139. Visual C++ - .NET Core의 nethost.lib와 정적 링크파일 다운로드1
12418정성태11/19/202011258오류 유형: 683. Visual C++ - error LNK2038: mismatch detected for 'RuntimeLibrary': value 'MT_StaticRelease' doesn't match value 'MDd_DynamicDebug'파일 다운로드1
12417정성태11/19/20208665오류 유형: 682. Visual C++ - warning LNK4099: PDB '...pdb' was not found with '...lib(pch.obj)' or at '...pdb'; linking object as if no debug info
12416정성태11/19/20209943오류 유형: 681. Visual C++ - error LNK2001: unresolved external symbol _CrtDbgReport
12415정성태11/18/202010059.NET Framework: 971. UnmanagedCallersOnly 특성과 DNNE 사용파일 다운로드1
12414정성태11/18/202011095VC++: 138. x64 빌드에서 extern "C"가 아닌 경우 ___cdecl name mangling 적용 [4]파일 다운로드1
12413정성태11/17/202010780.NET Framework: 970. .NET 5 / .NET Core - UnmanagedCallersOnly 특성을 사용한 함수 내보내기파일 다운로드1
12412정성태11/16/202013022.NET Framework: 969. .NET Framework 및 .NET 5 - UnmanagedCallersOnly 특성 사용파일 다운로드1
12411정성태11/12/202010007오류 유형: 680. C# 9.0 - Error CS8889 The target runtime doesn't support extensible or runtime-environment default calling conventions.
12410정성태11/12/20209915디버깅 기술: 174. windbg - System.TypeLoadException 예외 분석 사례
12409정성태11/12/202011292.NET Framework: 968. C# 9.0의 Function pointer를 이용한 함수 주소 구하는 방법파일 다운로드1
12408정성태11/9/202022824도서: 시작하세요! C# 9.0 프로그래밍 [8]
12407정성태11/9/202011583.NET Framework: 967. "clr!JIT_DbgIsJustMyCode" 호출이 뭘까요?
12406정성태11/8/202013172.NET Framework: 966. C# 9.0 - (15) 최상위 문(Top-level statements) [5]파일 다운로드1
12405정성태11/8/202010591.NET Framework: 965. C# 9.0 - (14) 부분 메서드에 대한 새로운 기능(New features for partial methods)파일 다운로드1
12404정성태11/7/202011136.NET Framework: 964. C# 9.0 - (13) 모듈 이니셜라이저(Module initializers)파일 다운로드1
12403정성태11/7/202011174.NET Framework: 963. C# 9.0 - (12) foreach 루프에 대한 GetEnumerator 확장 메서드 지원(Extension GetEnumerator)파일 다운로드1
12402정성태11/7/202011775.NET Framework: 962. C# 9.0 - (11) 공변 반환 형식(Covariant return types) [1]파일 다운로드1
12401정성태11/5/202010695VS.NET IDE: 153. 닷넷 응용 프로그램에서의 "My Code" 범위와 "Enable Just My Code"의 역할 [1]
12400정성태11/5/20207663오류 유형: 679. Visual Studio - "Source Not Found" 창에 "Decompile source code" 링크가 없는 경우
12399정성태11/5/202011394.NET Framework: 961. C# 9.0 - (10) 대상으로 형식화된 조건식(Target-typed conditional expressions)파일 다운로드1
12398정성태11/4/20209908오류 유형: 678. Windows Server 2008 R2 환경에서 Powershell을 psexec로 원격 실행할 때 hang이 발생하는 문제
12397정성태11/4/202010071.NET Framework: 960. C# - 조건 연산자(?:)를 사용하는 경우 달라지는 메서드 선택 사례파일 다운로드1
12396정성태11/3/20208383VS.NET IDE: 152. Visual Studio - "Tools" / "External Tools..."에 등록된 외부 명령어에 대한 단축키 설정 방법
12395정성태11/3/20209693오류 유형: 677. SSMS로 DB 접근 시 The server principal "..." is not able to access the database "..." under the current security context.
... 46  47  48  [49]  50  51  52  53  54  55  56  57  58  59  60  ...