다트의 dart:ffi 라이브러리에서 C 코드와 연동하는 방법은?

Q1: `dart:ffi` 라이브러리는 무엇인가요?
`dart:ffi`는 Dart에서 C 언어로 작성된 네이티브 코드를 직접 호출할 수 있게 해주는 Foreign Function Interface 라이브러리입니다. 이를 통해 C 라이브러리의 함수, 구조체, 포인터 등을 Dart에서 사용할 수 있습니다.

---

Q2: `dart:ffi`를 사용하려면 어떤 준비가 필요한가요?
1. 연동하려는 C 코드를 공유 라이브러리(예: `.so`, `.dll`, `.dylib`) 형태로 빌드해야 합니다.
2. Dart 프로젝트에 `dart:ffi`를 import 해야 합니다 (`import 'dart:ffi';`).
3. 필요한 경우 `package:ffi/ffi.dart` 도 추가로 import 하여 메모리 할당 및 문자열 변환 도구를 활용할 수 있습니다.

---

Q3: C 함수 시그니처를 Dart에 어떻게 정의하나요?
- C 함수 시그니처에 맞춰 Dart에서 `typedef`로 함수 포인터 타입을 정의합니다.
- 예를 들어 C 함수 `int add(int a, int b);` 는
```dart
typedef CAdd = Int32 Function(Int32 a, Int32 b);
typedef DartAdd = int Function(int a, int b);
```

---

Q4: 공유 라이브러리를 어떻게 로드하나요?
- `DynamicLibrary` 클래스를 사용합니다.
- 예:
```dart
final dylib = DynamicLibrary.open('libmylib.so'); // Linux/macOS
// Windows 예시: 'mylib.dll'
```

---

Q5: C 함수 포인터를 Dart 함수로 변환하는 방법은?
- `lookupFunction` 메서드를 사용하여 C 함수 포인터를 Dart 함수로 변환합니다.
- 예:
```dart
final add = dylib.lookupFunction('add');
```

---

Q6: 문자열을 주고받을 때 주의사항은?
- C에서는 `char*`를 사용하지만 Dart 문자열은 UTF-16이므로 변환이 필요합니다.
- `package:ffi/ffi.dart`의 `toNativeUtf8()` 로 Dart 문자열을 C 문자열로 변환 가능.
- C에서 받은 문자열은 `Utf8.fromUtf8(pointer)` 또는 최신 버전에서는 `Pointer.toDartString()` 을 사용해 Dart 문자열로 변환합니다.
- C 문자열 메모리 해제는 필요시 직접 관리해야 합니다.

---

Q7: C 구조체를 Dart에서 어떻게 다루나요?
- C 구조체는 Dart에서 아래처럼 클래스로 표현합니다:
```dart
class MyStruct extends Struct {
@Int32()
external int x;

@Double()
external double y;

}
```
- `external` 키워드로 필드 선언.
- 메모리는 `calloc()` 또는 `malloc()` 로 할당.

---

Q8: 메모리 관리는 어떻게 하나요?
- `calloc` 또는 `malloc` 등 `ffi`가 제공하는 메모리 할당 함수를 사용합니다.
- 할당한 메모리는 다 쓴 뒤 반드시 `free` 해야 메모리 누수를 막을 수 있습니다.
- 자동 관리가 필요하면 `ffi` 외에 별도의 패키지나 래퍼 사용 권장.

---

Q9: 예제 - C 함수 호출 예시
```c
// C 코드 (my_library.c)
int add(int a, int b) {
return a + b;
}
```

Dart 코드:
```dart
import 'dart:ffi';
import 'package:ffi/ffi.dart';

typedef CAdd = Int32 Function(Int32, Int32);
typedef DartAdd = int Function(int, int);

void main() {
final dylib = DynamicLibrary.open('libmy_library.so');
final add = dylib.lookupFunction('add');

final result = add(3, 4);
print('3 + 4 = $result'); // 출력: 3 + 4 = 7
}
```

---

Q10: 주의할 점이나 팁이 있나요?
- 네이티브 라이브러리 이름과 경로를 정확히 지정해야 합니다.
- 플랫폼별로 라이브러리 확장자와 호출 방식이 다를 수 있으므로 조건부 코드 사용 권장.
- `dart:ffi`는 네이티브 코드 호출 시 안전하지 않은 작업이므로 예외 처리 및 오류 검증을 꼼꼼히 하세요.
- FFI 코드는 네이티브 ABI 호환성과 데이터 구조 정렬(alignments)에 주의해야 합니다.
- Android, iOS, macOS, Windows, Linux 등 플랫폼별 차이 고려 필요.

---

