Initial commit of package:flutter_wasm

.github/workflows/test-package.yml

@@ -82,3 +82,67 @@ jobs:
     - run: dart pub upgrade
     - run: dart run wasm:setup
     - run: dart test
+
+  flutter_analyze:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: flutter_wasm
+    steps:
+    - uses: actions/checkout@v2
+    - uses: actions/setup-java@v1
+      with:
+        java-version: '12.x'
+    - uses: subosito/[email protected]
+      with:
+        flutter-version: '2.5.0'
+    - id: install
+      run: |
+        flutter pub upgrade
+        flutter pub upgrade --directory example
+    - run: flutter format --output=none --set-exit-if-changed .
+      if: always() && steps.install.outcome == 'success'
+    - run: flutter analyze --fatal-infos
+      if: always() && steps.install.outcome == 'success'
+
+  flutter_test:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: flutter_wasm
+    steps:
+    - uses: actions/checkout@v2
+    - uses: actions/setup-java@v1
+      with:
+        java-version: '12.x'
+    - uses: subosito/[email protected]
+      with:
+        flutter-version: '2.5.0'
+    - run: flutter pub upgrade
+    - run: flutter pub run wasm:setup
+    - run: flutter test
+
+  flutter_example_test:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: flutter_wasm/example
+    steps:
+    - uses: actions/checkout@v2
+    - uses: actions/setup-java@v1
+      with:
+        java-version: '12.x'
+    - uses: android-actions/[email protected]
+    - uses: nttld/setup-ndk@v1
+      with:
+        ndk-version: r21e
+        add-to-path: true
+    - run: echo "ndk.dir=$(dirname $(which ndk-build))" >> android/local.properties
+    - uses: subosito/[email protected]
+      with:
+        flutter-version: '2.5.0'
+    - run: flutter pub upgrade
+    - run: flutter pub run wasm:setup
+    - run: flutter test
+    - run: flutter build apk
+    - run: flutter build appbundle

README.md

@@ -4,6 +4,6 @@ These packages provide utilities for loading and running WASM modules.
 
 Runs WASM modules in Dart native.
 
-## flutter_wasm (coming soon)
+## [flutter_wasm](https://github.com/dart-lang/wasm/blob/main/flutter_wasm/README.md)
 
 Runs WASM modules in Flutter.

flutter_wasm/.gitignore

@@ -0,0 +1,29 @@
+# Miscellaneous
+*.class
+*.log
+*.pyc
+*.swp
+.DS_Store
+.atom/
+.buildlog/
+.history
+.svn/
+
+# IntelliJ related
+*.iml
+*.ipr
+*.iws
+.idea/
+
+# The .vscode folder contains launch configuration and tasks you configure in
+# VS Code which you may wish to be included in version control, so this line
+# is commented out by default.
+#.vscode/
+
+# Flutter/Dart/Pub related
+# Libraries should not include pubspec.lock, per https://dart.dev/guides/libraries/private-files#pubspeclock.
+/pubspec.lock
+**/doc/api/
+.dart_tool/
+.packages
+build/

flutter_wasm/.metadata

@@ -0,0 +1,10 @@
+# This file tracks properties of this Flutter project.
+# Used by Flutter tool to assess capabilities and perform upgrades etc.
+#
+# This file should be version controlled and should not be manually edited.
+
+version:
+  revision: d5396898bed65dacfb355fb6e52ec7ccf76746d9
+  channel: unknown
+
+project_type: plugin

flutter_wasm/CHANGELOG.md

@@ -0,0 +1,3 @@
+## 0.0.1
+
+- Initial version

flutter_wasm/README.md

