[url_launcher] Convert Linux to Pigeon

packages/url_launcher/url_launcher_linux/CHANGELOG.md

@@ -1,5 +1,6 @@
-## NEXT
+## 3.2.0
 
+* Updates platform channels to use Pigeon.
 * Updates minimum supported SDK version to Flutter 3.19/Dart 3.3.
 
 ## 3.1.1

packages/url_launcher/url_launcher_linux/lib/src/messages.g.dart

@@ -0,0 +1,94 @@
+// Copyright 2013 The Flutter Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+// Autogenerated from Pigeon (v21.1.0), do not edit directly.
+// See also: https://pub.dev/packages/pigeon
+// ignore_for_file: public_member_api_docs, non_constant_identifier_names, avoid_as, unused_import, unnecessary_parenthesis, prefer_null_aware_operators, omit_local_variable_types, unused_shown_name, unnecessary_import, no_leading_underscores_for_local_identifiers
+
+import 'dart:async';
+import 'dart:typed_data' show Float64List, Int32List, Int64List, Uint8List;
+
+import 'package:flutter/foundation.dart' show ReadBuffer, WriteBuffer;
+import 'package:flutter/services.dart';
+
+PlatformException _createConnectionError(String channelName) {
+  return PlatformException(
+    code: 'channel-error',
+    message: 'Unable to establish connection on channel: "$channelName".',
+  );
+}
+
+class _PigeonCodec extends StandardMessageCodec {
+  const _PigeonCodec();
+}
+
+class UrlLauncherApi {
+  /// Constructor for [UrlLauncherApi].  The [binaryMessenger] named argument is
+  /// available for dependency injection.  If it is left null, the default
+  /// BinaryMessenger will be used which routes to the host platform.
+  UrlLauncherApi(
+      {BinaryMessenger? binaryMessenger, String messageChannelSuffix = ''})
+      : __pigeon_binaryMessenger = binaryMessenger,
+        __pigeon_messageChannelSuffix =
+            messageChannelSuffix.isNotEmpty ? '.$messageChannelSuffix' : '';
+  final BinaryMessenger? __pigeon_binaryMessenger;
+
+  static const MessageCodec<Object?> pigeonChannelCodec = _PigeonCodec();
+
+  final String __pigeon_messageChannelSuffix;
+
+  /// Returns true if the URL can definitely be launched.
+  Future<bool> canLaunchUrl(String url) async {
+    final String __pigeon_channelName =
+        'dev.flutter.pigeon.url_launcher_linux.UrlLauncherApi.canLaunchUrl$__pigeon_messageChannelSuffix';
+    final BasicMessageChannel<Object?> __pigeon_channel =
+        BasicMessageChannel<Object?>(
+      __pigeon_channelName,
+      pigeonChannelCodec,
+      binaryMessenger: __pigeon_binaryMessenger,
+    );
+    final List<Object?>? __pigeon_replyList =
+        await __pigeon_channel.send(<Object?>[url]) as List<Object?>?;
+    if (__pigeon_replyList == null) {
+      throw _createConnectionError(__pigeon_channelName);
+    } else if (__pigeon_replyList.length > 1) {
+      throw PlatformException(
+        code: __pigeon_replyList[0]! as String,
+        message: __pigeon_replyList[1] as String?,
+        details: __pigeon_replyList[2],
+      );
+    } else if (__pigeon_replyList[0] == null) {
+      throw PlatformException(
+        code: 'null-error',
+        message: 'Host platform returned null value for non-null return value.',
+      );
+    } else {
+      return (__pigeon_replyList[0] as bool?)!;
+    }
+  }
+
+  /// Opens the URL externally, returning an error string on failure.
+  Future<String?> launchUrl(String url) async {
+    final String __pigeon_channelName =
+        'dev.flutter.pigeon.url_launcher_linux.UrlLauncherApi.launchUrl$__pigeon_messageChannelSuffix';
+    final BasicMessageChannel<Object?> __pigeon_channel =
+        BasicMessageChannel<Object?>(
+      __pigeon_channelName,
+      pigeonChannelCodec,
+      binaryMessenger: __pigeon_binaryMessenger,
+    );
+    final List<Object?>? __pigeon_replyList =
+        await __pigeon_channel.send(<Object?>[url]) as List<Object?>?;
+    if (__pigeon_replyList == null) {
+      throw _createConnectionError(__pigeon_channelName);
+    } else if (__pigeon_replyList.length > 1) {
+      throw PlatformException(
+        code: __pigeon_replyList[0]! as String,
+        message: __pigeon_replyList[1] as String?,
+        details: __pigeon_replyList[2],
+      );
+    } else {
+      return (__pigeon_replyList[0] as String?);
+    }
+  }
+}

packages/url_launcher/url_launcher_linux/lib/url_launcher_linux.dart

@@ -4,26 +4,32 @@
 
 import 'dart:async';
 
+import 'package:flutter/foundation.dart';
 import 'package:flutter/services.dart';
 import 'package:url_launcher_platform_interface/link.dart';
 import 'package:url_launcher_platform_interface/url_launcher_platform_interface.dart';
 
-const MethodChannel _channel =
-    MethodChannel('plugins.flutter.io/url_launcher_linux');
+import 'src/messages.g.dart';
 
 /// An implementation of [UrlLauncherPlatform] for Linux.
 class UrlLauncherLinux extends UrlLauncherPlatform {
+  /// Creates a new URL launcher instance.
+  UrlLauncherLinux({@visibleForTesting UrlLauncherApi? api})
+      : _hostApi = api ?? UrlLauncherApi();
+
   /// Registers this class as the default instance of [UrlLauncherPlatform].
   static void registerWith() {
     UrlLauncherPlatform.instance = UrlLauncherLinux();
   }
 
+  final UrlLauncherApi _hostApi;
+
   @override
   final LinkDelegate? linkDelegate = null;
 
   @override
   Future<bool> canLaunch(String url) async {
-    return (await _channel.invokeMethod<bool>('canLaunch', url)) ?? false;
+    return _hostApi.canLaunchUrl(url);
   }
 
   @override
@@ -44,7 +50,15 @@ class UrlLauncherLinux extends UrlLauncherPlatform {
 
   @override
   Future<bool> launchUrl(String url, LaunchOptions options) async {
-    return (await _channel.invokeMethod<bool>('launch', url)) ?? false;
+    final String? error = await _hostApi.launchUrl(url);
+    if (error != null) {
+      // TODO(stuartmorgan): Standardize errors across the entire plugin,
+      // instead of using PlatformException. This preserves the pre-Pigeon
+      // behavior of the C code returning this error response.
+      throw PlatformException(
+          code: 'Launch Error', message: 'Failed to launch URL: $error');
+    }
+    return true;
   }
 
   @override

packages/url_launcher/url_launcher_linux/linux/CMakeLists.txt

@@ -7,6 +7,7 @@ cmake_policy(VERSION 3.10...3.24)
 set(PLUGIN_NAME "${PROJECT_NAME}_plugin")
 
 list(APPEND PLUGIN_SOURCES
+  "messages.g.cc"
   "url_launcher_plugin.cc"
 )