Dart 튜토리얼 26편: Native interop(C/Swift/Java) - dart:ffi·ffigen·jnigen

Why#

NOTE

이미 존재하는 C 라이브러리를 재사용하거나, OS/플랫폼 API가 C 형태로 제공되는 경우가 많습니다.
이때 C 호출의 기본 루틴을 먼저 익히면, 다른 언어 interop도 구조가 비슷하게 보입니다.

What#

NOTE

dart:ffi는 Dart Native(모바일/CLI/서버)에서 C API를 호출하고 네이티브 메모리를 다루는 기능을 제공합니다.
예시로 hello_world 샘플이 소개됩니다.

How#

TIP

샘플에서는 네이티브 라이브러리를 빌드하고 Dart 앱을 실행하는 흐름이 제시됩니다.

1
$ cd hello_library
2
$ cmake .
3
...
4
$ make
5
...
6
$ cd ..
7
$ dart pub get
8
$ dart run hello.dart
9
Hello World

또한 hello.dart의 핵심 단계는 다음 순서로 설명됩니다.
DynamicLibrary.open()으로 라이브러리 로드 → lookup<NativeFunction<...>>()로 함수 찾기 → asFunction()으로 Dart 함수로 변환 → 호출.

Watch out#

WARNING

macOS에서는 실행 파일(Dart VM 포함)이 “서명된 라이브러리만 로드”할 수 있다는 주의가 제시됩니다.
즉, macOS에서 라이브러리 로드 실패가 나면 서명 문제를 먼저 의심해야 합니다.

결론: C interop는 “라이브러리 로드 → 함수 lookup → 호출” 체크리스트로 접근하면 디버깅이 쉬워집니다.

Why#

NOTE

Objective-C도 C 기반이라 dart:ffi만으로 가능하지만, 직접 바인딩을 작성하면 반복 코드가 많아집니다.
그래서 바인딩 생성기를 사용하는 흐름이 제시됩니다.

What#

NOTE

Objective-C/Swift interop는 dart:ffi와 package:ffigen을 함께 사용하며, ffigen이 헤더를 분석해 Dart 바인딩을 생성합니다.
또한 ffigen은 LLVM을 사용하므로 설치가 필요하다고 안내합니다.

How#

TIP

의존성 추가 예시는 다음과 같습니다.

1
$ dart pub add dev:ffigen objective_c ffi

그리고 generate_code.dart에서 FfiGenerator를 구성하고 .generate()를 호출하는 흐름이 제시됩니다.

1
import 'package:ffigen/ffigen.dart';
2

3
final config = FfiGenerator(
4
);
5

6
void main() => config.generate();

Watch out#

WARNING

ffigen은 경우에 따라 Objective-C 보조 코드가 담긴 .m 파일을 생성할 수 있으며, 생성되면 반드시 빌드에 포함해야 한다는 주의가 제시됩니다.
즉, “Dart 파일만 생성되겠지”라고 가정하면 런타임에서 심볼 누락 오류가 날 수 있습니다.

결론: ObjC/Swift interop는 “헤더 기준 바인딩 생성”이 핵심이므로, 생성 산출물을 빌드에 포함하는 흐름까지 같이 고정합니다.

Why#

NOTE

Android나 기존 JVM 생태계에서는 Java/Kotlin 코드 재사용이 필요할 수 있습니다.
하지만 JNI 호출은 보일러플레이트가 많습니다.

What#

NOTE

package:jni는 JNI를 통해 Java와 상호작용하게 해주고, package:jnigen은 Java API의 Dart 바인딩을 자동 생성하는 도구로 소개됩니다.
또한 이 interop 기능은 실험적(experimental)이라는 주의가 제시됩니다.

How#

TIP

의존성 추가와 설정 파일 예시는 다음과 같습니다.

1
$ dart pub add jni dev:jnigen

1
output:
2
  dart:
3
    path: lib/example.dart
4
    structure: single_file
5

6
source_path:
7
  - 'java/'
8
classes:
9
  - 'dev.dart.Example'

생성 명령과 실행에 앞선 준비 절차 예시는 다음과 같습니다.

1
$ dart run jnigen --config jnigen.yaml
2
$ dart run jni:setup
3
$ javac java/dev/dart/Example.java

Watch out#

WARNING

실험적 기능이라는 점이 명시되어 있으므로, 운영 환경 도입 전에는 “지원 플랫폼/업데이트/제약”을 확인해야 합니다.
즉, 학습/프로토타입과 운영 도입을 같은 속도로 진행하면 위험할 수 있습니다.

결론: Java/Kotlin interop는 “바인딩 생성 → JNI 준비 → 실행” 3단계로 나눠서 진행하면 막히는 지점을 줄일 수 있습니다.