@@ -0,0 +1,22 @@
+Provides utilities for loading and running WASM modules in Flutter apps.
+Currently only Android is supported.
+
+This is a wrapper around [package:wasm](https://github.com/dart-lang/wasm/blob/main/wasm/README.md).
+See that package for more information and documentation. The basic
+usage is mostly the same as in that package. The main thing this plugin does is
+run `wasm:setup` for your target device during app compilation.
+
+## Usage
+
+1. Add a dependency to *both* package `wasm` and `flutter_wasm` in
+`pubspec.yaml` and run `flutter pub get`. [#52](https://github.com/dart-lang/wasm/issues/52)
+
+1. Next run `flutter run wasm:setup` to build the Wasmer runtime for your host
+machine. This does not build the runtime for your target device. It will take a
+few minutes.
+
+1. Load your wasm code in your app. See the [example app](https://github.com/dart-lang/wasm/blob/main/flutter_wasm/example/lib/main.dart).
+
+1. Run your app using `flutter run`. If you see an error at runtime saying
+"libwasmer.so not found", just try rebuiling. The first build sometimes fails.
+[#51](https://github.com/dart-lang/wasm/issues/51)

flutter_wasm/android/.gitignore

@@ -0,0 +1,8 @@
+*.iml
+.gradle
+/local.properties
+/.idea/workspace.xml
+/.idea/libraries
+.DS_Store
+/build
+/captures

flutter_wasm/android/build.gradle

@@ -0,0 +1,128 @@
+// Copyright (c) 2021, the Dart project authors.  Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+group 'dev.dart.flutter_wasm'
+version '1.0-SNAPSHOT'
+
+import org.gradle.nativeplatform.platform.internal.DefaultNativePlatform
+
+buildscript {
+    ext.kotlin_version = '1.3.50'
+    repositories {
+        google()
+        mavenCentral()
+    }
+
+    dependencies {
+        classpath 'com.android.tools.build:gradle:4.1.0'
+        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
+    }
+}
+
+rootProject.allprojects {
+    repositories {
+        google()
+        mavenCentral()
+    }
+}
+
+apply plugin: 'com.android.library'
+apply plugin: 'kotlin-android'
+
+android {
+    compileSdkVersion 30
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_8
+        targetCompatibility JavaVersion.VERSION_1_8
+    }
+
+    kotlinOptions {
+        jvmTarget = '1.8'
+    }
+
+    sourceSets {
+        main.java.srcDirs += 'src/main/kotlin'
+    }
+
+    defaultConfig {
+        minSdkVersion 16
+    }
+
+    def hostOs = DefaultNativePlatform.currentOperatingSystem.getName().toLowerCase()
+    def hostArch = DefaultNativePlatform.currentArchitecture.getName().replaceAll('-', '_')
+    def ndkBinDir = "${android.ndkDirectory}/toolchains/llvm/prebuilt/${hostOs}-${hostArch}/bin"
+    def projectProperties = new Properties()
+    projectProperties.load(project.rootProject.file('local.properties').newDataInputStream())
+    def flutterDir = projectProperties.getProperty('flutter.sdk')
+    def platformVersion = -1
+    fileTree("${android.ndkDirectory}/platforms").visit { FileVisitDetails details ->
+        if (details.isDirectory() && details.name.startsWith("android-")) {
+            platformVersion = Math.max(platformVersion, details.name.substring(8) as int)
+        }
+    }
+    if (platformVersion < 0) {
+        throw new Exception("Can't find any valid platforms in ${android.ndkDirectory}/platforms")
+    }
+
+    tasks.register('wasm-pub-get') {
+        doLast {
+            exec {
+                workingDir '..'
+                commandLine "${flutterDir}/bin/flutter", 'pub', 'get'
+            }
+        }
+    }
+
+    def architectures = [
+            ['arm64-v8a', 'aarch64-linux-android', 'aarch64-linux-android', 'aarch64-linux-android', 'arch-arm64'],
+            ['x86', 'i686-linux-android', 'i686-linux-android', 'i686-linux-android', 'arch-x86'],
+
+            // TODO(#53,#54): Enable these when they're supported by Wasmer.
+            // ['armeabi-v7a', 'armv7a-linux-androideabi', 'arm-linux-androideabi', 'armv7-linux-androideabi', 'arch-arm'],
+            // ['x86_64', 'x86_64-linux-android', 'x86_64-linux-android', 'x86_64-linux-android', 'arch-x86_64'],
+    ]
+    for (arch in architectures) {
+        def abi = arch[0]
+        def clangPrefix = "${arch[1]}${platformVersion}"
+        def arPrefix = arch[2]
+        def rustTriple = arch[3]
+        def sysroot = arch[4]
+        def sysrootDir = "${android.ndkDirectory}/platforms/android-${platformVersion}/${sysroot}"
+        def outDir = "${rootDir}/../build/app/intermediates/stripped_native_libs/debug/out/lib/${abi}/"
+
+        tasks.register("wasm-lib-${abi}") {
+            // Specify inputs and outputs so that incremental build works properly.
+            inputs.property('platformVersion', platformVersion)
+            inputs.property('abi', abi)
+            outputs.file("${outDir}/libwasmer.so")
+
+            dependsOn('wasm-pub-get')
+
+            doLast {
+                exec {
+                    workingDir '..'
+                    commandLine "${flutterDir}/bin/flutter", 'pub', 'run', 'wasm:setup',
+                            '--sysroot', sysrootDir,
+                            '--target', rustTriple,
+                            '--clang', "${ndkBinDir}/${clangPrefix}-clang",
+                            '--clangpp', "${ndkBinDir}/${clangPrefix}-clang++",
+                            '--ar', "${ndkBinDir}/${arPrefix}-ar",
+                            '-o', outDir
+                }
+            }
+        }
+    }
+
+    tasks.withType(JavaCompile) { compileTask ->
+        for (arch in architectures) {
+            def abi = arch[0]
+            compileTask.dependsOn("wasm-lib-${abi}")
+        }
+    }
+}
+
+dependencies {
+    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
+}

flutter_wasm/android/settings.gradle

@@ -0,0 +1 @@
+rootProject.name = 'flutter_wasm'

flutter_wasm/android/src/main/AndroidManifest.xml

@@ -0,0 +1,3 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+  package="dev.dart.flutter_wasm">
+</manifest>

flutter_wasm/android/src/main/kotlin/dev/dart/flutter_wasm/FlutterWasmPlugin.kt

@@ -0,0 +1,15 @@
+// Copyright (c) 2021, the Dart project authors.  Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+package dev.dart.flutter_wasm
+
+import androidx.annotation.NonNull
+
+import io.flutter.embedding.engine.plugins.FlutterPlugin
+
+/** FlutterWasmPlugin */
+class FlutterWasmPlugin: FlutterPlugin {
+  override fun onAttachedToEngine(@NonNull flutterPluginBinding: FlutterPlugin.FlutterPluginBinding) {}
+  override fun onDetachedFromEngine(@NonNull binding: FlutterPlugin.FlutterPluginBinding) {}
+}

flutter_wasm/example/.gitignore

@@ -0,0 +1,46 @@
+# Miscellaneous
+*.class
+*.log
+*.pyc
+*.swp
+.DS_Store
+.atom/
+.buildlog/
+.history
+.svn/
+
+# IntelliJ related
+*.iml
+*.ipr
+*.iws
+.idea/
+
+# The .vscode folder contains launch configuration and tasks you configure in
+# VS Code which you may wish to be included in version control, so this line
+# is commented out by default.
+#.vscode/
+
+# Flutter/Dart/Pub related
+**/doc/api/
+**/ios/Flutter/.last_build_id
+.dart_tool/
+.flutter-plugins
+.flutter-plugins-dependencies
+.packages
+.pub-cache/
+.pub/
+/build/
+
+# Web related
+lib/generated_plugin_registrant.dart
+
+# Symbolication related
+app.*.symbols
+
+# Obfuscation related
+app.*.map.json
+
+# Android Studio will place build artifacts here
+/android/app/debug
+/android/app/profile
+/android/app/release

flutter_wasm/example/.metadata

@@ -0,0 +1,10 @@
+# This file tracks properties of this Flutter project.
+# Used by Flutter tool to assess capabilities and perform upgrades etc.
+#
+# This file should be version controlled and should not be manually edited.
+
+version:
+  revision: d5396898bed65dacfb355fb6e52ec7ccf76746d9
+  channel: unknown
+
+project_type: app

flutter_wasm/example/README.md

@@ -0,0 +1,16 @@
+# flutter_wasm_example
+
+Demonstrates how to use the flutter_wasm plugin.
+
+## Getting Started
+
+This project is a starting point for a Flutter application.
+
+A few resources to get you started if this is your first Flutter project:
+
+- [Lab: Write your first Flutter app](https://flutter.dev/docs/get-started/codelab)
+- [Cookbook: Useful Flutter samples](https://flutter.dev/docs/cookbook)
+
+For help getting started with Flutter, view our
+[online documentation](https://flutter.dev/docs), which offers tutorials,
+samples, guidance on mobile development, and a full API reference.

flutter_wasm/example/android/.gitignore

@@ -0,0 +1,13 @@
+gradle-wrapper.jar
+/.gradle
+/captures/
+/gradlew
+/gradlew.bat
+/local.properties
+GeneratedPluginRegistrant.java
+
+# Remember to never publicly share your keystore.
+# See https://flutter.dev/docs/deployment/android#reference-the-keystore-from-the-app
+key.properties
+**/*.keystore
+**/*.jks