adding packages

2026-01-15 14:38:46 -08:00
parent ef86e3ab6a
commit 6869cf47e5
5253 changed files with 726695 additions and 34 deletions
@@ -0,0 +1,29 @@
+// 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.
+
+#if defined(FLUTTER_FRAMEWORK)
+#import "flutter/shell/platform/darwin/ios/framework/Headers/FlutterMacros.h"
+#else
+#import "FlutterMacros.h"
+#endif
+
+/**
+ * Protocol for views owned by FLEViewController to handle context changes, specifically relating to
+ * OpenGL context changes.
+ */
+FLUTTER_EXPORT
+@protocol FLEOpenGLContextHandling
+
+/**
+ * Sets the receiver as the current context object.
+ */
+- (void)makeCurrentContext;
+
+/**
+ * Called when the display is updated. In an NSOpenGLView this is best handled via a flushBuffer
+ * call.
+ */
+- (void)onPresent;
+
+@end
@@ -0,0 +1,52 @@
+// 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.
+
+#import <Foundation/Foundation.h>
+
+#if defined(FLUTTER_FRAMEWORK)
+#import "flutter/shell/platform/darwin/ios/framework/Headers/FlutterChannels.h"
+#import "flutter/shell/platform/darwin/ios/framework/Headers/FlutterCodecs.h"
+#import "flutter/shell/platform/darwin/ios/framework/Headers/FlutterMacros.h"
+#else
+#import "FlutterChannels.h"
+#import "FlutterCodecs.h"
+#import "FlutterMacros.h"
+#endif
+
+@protocol FLEPluginRegistrar;
+
+/**
+ * Implemented by the platform side of a Flutter plugin.
+ *
+ * Defines a set of optional callback methods and a method to set up the plugin
+ * and register it to be called by other application components.
+ *
+ * Currently FLEPlugin has very limited functionality, but is expected to expand over time to
+ * more closely match the functionality of FlutterPlugin.
+ */
+FLUTTER_EXPORT
+@protocol FLEPlugin <NSObject>
+
+/**
+ * Creates an instance of the plugin to register with |registrar| using the desired
+ * FLEPluginRegistrar methods.
+ */
+ (void)registerWithRegistrar:(nonnull id<FLEPluginRegistrar>)registrar;
+
+@optional
+
+/**
+ * Called when a message is sent from Flutter on a channel that a plugin instance has subscribed
+ * to via -[FLEPluginRegistrar addMethodCallDelegate:channel:].
+ *
+ * The |result| callback must be called exactly once, with one of:
+ * - FlutterMethodNotImplemented, if the method call is unknown.
+ * - A FlutterError, if the method call was understood but there was a
+ *   problem handling it.
+ * - Any other value (including nil) to indicate success. The value will
+ *   be returned to the Flutter caller, and must be serializable to JSON.
+ */
+- (void)handleMethodCall:(nonnull FlutterMethodCall*)call result:(nonnull FlutterResult)result;
+
+@end
@@ -0,0 +1,78 @@
+// 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.
+
+#import <Cocoa/Cocoa.h>
+
+#import "FLEPlugin.h"
+
+#if defined(FLUTTER_FRAMEWORK)
+#import "flutter/shell/platform/darwin/ios/framework/Headers/FlutterBinaryMessenger.h"
+#import "flutter/shell/platform/darwin/ios/framework/Headers/FlutterChannels.h"
+#import "flutter/shell/platform/darwin/ios/framework/Headers/FlutterMacros.h"
+#else
+#import "FlutterBinaryMessenger.h"
+#import "FlutterChannels.h"
+#import "FlutterMacros.h"
+#endif
+
+// TODO: Merge this file and FLEPlugin.h with FlutterPlugin.h, sharing all but
+// the platform-specific methods.
+
+/**
+ * The protocol for an object managing registration for a plugin. It provides access to application
+ * context, as as allowing registering for callbacks for handling various conditions.
+ *
+ * Currently FLEPluginRegistrar has very limited functionality, but is expected to expand over time
+ * to more closely match the functionality of FlutterPluginRegistrar.
+ */
+FLUTTER_EXPORT
+@protocol FLEPluginRegistrar <NSObject>
+
+/**
+ * The binary messenger used for creating channels to communicate with the Flutter engine.
+ */
+@property(nonnull, readonly) id<FlutterBinaryMessenger> messenger;
+
+/**
+ * The view displaying Flutter content.
+ *
+ * WARNING: If/when multiple Flutter views within the same application are supported (#98), this
+ * API will change.
+ */
+@property(nullable, readonly) NSView* view;
+
+/**
+ * Registers |delegate| to receive handleMethodCall:result: callbacks for the given |channel|.
+ */
+- (void)addMethodCallDelegate:(nonnull id<FLEPlugin>)delegate
+                      channel:(nonnull FlutterMethodChannel*)channel;
+
+@end
+
+/**
+ * A registry of Flutter macOS plugins.
+ *
+ * Plugins are identified by unique string keys, typically the name of the
+ * plugin's main class.
+ *
+ * Plugins typically need contextual information and the ability to register
+ * callbacks for various application events. To keep the API of the registry
+ * focused, these facilities are not provided directly by the registry, but by
+ * a `FlutterPluginRegistrar`, created by the registry in exchange for the unique
+ * key of the plugin.
+ *
+ * There is no implied connection between the registry and the registrar.
+ * Specifically, callbacks registered by the plugin via the registrar may be
+ * relayed directly to the underlying iOS application objects.
+ */
+@protocol FLEPluginRegistry <NSObject>
+
+/**
+ * Returns a registrar for registering a plugin.
+ *
+ * @param pluginKey The unique key identifying the plugin.
+ */
+- (nonnull id<FLEPluginRegistrar>)registrarForPlugin:(nonnull NSString*)pluginKey;
+
+@end
@@ -0,0 +1,23 @@
+// 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.
+
+#import <Cocoa/Cocoa.h>
+
+#if defined(FLUTTER_FRAMEWORK)
+#import "flutter/shell/platform/darwin/ios/framework/Headers/FlutterMacros.h"
+#else
+#import "FlutterMacros.h"
+#endif
+
+/**
+ * Protocol for listening to reshape events on this FlutterView.
+ * Used to notify the underlying Flutter engine of the new screen dimensions.
+ * Reflected from [NSOpenGLView.reshape].
+ */
+FLUTTER_EXPORT
+@protocol FLEReshapeListener
+
+- (void)viewDidReshape:(nonnull NSOpenGLView*)view;
+
+@end
@@ -0,0 +1,28 @@
+// 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.
+
+#import <Cocoa/Cocoa.h>
+
+#import "FLEOpenGLContextHandling.h"
+#import "FLEReshapeListener.h"
+
+#if defined(FLUTTER_FRAMEWORK)
+#import "flutter/shell/platform/darwin/ios/framework/Headers/FlutterMacros.h"
+#else
+#import "FlutterMacros.h"
+#endif
+
+/**
+ * View capable of acting as a rendering target and input source for the Flutter
+ * engine.
+ */
+FLUTTER_EXPORT
+@interface FLEView : NSOpenGLView <FLEOpenGLContextHandling>
+
+/**
+ * Listener for reshape events. See protocol description.
+ */
+@property(nonatomic, weak, nullable) IBOutlet id<FLEReshapeListener> reshapeListener;
+
+@end
@@ -0,0 +1,78 @@
+// 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.
+
+#import <Cocoa/Cocoa.h>
+
+#import "FLEOpenGLContextHandling.h"
+#import "FLEPluginRegistrar.h"
+#import "FLEReshapeListener.h"
+
+#if defined(FLUTTER_FRAMEWORK)
+#import "flutter/shell/platform/darwin/ios/framework/Headers/FlutterBinaryMessenger.h"
+#import "flutter/shell/platform/darwin/ios/framework/Headers/FlutterMacros.h"
+#else
+#import "FlutterBinaryMessenger.h"
+#import "FlutterMacros.h"
+#endif
+
+typedef NS_ENUM(NSInteger, FlutterMouseTrackingMode) {
+  // Hover events will never be sent to Flutter.
+  FlutterMouseTrackingModeNone = 0,
+  // Hover events will be sent to Flutter when the view is in the key window.
+  FlutterMouseTrackingModeInKeyWindow,
+  // Hover events will be sent to Flutter when the view is in the active app.
+  FlutterMouseTrackingModeInActiveApp,
+  // Hover events will be sent to Flutter regardless of window and app focus.
+  FlutterMouseTrackingModeAlways,
+};
+
+/**
+ * Controls embedder plugins and communication with the underlying Flutter engine, managing a view
+ * intended to handle key inputs and drawing protocols (see |view|).
+ *
+ * Can be launched headless (no managed view), at which point a Dart executable will be run on the
+ * Flutter engine in non-interactive mode, or with a drawable Flutter canvas.
+ */
+FLUTTER_EXPORT
+@interface FLEViewController : NSViewController <FlutterBinaryMessenger,
+                                                 FLEPluginRegistrar,
+                                                 FLEPluginRegistry,
+                                                 FLEReshapeListener>
+
+/**
+ * The view this controller manages when launched in interactive mode (headless set to false). Must
+ * be capable of handling text input events, and the OpenGL context handling protocols.
+ */
+@property(nullable) NSView<FLEOpenGLContextHandling>* view;
+
+/**
+ * The style of mouse tracking to use for the view. Defaults to
+ * FlutterMouseTrackingModeNone.
+ */
+@property(nonatomic) FlutterMouseTrackingMode mouseTrackingMode;
+
+/**
+ * Launches the Flutter engine with the provided configuration.
+ *
+ * @param assets The path to the flutter_assets folder for the Flutter application to be run.
+ * @param arguments Arguments to pass to the Flutter engine. See
+ *               https://github.com/flutter/engine/blob/master/shell/common/switches.h
+ *               for details. Not all arguments will apply to embedding mode.
+ *               Note: This API layer will likely abstract arguments in the future, instead of
+ *               providing a direct passthrough.
+ * @return YES if the engine launched successfully.
+ */
+- (BOOL)launchEngineWithAssetsPath:(nonnull NSURL*)assets
+              commandLineArguments:(nullable NSArray<NSString*>*)arguments;
+
+/**
+ * Launches the Flutter engine in headless mode with the provided configuration. In headless mode,
+ * this controller's view should not be displayed.
+ *
+ * See launcheEngineWithAssetsPath:commandLineArguments: for details.
+ */
+- (BOOL)launchHeadlessEngineWithAssetsPath:(nonnull NSURL*)assets
+                      commandLineArguments:(nullable NSArray<NSString*>*)arguments;
+
+@end
@@ -0,0 +1,83 @@
+// 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.
+
+#ifndef FLUTTER_FLUTTERBINARYMESSENGER_H_
+#define FLUTTER_FLUTTERBINARYMESSENGER_H_
+
+#import <Foundation/Foundation.h>
+
+#include "FlutterMacros.h"
+
+NS_ASSUME_NONNULL_BEGIN
+/**
+ * A message reply callback.
+ *
+ * Used for submitting a binary reply back to a Flutter message sender. Also used
+ * in for handling a binary message reply received from Flutter.
+ *
+ * @param reply The reply.
+ */
+typedef void (^FlutterBinaryReply)(NSData* _Nullable reply);
+
+/**
+ * A strategy for handling incoming binary messages from Flutter and to send
+ * asynchronous replies back to Flutter.
+ *
+ * @param message The message.
+ * @param reply A callback for submitting an asynchronous reply to the sender.
+ */
+typedef void (^FlutterBinaryMessageHandler)(NSData* _Nullable message, FlutterBinaryReply reply);
+
+/**
+ * A facility for communicating with the Flutter side using asynchronous message
+ * passing with binary messages.
+ *
+ * Implementated by:
+ * - `FlutterBasicMessageChannel`, which supports communication using structured
+ * messages.
+ * - `FlutterMethodChannel`, which supports communication using asynchronous
+ * method calls.
+ * - `FlutterEventChannel`, which supports commuication using event streams.
+ */
+FLUTTER_EXPORT
+@protocol FlutterBinaryMessenger <NSObject>
+/**
+ * Sends a binary message to the Flutter side on the specified channel, expecting
+ * no reply.
+ *
+ * @param channel The channel name.
+ * @param message The message.
+ */
+- (void)sendOnChannel:(NSString*)channel message:(NSData* _Nullable)message;
+
+/**
+ * Sends a binary message to the Flutter side on the specified channel, expecting
+ * an asynchronous reply.
+ *
+ * @param channel The channel name.
+ * @param message The message.
+ * @param callback A callback for receiving a reply.
+ */
+- (void)sendOnChannel:(NSString*)channel
+              message:(NSData* _Nullable)message
+          binaryReply:(FlutterBinaryReply _Nullable)callback
+    // TODO: Add macOS support for replies once
+    // https://github.com/flutter/flutter/issues/18852 is fixed.
+    API_UNAVAILABLE(macos);
+
+/**
+ * Registers a message handler for incoming binary messages from the Flutter side
+ * on the specified channel.
+ *
+ * Replaces any existing handler. Use a `nil` handler for unregistering the
+ * existing handler.
+ *
+ * @param channel The channel name.
+ * @param handler The message handler.
+ */
+- (void)setMessageHandlerOnChannel:(NSString*)channel
+              binaryMessageHandler:(FlutterBinaryMessageHandler _Nullable)handler;
+@end
+NS_ASSUME_NONNULL_END
+#endif  // FLUTTER_FLUTTERBINARYMESSENGER_H_
@@ -0,0 +1,378 @@
+// 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.
+
+#ifndef FLUTTER_FLUTTERCHANNELS_H_
+#define FLUTTER_FLUTTERCHANNELS_H_
+
+#include "FlutterBinaryMessenger.h"
+#include "FlutterCodecs.h"
+
+NS_ASSUME_NONNULL_BEGIN
+/**
+ * A message reply callback.
+ *
+ * Used for submitting a reply back to a Flutter message sender. Also used in
+ * the dual capacity for handling a message reply received from Flutter.
+ *
+ * @param reply The reply.
+ */
+typedef void (^FlutterReply)(id _Nullable reply);
+
+/**
+ * A strategy for handling incoming messages from Flutter and to send
+ * asynchronous replies back to Flutter.
+ *
+ * @param message The message.
+ * @param callback A callback for submitting a reply to the sender.
+ */
+typedef void (^FlutterMessageHandler)(id _Nullable message, FlutterReply callback);
+
+/**
+ * A channel for communicating with the Flutter side using basic, asynchronous
+ * message passing.
+ */
+FLUTTER_EXPORT
+@interface FlutterBasicMessageChannel : NSObject
+/**
+ * Creates a `FlutterBasicMessageChannel` with the specified name and binary
+ * messenger.
+ *
+ * The channel name logically identifies the channel; identically named channels
+ * interfere with each other's communication.
+ *
+ * The binary messenger is a facility for sending raw, binary messages to the
+ * Flutter side. This protocol is implemented by `FlutterEngine` and `FlutterViewController`.
+ *
+ * The channel uses `FlutterStandardMessageCodec` to encode and decode messages.
+ *
+ * @param name The channel name.
+ * @param messenger The binary messenger.
+ */
+ (instancetype)messageChannelWithName:(NSString*)name
+                       binaryMessenger:(NSObject<FlutterBinaryMessenger>*)messenger;
+
+/**
+ * Creates a `FlutterBasicMessageChannel` with the specified name, binary
+ * messenger, and message codec.
+ *
+ * The channel name logically identifies the channel; identically named channels
+ * interfere with each other's communication.
+ *
+ * The binary messenger is a facility for sending raw, binary messages to the
+ * Flutter side. This protocol is implemented by `FlutterEngine` and `FlutterViewController`.
+ *
+ * @param name The channel name.
+ * @param messenger The binary messenger.
+ * @param codec The message codec.
+ */
+ (instancetype)messageChannelWithName:(NSString*)name
+                       binaryMessenger:(NSObject<FlutterBinaryMessenger>*)messenger
+                                 codec:(NSObject<FlutterMessageCodec>*)codec;
+
+/**
+ * Initializes a `FlutterBasicMessageChannel` with the specified name, binary
+ * messenger, and message codec.
+ *
+ * The channel name logically identifies the channel; identically named channels
+ * interfere with each other's communication.
+ *
+ * The binary messenger is a facility for sending raw, binary messages to the
+ * Flutter side. This protocol is implemented by `FlutterEngine` and `FlutterViewController`.
+ *
+ * @param name The channel name.
+ * @param messenger The binary messenger.
+ * @param codec The message codec.
+ */
+- (instancetype)initWithName:(NSString*)name
+             binaryMessenger:(NSObject<FlutterBinaryMessenger>*)messenger
+                       codec:(NSObject<FlutterMessageCodec>*)codec;
+
+/**
+ * Sends the specified message to the Flutter side, ignoring any reply.
+ *
+ * @param message The message. Must be supported by the codec of this
+ * channel.
+ */
+- (void)sendMessage:(id _Nullable)message;
+
+/**
+ * Sends the specified message to the Flutter side, expecting an asynchronous
+ * reply.
+ *
+ * @param message The message. Must be supported by the codec of this channel.
+ * @param callback A callback to be invoked with the message reply from Flutter.
+ */
+- (void)sendMessage:(id _Nullable)message
+              reply:(FlutterReply _Nullable)callback
+    // TODO: Add macOS support for replies once
+    // https://github.com/flutter/flutter/issues/18852 is fixed.
+    API_UNAVAILABLE(macos);
+
+/**
+ * Registers a message handler with this channel.
+ *
+ * Replaces any existing handler. Use a `nil` handler for unregistering the
+ * existing handler.
+ *
+ * @param handler The message handler.
+ */
+- (void)setMessageHandler:(FlutterMessageHandler _Nullable)handler;
+@end
+
+/**
+ * A method call result callback.
+ *
+ * Used for submitting a method call result back to a Flutter caller. Also used in
+ * the dual capacity for handling a method call result received from Flutter.
+ *
+ * @param result The result.
+ */
+typedef void (^FlutterResult)(id _Nullable result);
+
+/**
+ * A strategy for handling method calls.
+ *
+ * @param call The incoming method call.
+ * @param result A callback to asynchronously submit the result of the call.
+ *     Invoke the callback with a `FlutterError` to indicate that the call failed.
+ *     Invoke the callback with `FlutterMethodNotImplemented` to indicate that the
+ *     method was unknown. Any other values, including `nil`, are interpreted as
+ *     successful results.
+ */
+typedef void (^FlutterMethodCallHandler)(FlutterMethodCall* call, FlutterResult result);
+
+/**
+ * A constant used with `FlutterMethodCallHandler` to respond to the call of an
+ * unknown method.
+ */
+FLUTTER_EXPORT
+extern NSObject const* FlutterMethodNotImplemented;
+
+/**
+ * A channel for communicating with the Flutter side using invocation of
+ * asynchronous methods.
+ */
+FLUTTER_EXPORT
+@interface FlutterMethodChannel : NSObject
+/**
+ * Creates a `FlutterMethodChannel` with the specified name and binary messenger.
+ *
+ * The channel name logically identifies the channel; identically named channels
+ * interfere with each other's communication.
+ *
+ * The binary messenger is a facility for sending raw, binary messages to the
+ * Flutter side. This protocol is implemented by `FlutterEngine` and `FlutterViewController`.
+ *
+ * The channel uses `FlutterStandardMethodCodec` to encode and decode method calls
+ * and result envelopes.
+ *
+ * @param name The channel name.
+ * @param messenger The binary messenger.
+ */
+ (instancetype)methodChannelWithName:(NSString*)name
+                      binaryMessenger:(NSObject<FlutterBinaryMessenger>*)messenger;
+
+/**
+ * Creates a `FlutterMethodChannel` with the specified name, binary messenger, and
+ * method codec.
+ *
+ * The channel name logically identifies the channel; identically named channels
+ * interfere with each other's communication.
+ *
+ * The binary messenger is a facility for sending raw, binary messages to the
+ * Flutter side. This protocol is implemented by `FlutterEngine` and `FlutterViewController`.
+ *
+ * @param name The channel name.
+ * @param messenger The binary messenger.
+ * @param codec The method codec.
+ */
+ (instancetype)methodChannelWithName:(NSString*)name
+                      binaryMessenger:(NSObject<FlutterBinaryMessenger>*)messenger
+                                codec:(NSObject<FlutterMethodCodec>*)codec;
+
+/**
+ * Initializes a `FlutterMethodChannel` with the specified name, binary messenger,
+ * and method codec.
+ *
+ * The channel name logically identifies the channel; identically named channels
+ * interfere with each other's communication.
+ *
+ * The binary messenger is a facility for sending raw, binary messages to the
+ * Flutter side. This protocol is implemented by `FlutterEngine` and `FlutterViewController`.
+ *
+ * @param name The channel name.
+ * @param messenger The binary messenger.
+ * @param codec The method codec.
+ */
+- (instancetype)initWithName:(NSString*)name
+             binaryMessenger:(NSObject<FlutterBinaryMessenger>*)messenger
+                       codec:(NSObject<FlutterMethodCodec>*)codec;
+
+// clang-format off
+/**
+ * Invokes the specified Flutter method with the specified arguments, expecting
+ * no results.
+ *
+ * @see [MethodChannel.setMethodCallHandler](https://docs.flutter.io/flutter/services/MethodChannel/setMethodCallHandler.html)
+ *
+ * @param method The name of the method to invoke.
+ * @param arguments The arguments. Must be a value supported by the codec of this
+ *     channel.
+ */
+// clang-format on
+- (void)invokeMethod:(NSString*)method arguments:(id _Nullable)arguments;
+
+/**
+ * Invokes the specified Flutter method with the specified arguments, expecting
+ * an asynchronous result.
+ *
+ * @param method The name of the method to invoke.
+ * @param arguments The arguments. Must be a value supported by the codec of this
+ *     channel.
+ * @param callback A callback that will be invoked with the asynchronous result.
+ *     The result will be a `FlutterError` instance, if the method call resulted
+ *     in an error on the Flutter side. Will be `FlutterMethodNotImplemented`, if
+ *     the method called was not implemented on the Flutter side. Any other value,
+ *     including `nil`, should be interpreted as successful results.
+ */
+- (void)invokeMethod:(NSString*)method
+           arguments:(id _Nullable)arguments
+              result:(FlutterResult _Nullable)callback
+    // TODO: Add macOS support for replies once
+    // https://github.com/flutter/flutter/issues/18852 is fixed.
+    API_UNAVAILABLE(macos);
+
+/**
+ * Registers a handler for method calls from the Flutter side.
+ *
+ * Replaces any existing handler. Use a `nil` handler for unregistering the
+ * existing handler.
+ *
+ * @param handler The method call handler.
+ */
+- (void)setMethodCallHandler:(FlutterMethodCallHandler _Nullable)handler;
+@end
+
+/**
+ * An event sink callback.
+ *
+ * @param event The event.
+ */
+typedef void (^FlutterEventSink)(id _Nullable event);
+
+/**
+ * A strategy for exposing an event stream to the Flutter side.
+ */
+FLUTTER_EXPORT
+@protocol FlutterStreamHandler
+/**
+ * Sets up an event stream and begin emitting events.
+ *
+ * Invoked when the first listener is registered with the Stream associated to
+ * this channel on the Flutter side.
+ *
+ * @param arguments Arguments for the stream.
+ * @param events A callback to asynchronously emit events. Invoke the
+ *     callback with a `FlutterError` to emit an error event. Invoke the
+ *     callback with `FlutterEndOfEventStream` to indicate that no more
+ *     events will be emitted. Any other value, including `nil` are emitted as
+ *     successful events.
+ * @return A FlutterError instance, if setup fails.
+ */
+- (FlutterError* _Nullable)onListenWithArguments:(id _Nullable)arguments
+                                       eventSink:(FlutterEventSink)events;
+
+/**
+ * Tears down an event stream.
+ *
+ * Invoked when the last listener is deregistered from the Stream associated to
+ * this channel on the Flutter side.
+ *
+ * The channel implementation may call this method with `nil` arguments
+ * to separate a pair of two consecutive set up requests. Such request pairs
+ * may occur during Flutter hot restart.
+ *
+ * @param arguments Arguments for the stream.
+ * @return A FlutterError instance, if teardown fails.
+ */
+- (FlutterError* _Nullable)onCancelWithArguments:(id _Nullable)arguments;
+@end
+
+/**
+ * A constant used with `FlutterEventChannel` to indicate end of stream.
+ */
+FLUTTER_EXPORT
+extern NSObject const* FlutterEndOfEventStream;
+
+/**
+ * A channel for communicating with the Flutter side using event streams.
+ */
+FLUTTER_EXPORT
+@interface FlutterEventChannel : NSObject
+/**
+ * Creates a `FlutterEventChannel` with the specified name and binary messenger.
+ *
+ * The channel name logically identifies the channel; identically named channels
+ * interfere with each other's communication.
+ *
+ * The binary messenger is a facility for sending raw, binary messages to the
+ * Flutter side. This protocol is implemented by `FlutterViewController`.
+ *
+ * The channel uses `FlutterStandardMethodCodec` to decode stream setup and
+ * teardown requests, and to encode event envelopes.
+ *
+ * @param name The channel name.
+ * @param messenger The binary messenger.
+ */
+ (instancetype)eventChannelWithName:(NSString*)name
+                     binaryMessenger:(NSObject<FlutterBinaryMessenger>*)messenger;
+
+/**
+ * Creates a `FlutterEventChannel` with the specified name, binary messenger,
+ * and method codec.
+ *
+ * The channel name logically identifies the channel; identically named channels
+ * interfere with each other's communication.
+ *
+ * The binary messenger is a facility for sending raw, binary messages to the
+ * Flutter side. This protocol is implemented by `FlutterViewController`.
+ *
+ * @param name The channel name.
+ * @param messenger The binary messenger.
+ * @param codec The method codec.
+ */
+ (instancetype)eventChannelWithName:(NSString*)name
+                     binaryMessenger:(NSObject<FlutterBinaryMessenger>*)messenger
+                               codec:(NSObject<FlutterMethodCodec>*)codec;
+
+/**
+ * Initializes a `FlutterEventChannel` with the specified name, binary messenger,
+ * and method codec.
+ *
+ * The channel name logically identifies the channel; identically named channels
+ * interfere with each other's communication.
+ *
+ * The binary messenger is a facility for sending raw, binary messages to the
+ * Flutter side. This protocol is implemented by `FlutterEngine` and `FlutterViewController`.
+ *
+ * @param name The channel name.
+ * @param messenger The binary messenger.
+ * @param codec The method codec.
+ */
+- (instancetype)initWithName:(NSString*)name
+             binaryMessenger:(NSObject<FlutterBinaryMessenger>*)messenger
+                       codec:(NSObject<FlutterMethodCodec>*)codec;
+/**
+ * Registers a handler for stream setup requests from the Flutter side.
+ *
+ * Replaces any existing handler. Use a `nil` handler for unregistering the
+ * existing handler.
+ *
+ * @param handler The stream handler.
+ */
+- (void)setStreamHandler:(NSObject<FlutterStreamHandler>* _Nullable)handler;
+@end
+NS_ASSUME_NONNULL_END
+
+#endif  // FLUTTER_FLUTTERCHANNELS_H_
@@ -0,0 +1,411 @@
+// 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.
+
+#ifndef FLUTTER_FLUTTERCODECS_H_
+#define FLUTTER_FLUTTERCODECS_H_
+
+#import <Foundation/Foundation.h>
+#include "FlutterMacros.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ A message encoding/decoding mechanism.
+ */
+FLUTTER_EXPORT
+@protocol FlutterMessageCodec
+/**
+ * Returns a shared instance of this `FlutterMessageCodec`.
+ */
+ (instancetype)sharedInstance;
+
+/**
+ * Encodes the specified message into binary.
+ *
+ * @param message The message.
+ * @return The binary encoding, or `nil`, if `message` was `nil`.
+ */
+- (NSData* _Nullable)encode:(id _Nullable)message;
+
+/**
+ * Decodes the specified message from binary.
+ *
+ * @param message The message.
+ * @return The decoded message, or `nil`, if `message` was `nil`.
+ */
+- (id _Nullable)decode:(NSData* _Nullable)message;
+@end
+
+/**
+ * A `FlutterMessageCodec` using unencoded binary messages, represented as
+ * `NSData` instances.
+ *
+ * This codec is guaranteed to be compatible with the corresponding
+ * [BinaryCodec](https://docs.flutter.io/flutter/services/BinaryCodec-class.html)
+ * on the Dart side. These parts of the Flutter SDK are evolved synchronously.
+ *
+ * On the Dart side, messages are represented using `ByteData`.
+ */
+FLUTTER_EXPORT
+@interface FlutterBinaryCodec : NSObject <FlutterMessageCodec>
+@end
+
+/**
+ * A `FlutterMessageCodec` using UTF-8 encoded `NSString` messages.
+ *
+ * This codec is guaranteed to be compatible with the corresponding
+ * [StringCodec](https://docs.flutter.io/flutter/services/StringCodec-class.html)
+ * on the Dart side. These parts of the Flutter SDK are evolved synchronously.
+ */
+FLUTTER_EXPORT
+@interface FlutterStringCodec : NSObject <FlutterMessageCodec>
+@end
+
+/**
+ * A `FlutterMessageCodec` using UTF-8 encoded JSON messages.
+ *
+ * This codec is guaranteed to be compatible with the corresponding
+ * [JSONMessageCodec](https://docs.flutter.io/flutter/services/JSONMessageCodec-class.html)
+ * on the Dart side. These parts of the Flutter SDK are evolved synchronously.
+ *
+ * Supports values accepted by `NSJSONSerialization` plus top-level
+ * `nil`, `NSNumber`, and `NSString`.
+ *
+ * On the Dart side, JSON messages are handled by the JSON facilities of the
+ * [`dart:convert`](https://api.dartlang.org/stable/dart-convert/JSON-constant.html)
+ * package.
+ */
+FLUTTER_EXPORT
+@interface FlutterJSONMessageCodec : NSObject <FlutterMessageCodec>
+@end
+
+/**
+ * A writer of the Flutter standard binary encoding.
+ *
+ * See `FlutterStandardMessageCodec` for details on the encoding.
+ *
+ * The encoding is extensible via subclasses overriding `writeValue`.
+ */
+FLUTTER_EXPORT
+@interface FlutterStandardWriter : NSObject
+- (instancetype)initWithData:(NSMutableData*)data;
+- (void)writeByte:(UInt8)value;
+- (void)writeBytes:(const void*)bytes length:(NSUInteger)length;
+- (void)writeData:(NSData*)data;
+- (void)writeSize:(UInt32)size;
+- (void)writeAlignment:(UInt8)alignment;
+- (void)writeUTF8:(NSString*)value;
+- (void)writeValue:(id)value;
+@end
+
+/**
+ * A reader of the Flutter standard binary encoding.
+ *
+ * See `FlutterStandardMessageCodec` for details on the encoding.
+ *
+ * The encoding is extensible via subclasses overriding `readValueOfType`.
+ */
+FLUTTER_EXPORT
+@interface FlutterStandardReader : NSObject
+- (instancetype)initWithData:(NSData*)data;
+- (BOOL)hasMore;
+- (UInt8)readByte;
+- (void)readBytes:(void*)destination length:(NSUInteger)length;
+- (NSData*)readData:(NSUInteger)length;
+- (UInt32)readSize;
+- (void)readAlignment:(UInt8)alignment;
+- (NSString*)readUTF8;
+- (nullable id)readValue;
+- (nullable id)readValueOfType:(UInt8)type;
+@end
+
+/**
+ * A factory of compatible reader/writer instances using the Flutter standard
+ * binary encoding or extensions thereof.
+ */
+FLUTTER_EXPORT
+@interface FlutterStandardReaderWriter : NSObject
+- (FlutterStandardWriter*)writerWithData:(NSMutableData*)data;
+- (FlutterStandardReader*)readerWithData:(NSData*)data;
+@end
+
+/**
+ * A `FlutterMessageCodec` using the Flutter standard binary encoding.
+ *
+ * This codec is guaranteed to be compatible with the corresponding
+ * [StandardMessageCodec](https://docs.flutter.io/flutter/services/StandardMessageCodec-class.html)
+ * on the Dart side. These parts of the Flutter SDK are evolved synchronously.
+ *
+ * Supported messages are acyclic values of these forms:
+ *
+ * - `nil` or `NSNull`
+ * - `NSNumber` (including their representation of Boolean values)
+ * - `NSString`
+ * - `FlutterStandardTypedData`
+ * - `NSArray` of supported values
+ * - `NSDictionary` with supported keys and values
+ *
+ * On the Dart side, these values are represented as follows:
+ *
+ * - `nil` or `NSNull`: null
+ * - `NSNumber`: `bool`, `int`, or `double`, depending on the contained value.
+ * - `NSString`: `String`
+ * - `FlutterStandardTypedData`: `Uint8List`, `Int32List`, `Int64List`, or `Float64List`
+ * - `NSArray`: `List`
+ * - `NSDictionary`: `Map`
+ */
+FLUTTER_EXPORT
+@interface FlutterStandardMessageCodec : NSObject <FlutterMessageCodec>
+ (instancetype)codecWithReaderWriter:(FlutterStandardReaderWriter*)readerWriter;
+@end
+
+/**
+ Command object representing a method call on a `FlutterMethodChannel`.
+ */
+FLUTTER_EXPORT
+@interface FlutterMethodCall : NSObject
+/**
+ * Creates a method call for invoking the specified named method with the
+ * specified arguments.
+ *
+ * @param method the name of the method to call.
+ * @param arguments the arguments value.
+ */
+ (instancetype)methodCallWithMethodName:(NSString*)method arguments:(id _Nullable)arguments;
+
+/**
+ * The method name.
+ */
+@property(readonly, nonatomic) NSString* method;
+
+/**
+ * The arguments.
+ */
+@property(readonly, nonatomic, nullable) id arguments;
+@end
+
+/**
+ * Error object representing an unsuccessful outcome of invoking a method
+ * on a `FlutterMethodChannel`, or an error event on a `FlutterEventChannel`.
+ */
+FLUTTER_EXPORT
+@interface FlutterError : NSObject
+/**
+ * Creates a `FlutterError` with the specified error code, message, and details.
+ *
+ * @param code An error code string for programmatic use.
+ * @param message A human-readable error message.
+ * @param details Custom error details.
+ */
+ (instancetype)errorWithCode:(NSString*)code
+                      message:(NSString* _Nullable)message
+                      details:(id _Nullable)details;
+/**
+ The error code.
+ */
+@property(readonly, nonatomic) NSString* code;
+
+/**
+ The error message.
+ */
+@property(readonly, nonatomic, nullable) NSString* message;
+
+/**
+ The error details.
+ */
+@property(readonly, nonatomic, nullable) id details;
+@end
+
+/**
+ * Type of numeric data items encoded in a `FlutterStandardDataType`.
+ *
+ * - FlutterStandardDataTypeUInt8: plain bytes
+ * - FlutterStandardDataTypeInt32: 32-bit signed integers
+ * - FlutterStandardDataTypeInt64: 64-bit signed integers
+ * - FlutterStandardDataTypeFloat64: 64-bit floats
+ */
+typedef NS_ENUM(NSInteger, FlutterStandardDataType) {
+  FlutterStandardDataTypeUInt8,
+  FlutterStandardDataTypeInt32,
+  FlutterStandardDataTypeInt64,
+  FlutterStandardDataTypeFloat64,
+};
+
+/**
+ * A byte buffer holding `UInt8`, `SInt32`, `SInt64`, or `Float64` values, used
+ * with `FlutterStandardMessageCodec` and `FlutterStandardMethodCodec`.
+ *
+ * Two's complement encoding is used for signed integers. IEEE754
+ * double-precision representation is used for floats. The platform's native
+ * endianness is assumed.
+ */
+FLUTTER_EXPORT
+@interface FlutterStandardTypedData : NSObject
+/**
+ * Creates a `FlutterStandardTypedData` which interprets the specified data
+ * as plain bytes.
+ *
+ * @param data the byte data.
+ */
+ (instancetype)typedDataWithBytes:(NSData*)data;
+
+/**
+ * Creates a `FlutterStandardTypedData` which interprets the specified data
+ * as 32-bit signed integers.
+ *
+ * @param data the byte data. The length must be divisible by 4.
+ */
+ (instancetype)typedDataWithInt32:(NSData*)data;
+
+/**
+ * Creates a `FlutterStandardTypedData` which interprets the specified data
+ * as 64-bit signed integers.
+ *
+ * @param data the byte data. The length must be divisible by 8.
+ */
+ (instancetype)typedDataWithInt64:(NSData*)data;
+
+/**
+ * Creates a `FlutterStandardTypedData` which interprets the specified data
+ * as 64-bit floats.
+ *
+ * @param data the byte data. The length must be divisible by 8.
+ */
+ (instancetype)typedDataWithFloat64:(NSData*)data;
+
+/**
+ * The raw underlying data buffer.
+ */
+@property(readonly, nonatomic) NSData* data;
+
+/**
+ * The type of the encoded values.
+ */
+@property(readonly, nonatomic) FlutterStandardDataType type;
+
+/**
+ * The number of value items encoded.
+ */
+@property(readonly, nonatomic) UInt32 elementCount;
+
+/**
+ * The number of bytes used by the encoding of a single value item.
+ */
+@property(readonly, nonatomic) UInt8 elementSize;
+@end
+
+/**
+ * An arbitrarily large integer value, used with `FlutterStandardMessageCodec`
+ * and `FlutterStandardMethodCodec`.
+ */
+FLUTTER_EXPORT
+FLUTTER_UNAVAILABLE("Unavailable on 2018-08-31. Deprecated on 2018-01-09. "
+                    "FlutterStandardBigInteger was needed because the Dart 1.0 int type had no "
+                    "size limit. With Dart 2.0, the int type is a fixed-size, 64-bit signed "
+                    "integer. If you need to communicate larger integers, use NSString encoding "
+                    "instead.")
+@interface FlutterStandardBigInteger : NSObject
+@end
+
+/**
+ * A codec for method calls and enveloped results.
+ *
+ * Method calls are encoded as binary messages with enough structure that the
+ * codec can extract a method name `NSString` and an arguments `NSObject`,
+ * possibly `nil`. These data items are used to populate a `FlutterMethodCall`.
+ *
+ * Result envelopes are encoded as binary messages with enough structure that
+ * the codec can determine whether the result was successful or an error. In
+ * the former case, the codec can extract the result `NSObject`, possibly `nil`.
+ * In the latter case, the codec can extract an error code `NSString`, a
+ * human-readable `NSString` error message (possibly `nil`), and a custom
+ * error details `NSObject`, possibly `nil`. These data items are used to
+ * populate a `FlutterError`.
+ */
+FLUTTER_EXPORT
+@protocol FlutterMethodCodec
+/**
+ * Provides access to a shared instance this codec.
+ *
+ * @return The shared instance.
+ */
+ (instancetype)sharedInstance;
+
+/**
+ * Encodes the specified method call into binary.
+ *
+ * @param methodCall The method call. The arguments value
+ *   must be supported by this codec.
+ * @return The binary encoding.
+ */
+- (NSData*)encodeMethodCall:(FlutterMethodCall*)methodCall;
+
+/**
+ * Decodes the specified method call from binary.
+ *
+ * @param methodCall The method call to decode.
+ * @return The decoded method call.
+ */
+- (FlutterMethodCall*)decodeMethodCall:(NSData*)methodCall;
+
+/**
+ * Encodes the specified successful result into binary.
+ *
+ * @param result The result. Must be a value supported by this codec.
+ * @return The binary encoding.
+ */
+- (NSData*)encodeSuccessEnvelope:(id _Nullable)result;
+
+/**
+ * Encodes the specified error result into binary.
+ *
+ * @param error The error object. The error details value must be supported
+ *   by this codec.
+ * @return The binary encoding.
+ */
+- (NSData*)encodeErrorEnvelope:(FlutterError*)error;
+
+/**
+ * Deccodes the specified result envelope from binary.
+ *
+ * @param envelope The error object.
+ * @return The result value, if the envelope represented a successful result,
+ *   or a `FlutterError` instance, if not.
+ */
+- (id _Nullable)decodeEnvelope:(NSData*)envelope;
+@end
+
+/**
+ * A `FlutterMethodCodec` using UTF-8 encoded JSON method calls and result
+ * envelopes.
+ *
+ * This codec is guaranteed to be compatible with the corresponding
+ * [JSONMethodCodec](https://docs.flutter.io/flutter/services/JSONMethodCodec-class.html)
+ * on the Dart side. These parts of the Flutter SDK are evolved synchronously.
+ *
+ * Values supported as methods arguments and result payloads are
+ * those supported as top-level or leaf values by `FlutterJSONMessageCodec`.
+ */
+FLUTTER_EXPORT
+@interface FlutterJSONMethodCodec : NSObject <FlutterMethodCodec>
+@end
+
+/**
+ * A `FlutterMethodCodec` using the Flutter standard binary encoding.
+ *
+ * This codec is guaranteed to be compatible with the corresponding
+ * [StandardMethodCodec](https://docs.flutter.io/flutter/services/StandardMethodCodec-class.html)
+ * on the Dart side. These parts of the Flutter SDK are evolved synchronously.
+ *
+ * Values supported as method arguments and result payloads are those supported by
+ * `FlutterStandardMessageCodec`.
+ */
+FLUTTER_EXPORT
+@interface FlutterStandardMethodCodec : NSObject <FlutterMethodCodec>
+ (instancetype)codecWithReaderWriter:(FlutterStandardReaderWriter*)readerWriter;
+@end
+
+NS_ASSUME_NONNULL_END
+
+#endif  // FLUTTER_FLUTTERCODECS_H_
@@ -0,0 +1,14 @@
+// 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.
+
+#import "FLEOpenGLContextHandling.h"
+#import "FLEPlugin.h"
+#import "FLEPluginRegistrar.h"
+#import "FLEReshapeListener.h"
+#import "FLEView.h"
+#import "FLEViewController.h"
+#import "FlutterBinaryMessenger.h"
+#import "FlutterChannels.h"
+#import "FlutterCodecs.h"
+#import "FlutterMacros.h"
@@ -0,0 +1,40 @@
+// 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.
+
+#ifndef FLUTTER_FLUTTERMACROS_H_
+#define FLUTTER_FLUTTERMACROS_H_
+
+#if defined(FLUTTER_FRAMEWORK)
+
+#define FLUTTER_EXPORT __attribute__((visibility("default")))
+
+#else  // defined(FLUTTER_SDK)
+
+#define FLUTTER_EXPORT
+
+#endif  // defined(FLUTTER_SDK)
+
+#ifndef NS_ASSUME_NONNULL_BEGIN
+#define NS_ASSUME_NONNULL_BEGIN _Pragma("clang assume_nonnull begin")
+#define NS_ASSUME_NONNULL_END _Pragma("clang assume_nonnull end")
+#endif  // defined(NS_ASSUME_NONNULL_BEGIN)
+
+/**
+ * Indicates that the API has been deprecated for the specified reason. Code
+ * that uses the deprecated API will continue to work as before. However, the
+ * API will soon become unavailable and users are encouraged to immediately take
+ * the appropriate action mentioned in the deprecation message and the BREAKING
+ * CHANGES section present in the Flutter.h umbrella header.
+ */
+#define FLUTTER_DEPRECATED(msg) __attribute__((__deprecated__(msg)))
+
+/**
+ * Indicates that the previously deprecated API is now unavailable. Code that
+ * uses the API will not work and the declaration of the API is only a stub
+ * meant to display the given message detailing the actions for the user to take
+ * immediately.
+ */
+#define FLUTTER_UNAVAILABLE(msg) __attribute__((__unavailable__(msg)))
+
+#endif  // FLUTTER_FLUTTERMACROS_H_
@@ -0,0 +1,6 @@
+framework module FlutterMacOS {
+  umbrella header "FlutterMacOS.h"
+
+  export *
+  module * { export * }
+}
@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>en</string>
+	<key>CFBundleExecutable</key>
+	<string>FlutterMacOS</string>
+	<key>CFBundleIdentifier</key>
+	<string>io.flutter.flutter-macos</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>FlutterMacOS</string>
+	<key>CFBundlePackageType</key>
+	<string>FMWK</string>
+	<key>CFBundleShortVersionString</key>
+	<string>1.0</string>
+	<key>CFBundleVersion</key>
+	<string>1.0</string>
+	<key>NSPrincipalClass</key>
+	<string></string>
+</dict>
+</plist>
@@ -0,0 +1 @@
+A