Sync with core 80247bb and document clipboard_watcher migration

Author: lijy91

bindings/dart/cnativeapi/CHANGELOG.md

@@ -1,7 +1,7 @@
 ## 0.5.3
 
 - macOS: add `ShortcutReleasedEvent` for system key-up delivery and accept Fn / CapsLock accelerators (hotkey_manager migration).
-- Add desktop clipboard text, HTML, images, file paths, multi-format writes and change notifications.
+- Add clipboard text, HTML, images, file paths, multi-format writes and change notifications on macOS, Windows, Linux, Android and iOS (subject to mobile focus, permission and sandbox rules).
 
 ## 0.5.2
 

bindings/dart/cnativeapi/hook/build.dart

@@ -113,6 +113,9 @@ void main(List<String> args) async {
       flags: flags,
       language: Language.cpp,
       std: 'c++17',
+      // Native assets package this one library; no Gradle CMake target supplies
+      // libc++_shared.so. Keep the NDK runtime inside our Android library.
+      cppLinkStdLib: targetOS == OS.android ? 'c++_static' : null,
     );
     await builder.run(
       input: input,

bindings/dart/nativeapi/CHANGELOG.md

@@ -1,7 +1,7 @@
 ## 0.5.3
 
 - macOS: add `ShortcutReleasedEvent` for system key-up delivery and accept Fn / CapsLock accelerators (hotkey_manager migration).
-- Add desktop clipboard text, HTML, images, file paths, multi-format writes and change notifications.
+- Add clipboard text, HTML, images, file paths, multi-format writes and change notifications on macOS, Windows, Linux, Android and iOS (subject to mobile focus, permission and sandbox rules).
 - macOS: the title bar's close button is a cancellable close request again.
   On macOS 26 it bypassed `WindowCloseRequestedEvent` and closed the window
   even when a listener cancelled.

bindings/dart/nativeapi_flutter/CHANGELOG.md

@@ -1,7 +1,9 @@
 ## 0.5.3
 
+- Automatically initialize the Android core from the Flutter engine and activity lifecycle.
+
 - macOS: add `ShortcutReleasedEvent` for system key-up delivery and accept Fn / CapsLock accelerators (hotkey_manager migration).
-- Add desktop clipboard text, HTML, images, file paths, multi-format writes and change notifications.
+- Add clipboard text, HTML, images, file paths, multi-format writes and change notifications on macOS, Windows, Linux, Android and iOS (subject to mobile focus, permission and sandbox rules).
 
 ## 0.5.2
 

bindings/dart/nativeapi_flutter/android/build.gradle

@@ -0,0 +1,40 @@
+import groovy.json.JsonSlurper
+
+group = 'dev.nativeapi.flutter'
+version = '1.0'
+
+buildscript {
+    repositories { google(); mavenCentral() }
+    dependencies { classpath 'com.android.tools.build:gradle:8.9.1' }
+}
+apply plugin: 'com.android.library'
+
+// The core's Java companion travels with cnativeapi's vendored C++ sources.
+// Resolve the package through pub's metadata, including local workspace overrides.
+def configRoot = rootProject.projectDir.parentFile
+while (configRoot != null && !new File(configRoot, '.dart_tool/package_config.json').isFile()) {
+    configRoot = configRoot.parentFile
+}
+if (configRoot == null) throw new GradleException('Run flutter pub get before building nativeapi_flutter')
+def configFile = new File(configRoot, '.dart_tool/package_config.json')
+def packageConfig = new JsonSlurper().parse(configFile)
+def rawPackage = packageConfig.packages.find { it.name == 'cnativeapi' }
+if (rawPackage == null) throw new GradleException('cnativeapi is missing from package_config.json')
+def packageRoot = new File(configFile.toURI().resolve(rawPackage.rootUri))
+def candidates = [new File(packageRoot, 'cxx_impl'), new File(packageRoot, '../../../core')]
+def coreRoot = candidates.find { new File(it, 'src/platform/android/java').isDirectory() }
+if (coreRoot == null) throw new GradleException('nativeapi Android core sources are missing')
+
+android {
+    namespace = 'dev.nativeapi.flutter'
+    compileSdk = 36
+    defaultConfig {
+        minSdk = 24
+        consumerProguardFiles 'consumer-rules.pro'
+    }
+    compileOptions {
+        sourceCompatibility = JavaVersion.VERSION_1_8
+        targetCompatibility = JavaVersion.VERSION_1_8
+    }
+    sourceSets.main.java.srcDir new File(coreRoot, 'src/platform/android/java')
+}

bindings/dart/nativeapi_flutter/android/consumer-rules.pro

@@ -0,0 +1,4 @@
+# The core locates these entry points and snapshot fields through JNI.
+-keep class dev.nativeapi.NativeApi { *; }
+-keep class dev.nativeapi.NativeApi$* { *; }
+-keep class dev.nativeapi.NativeApiClipboardProvider { *; }

bindings/dart/nativeapi_flutter/android/src/main/AndroidManifest.xml

@@ -0,0 +1,9 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <application>
+        <provider
+            android:name="dev.nativeapi.NativeApiClipboardProvider"
+            android:authorities="${applicationId}.nativeapi.clipboard"
+            android:exported="false"
+            android:grantUriPermissions="true" />
+    </application>
+</manifest>

bindings/dart/nativeapi_flutter/android/src/main/java/dev/nativeapi/flutter/NativeApiPlugin.java

@@ -0,0 +1,29 @@
+package dev.nativeapi.flutter;
+
+import dev.nativeapi.NativeApi;
+import io.flutter.embedding.engine.plugins.FlutterPlugin;
+import io.flutter.embedding.engine.plugins.activity.ActivityAware;
+import io.flutter.embedding.engine.plugins.activity.ActivityPluginBinding;
+
+/** Supplies only Android's Application/activity to the binding-independent core. */
+public final class NativeApiPlugin implements FlutterPlugin, ActivityAware {
+    private android.app.Activity activity;
+    @Override public void onAttachedToEngine(FlutterPluginBinding binding) {
+        System.loadLibrary("cnativeapi");
+        if (!NativeApi.initialize(binding.getApplicationContext())) {
+            throw new IllegalStateException("nativeapi Android initialization failed");
+        }
+    }
+    @Override public void onDetachedFromEngine(FlutterPluginBinding binding) { detach(); }
+    @Override public void onAttachedToActivity(ActivityPluginBinding binding) {
+        activity = binding.getActivity();
+        NativeApi.attachActivity(activity);
+    }
+    private void detach() {
+        if (activity != null) NativeApi.detachActivity(activity);
+        activity = null;
+    }
+    @Override public void onDetachedFromActivityForConfigChanges() { detach(); }
+    @Override public void onReattachedToActivityForConfigChanges(ActivityPluginBinding binding) { onAttachedToActivity(binding); }
+    @Override public void onDetachedFromActivity() { detach(); }
+}

bindings/dart/nativeapi_flutter/pubspec.yaml

@@ -19,3 +19,10 @@ dev_dependencies:
   flutter_test:
     sdk: flutter
   flutter_lints: ^5.0.0
+
+flutter:
+  plugin:
+    platforms:
+      android:
+        package: dev.nativeapi.flutter
+        pluginClass: NativeApiPlugin