요약:
- C 코드를 공유 라이브러리로 빌드
- `dart:ffi` 임포트 및 `DynamicLibrary.open` 으로 라이브러리 로드
- C 함수 시그니처에 맞춰 `typedef` 생성
- `lookupFunction` 으로 Dart에서 호출 가능
- 문자열 & 구조체 & 메모리 관리에 주의

이 과정을 통해 Dart와 C 코드를 효과적으로 연동할 수 있습니다.

다트의 설치 방법은?

다트의 패키지 관리 시스템은 어떻게 작동하나요?

Dart의 `dart:ffi` 라이브러리는 Dart와 C/C++ 코드 간의 상호작용을 가능하게 해주는 기능을 제공합니다.

이를 통해 Dart 애플리케이션에서 성능이 중요한 작업을 C/C++로 구현하거나, 기존의 C/C++ 라이브러리를 재사용할 수 있습니다.

아래에서는 Dart의 `dart:ffi`를 사용하여 C 코드와 연동하는 방법에 대해 자세히 설명하겠습니다.

1. FFI(외부 함수 인터페이스)란? FFI는 Dart와 C/C++ 간의 함수 호출을 가능하게 해주는 메커니즘입니다.

이를 통해 Dart 코드에서 C/C++로 작성된 라이브러리의 함수를 호출하고, 그 결과를 사용할 수 있습니다.



2. C 코드 작성 먼저, 사용할 C 코드를 작성합니다.

예를 들어, 두 숫자를 더하는 간단한 C 함수를 작성해 보겠습니다.

```c // my_library.c include int add(int a, int b) { return a + b; } ``` 이 코드를 `my_library.c`라는 파일에 저장합니다.



3. C 코드 컴파일 C 코드를 공유 라이브러리로 컴파일해야 합니다.

운영 체제에 따라 다르게 컴파일할 수 있습니다.

- Linux/macOS : ```bash gcc -shared -o libmylibrary.so -fPIC my_library.c ``` - Windows : ```bash gcc -shared -o mylibrary.dll my_library.c ``` 이렇게 하면 `libmylibrary.so` 또는 `mylibrary.dll`이라는 공유 라이브러리가 생성됩니다.



4. Dart 코드 작성 이제 Dart 코드에서 C 함수를 호출할 수 있도록 설정합니다.

`dart:ffi`를 사용하여 C 라이브러리를 로드하고, 함수를 정의합니다.

```dart import 'dart:ffi'; import 'dart:io'; typedef AddFunc = Int32 Function(Int32 a, Int32 b); typedef Add = int Function(int a, int b); void main() { // C 라이브러리 로드 final dylib = DynamicLibrary.open( Platform.isWindows ? 'mylibrary.dll' : 'libmylibrary.so', ); // C 함수와 Dart 함수 타입 정의 final AddFunc addFunc = dylib .lookup>('add') .asFunction(); // C 함수 호출 final result = addFunc(3,

5); print('Result of adding 3 and 5: $result'); } ```

5. 코드 설명 - DynamicLibrary.open : C 라이브러리를 로드합니다.

운영 체제에 따라 적절한 라이브러리 파일을 선택합니다.

- lookup : C 라이브러리에서 특정 함수의 포인터를 가져옵니다.

`NativeFunction`을 사용하여 C 함수의 시그니처를 정의합니다.

- asFunction : C 함수 포인터를 Dart 함수로 변환합니다.

- 함수 호출 : Dart에서 C 함수를 호출하고 결과를 출력합니다.



6. 실행 Dart 코드를 실행하면 C에서 정의한 `add` 함수가 호출되고, 결과가 출력됩니다.

```bash dart run your_dart_file.dart ```

7. 주의사항 - 타입 안전성 : Dart와 C 간의 데이터 타입이 다를 수 있으므로, 타입 변환에 주의해야 합니다.

예를 들어, Dart의 `int`는 64비트이고, C의 `int`는 보통 32비트입니다.

- 메모리 관리 : Dart는 가비지 컬렉션을 사용하지만, C에서는 메모리를 수동으로 관리해야 합니다.

C에서 할당한 메모리는 Dart에서 해제할 수 없으므로, 메모리 누수에 주의해야 합니다.

- 에러 처리 : C 함수에서 발생할 수 있는 에러를 적절히 처리해야 합니다.

Dart에서는 예외 처리를 통해 이를 관리할 수 있습니다.

결론 Dart의 `dart:ffi` 라이브러리를 사용하면 C/C++로 작성된 코드를 쉽게 호출할 수 있습니다.

이를 통해 성능을 최적화하거나 기존의 C/C++ 라이브러리를 재사용할 수 있는 유용한 방법을 제공합니다.

위의 예제를 통해 기본적인 사용법을 익히고, 필요에 따라 더 복잡한 C/C++ 코드와 연동할 수 있습니다.