👨‍💻 [Flutter] Flutter 에서 윈도우의 DLL을 로드해서 사용하는 방법은 어떻게 되나요?

"이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다."

---

👨‍💻 안녕하세요, 윌리 프로젝트의 윌리 입니다.

Flutter 에서 윈도우의 DLL을 로드해서 사용하는 방법은 어떻게 되는지 간략히 알아보았습니다.

---

질문 >

Flutter 에서 윈도우의 DLL을 로드해서 사용하는 방법은 어떻게 되나요?

답변 >

Flutter에서 Windows의 DLL을 로드하고 사용하는 방법은 Dart의 dart:ffi (Foreign Function Interface) 라이브러리를 활용하여 네이티브 코드를 호출하는 방식으로 이루어집니다. 다음은 자세한 단계와 코드 예제를 포함한 설명입니다.

---

1. 준비사항

• Flutter 프로젝트: Flutter 프로젝트가 생성되어 있어야 합니다.
• DLL 파일: 사용할 Windows DLL 파일이 있어야 합니다. (예: example.dll)
• 헤더 파일 또는 함수 시그니처: DLL 내에서 호출할 함수의 정의를 알아야 합니다.

---

2. DLL 로드 및 사용 절차

1) dart:ffi 의존성 추가

Flutter 프로젝트의 pubspec.yaml 파일에 ffi 패키지를 추가합니다:

dependencies:
  ffi: ^2.0.1 # 최신 버전 확인 후 업데이트

2) DLL 파일 위치 설정

DLL 파일을 Flutter 프로젝트에서 참조할 수 있도록 프로젝트 경로에 복사합니다. 예를 들어, windows/ 디렉터리 아래에 dlls 폴더를 생성하고 DLL 파일을 복사합니다:

windows/
  dlls/
    example.dll

3) Dart 파일 작성

Flutter 프로젝트에서 DLL을 로드하고 사용하는 코드를 작성합니다. 예를 들어, ffi_example.dart 파일을 작성합니다:

코드 예제

import 'dart:ffi';
import 'package:ffi/ffi.dart';

// DLL 경로를 지정
final DynamicLibrary nativeLib = DynamicLibrary.open('windows/dlls/example.dll');

// 호출할 함수의 시그니처 정의 (Dart 스타일)
typedef AddFunc = Int32 Function(Int32 a, Int32 b);
typedef AddFuncDart = int Function(int a, int b);

void main() {
  // DLL에서 함수 가져오기
  final add = nativeLib
      .lookupFunction<AddFunc, AddFuncDart>('add'); // 'add'는 DLL 내 함수 이름

  // 함수 호출
  final result = add(10, 20);
  print('Result from DLL: $result'); // 출력: Result from DLL: 30
}

---

4) Windows에서 실행

• Windows용으로 Flutter 앱을 빌드:

flutter build windows

• 앱 실행:

flutter run -d windows

---

3. 중요 고려사항

• DLL 함수 이름 확인:
  • DLL 내 함수 이름이 정확해야 합니다. 함수 이름이 매칭되지 않으면 런타임 에러가 발생합니다.
  • 이름이 난독화된 경우 dumpbin 같은 도구를 사용하여 함수 이름을 확인할 수 있습니다.
  • 예:

dumpbin /exports example.dll

• 64비트와 32비트 호환성:
  • Flutter의 Windows 앱은 기본적으로 64비트로 빌드됩니다.
  • 사용하는 DLL도 64비트로 빌드되어 있어야 합니다. (32비트 DLL은 호환되지 않음)
• DLL 함수 시그니처 매칭:
  • Dart에서 정의한 함수 시그니처가 DLL의 실제 함수 시그니처와 정확히 일치해야 합니다.
  • 예: Int32, Float, Pointer 등 데이터 타입이 중요합니다.
• Flutter와 FFI 성능:
  • FFI는 주로 네이티브 작업에서 빠르지만, 너무 빈번한 호출은 Dart의 메인 스레드에 영향을 줄 수 있습니다.

---

4. 추가 자료

• Flutter FFI 공식 문서
• Windows DLL 디버깅 도구:
  • Dependency Walker: DLL 의존성을 확인
  • dumpbin: DLL 내 함수 확인

이 방식으로 Windows DLL을 Flutter 앱에서 호출하여 사용할 수 있습니다.

---

---

🎬 유튜브 채널 🎬

위로그@WiLog

🎬 치지직 채널 🎬

위로그 채널 - CHZZK

---