TER_L3_2023_Boggle_Mobile

native_ffi

Golang FFI Plugin -Projekt für Flattern

Erste Schritte

Dieses Projekt ist ein Ausgangspunkt für ein Flutter -FFI -Plugin, ein spezielles Paket, das nativen Code enthält, das direkt mit Dart FFI aufgerufen wird.

Projektstruktur

Diese Vorlage verwendet die folgende Struktur:

• src : Enthält den Golang -Quellcode mit Makefile, der die native Code -Bibliothek für die verschiedenen Zielplattformen kompiliert.

• lib : Enthält den DART -Code, der die API des Plugins definiert und der mit dart:ffi in den nativen Code aufruft.

• Plattformordner ( android , ios , windows usw.): Enthält die Build -Dateien zum Erstellen und Bündeln der nativen Code -Bibliothek mit der Plattformanwendung.

Gebäude und Bündelung des nativen Code

Die pubspec.yaml gibt FFI -Plugins wie folgt an:

  plugin :
    platforms :
      some_platform :
        ffiPlugin : true

Diese Konfiguration ruft den nativen Build für die verschiedenen Zielplattformen auf und bündelt die Binärdateien in Flutteranwendungen mit diesen FFI -Plugins.

Dies kann mit DartpluginClass kombiniert werden, z. B. wenn FFI für die Implementierung einer Plattform in einem Verbund -Plugin verwendet wird:

  plugin :
    implements : some_other_plugin
    platforms :
      some_platform :
        dartPluginClass : SomeClass
        ffiPlugin : true

Ein Plugin kann sowohl FFI- als auch Methodenkanäle haben:

  plugin :
    platforms :
      some_platform :
        pluginClass : SomeName
        ffiPlugin : true

Die nativen Build -Systeme, die von FFI -Plugins (und Method Channel) aufgerufen werden, sind:

• Für Android: Gradle, der den Android NDK für native Builds anruft.
  • Siehe Dokumentation in Android/Build.gradle.
• Für iOS und macOS: Xcode über Cocoapods.
  • Siehe Dokumentation in iOS/nativ_ffi.podspec.
  • Siehe Dokumentation in macOS/nativ_ffi.podspec.
• Für Linux und Windows: CMake.
  • Siehe Dokumentation in Linux/CMakelists.txt.
  • Siehe Dokumentation in Windows/CMakelists.txt.

Bindung an nativen Code

Um den nativen Code zu verwenden, werden Bindungen in Dart benötigt. Um diese von Hand zu schreiben, werden sie aus der Header -Datei ( src/libsum.h ) mit package:ffigen generiert. Regenerieren Sie die Bindungen durch Ausführen von flutter pub run ffigen --config ffigen.yaml .

Native Code aufrufen

Sehr kurzlebige native Funktionen können direkt aus jedem Isolat aufgerufen werden. Siehe beispielsweise sum in lib/native_ffi.dart .

Flatternhilfe

Um Hilfe mit Flutter zu erhalten, sehen Sie sich unsere Online -Dokumentation an, die Tutorials, Muster, Anleitungen zur mobilen Entwicklung und eine vollständige API -Referenz anbietet.

Ter_l3_2023_Boggle_mobile