feat(plugins): typed invoke arguments for mobile plugins (#8076)

Author: lucasfernog

.changes/android-plugin-get-config-typed.md

@@ -0,0 +1,5 @@
+---
+"tauri": patch:breaking
+---
+
+The Android `PluginManager.loadConfig` now takes a third parameter to define the class type of the config object.

.changes/mobile-plugin-resolve-object.md

@@ -0,0 +1,5 @@
+---
+"tauri": patch:enhance
+---
+
+Mobile plugins can now resolve using an arbitrary object instead of using the `JSObject` class via `Invoke.resolve` on iOS and `Invoke.resolveObject` on Android.

.changes/mobile-plugin-typed-invoke-args.md

@@ -0,0 +1,5 @@
+---
+"tauri": patch:breaking
+---
+
+Mobile plugins now have access to a parser for the invoke arguments instead of relying on the `Invoke#get${TYPE}` methods.

.changes/update-mobile-template.md

@@ -0,0 +1,6 @@
+---
+"tauri-cli": patch:breaking
+"@tauri-apps/cli": patch:breaking
+---
+
+Updated the mobile plugin templates following the tauri v2.0.0-alpha.17 changes.

core/tauri/Cargo.toml

@@ -42,7 +42,7 @@ development = [ "quickcheck_macros" ]
 
 [dependencies]
 serde_json = { version = "1.0", features = [ "raw_value" ] }
-serde = { version = "1.0", features = [ "derive" ] }
+serde = { version = "1.0", features = [ "derive", "rc" ] }
 tokio = { version = "1", features = [ "rt", "rt-multi-thread", "sync", "fs", "io-util" ] }
 futures-util = "0.3"
 uuid = { version = "1", features = [ "v4" ], optional = true }

core/tauri/mobile/android/build.gradle.kts

@@ -38,6 +38,7 @@ dependencies {
     implementation("androidx.core:core-ktx:1.7.0")
     implementation("androidx.appcompat:appcompat:1.6.0")
     implementation("com.google.android.material:material:1.7.0")
+    implementation("com.fasterxml.jackson.core:jackson-databind:2.15.3")
     testImplementation("junit:junit:4.13.2")
     androidTestImplementation("androidx.test.ext:junit:1.1.5")
     androidTestImplementation("androidx.test.espresso:espresso-core:3.5.1")

core/tauri/mobile/android/proguard-rules.pro

@@ -23,3 +23,7 @@
   @app.tauri.annotation.Permission <methods>;
   public <init>(...);
 }
+
+-keep @app.tauri.annotation.InvokeArg public class * {
+  *;
+}

core/tauri/mobile/android/src/main/java/app/tauri/PermissionHelper.kt

@@ -95,21 +95,19 @@ object PermissionHelper {
    * @param neededPermissions The permissions needed.
    * @return The permissions not present in AndroidManifest.xml
    */
-  fun getUndefinedPermissions(context: Context, neededPermissions: Array<String>): Array<String?> {
-    val undefinedPermissions = ArrayList<String?>()
+  fun getUndefinedPermissions(context: Context, neededPermissions: Array<String>): Array<String> {
+    val undefinedPermissions = ArrayList<String>()
     val requestedPermissions = getManifestPermissions(context)
-    if (requestedPermissions != null && requestedPermissions.isNotEmpty()) {
+    if (!requestedPermissions.isNullOrEmpty()) {
       val requestedPermissionsList = listOf(*requestedPermissions)
       val requestedPermissionsArrayList = ArrayList(requestedPermissionsList)
       for (permission in neededPermissions) {
         if (!requestedPermissionsArrayList.contains(permission)) {
           undefinedPermissions.add(permission)
         }
       }
-      var undefinedPermissionArray = arrayOfNulls<String>(undefinedPermissions.size)
-      undefinedPermissionArray = undefinedPermissions.toArray(undefinedPermissionArray)
-      return undefinedPermissionArray
+      return undefinedPermissions.toTypedArray()
     }
-    return neededPermissions as Array<String?>
+    return neededPermissions
   }
 }

core/tauri/mobile/android/src/main/java/app/tauri/annotation/InvokeArg.kt

@@ -0,0 +1,9 @@
+// Copyright 2019-2023 Tauri Programme within The Commons Conservancy
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-License-Identifier: MIT
+
+package app.tauri.annotation
+
+@Retention(AnnotationRetention.RUNTIME)
+@Target(AnnotationTarget.CLASS)
+annotation class InvokeArg

core/tauri/mobile/android/src/main/java/app/tauri/plugin/Channel.kt

@@ -4,8 +4,30 @@
 
 package app.tauri.plugin
 
-class Channel(val id: Long, private val handler: (data: JSObject) -> Unit) {
+import com.fasterxml.jackson.core.JsonParser
+import com.fasterxml.jackson.databind.DeserializationContext
+import com.fasterxml.jackson.databind.JsonDeserializer
+import com.fasterxml.jackson.databind.ObjectMapper
+
+const val CHANNEL_PREFIX = "__CHANNEL__:"
+
+internal class ChannelDeserializer(val sendChannelData: (channelId: Long, data: String) -> Unit, private val objectMapper: ObjectMapper): JsonDeserializer<Channel>() {
+  override fun deserialize(
+    jsonParser: JsonParser?,
+    deserializationContext: DeserializationContext
+  ): Channel {
+    val channelDef = deserializationContext.readValue(jsonParser, String::class.java)
+    val callback = channelDef.substring(CHANNEL_PREFIX.length).toLongOrNull() ?: throw Error("unexpected channel value $channelDef")
+    return Channel(callback, { res -> sendChannelData(callback, res) }, objectMapper)
+  }
+}
+
+class Channel(val id: Long, private val handler: (data: String) -> Unit, private val objectMapper: ObjectMapper) {
   fun send(data: JSObject) {
-    handler(data)
+    handler(PluginResult(data).toString())
+  }
+
+  fun sendObject(data: Any) {
+    handler(objectMapper.writeValueAsString(data))
   }
 }