unassigned icons gelöscht
parent
c098e10efa
commit
ee6288b0cc
|
|
@ -0,0 +1 @@
|
|||
fc94a990d9abd8bd2698bba2b84538d7
|
||||
Binary file not shown.
|
|
@ -0,0 +1,26 @@
|
|||
<?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>App</string>
|
||||
<key>CFBundleIdentifier</key>
|
||||
<string>io.flutter.flutter.app</string>
|
||||
<key>CFBundleInfoDictionaryVersion</key>
|
||||
<string>6.0</string>
|
||||
<key>CFBundleName</key>
|
||||
<string>App</string>
|
||||
<key>CFBundlePackageType</key>
|
||||
<string>FMWK</string>
|
||||
<key>CFBundleShortVersionString</key>
|
||||
<string>1.0</string>
|
||||
<key>CFBundleSignature</key>
|
||||
<string>????</string>
|
||||
<key>CFBundleVersion</key>
|
||||
<string>1.0</string>
|
||||
<key>MinimumOSVersion</key>
|
||||
<string>12.0</string>
|
||||
</dict>
|
||||
</plist>
|
||||
|
|
@ -0,0 +1,234 @@
|
|||
<?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>files</key>
|
||||
<dict>
|
||||
<key>Info.plist</key>
|
||||
<data>
|
||||
h5OB7aKzS5WR9SemvZAyN6FEkJs=
|
||||
</data>
|
||||
<key>flutter_assets/AssetManifest.bin</key>
|
||||
<data>
|
||||
nppY/SgfJlLHZzmbow3RnZMXeVI=
|
||||
</data>
|
||||
<key>flutter_assets/AssetManifest.json</key>
|
||||
<data>
|
||||
SrA+dnnv0cgCjtutFqnacYn9E/M=
|
||||
</data>
|
||||
<key>flutter_assets/FontManifest.json</key>
|
||||
<data>
|
||||
vKJkVIcw+LGHFnKJGwrQwCREv68=
|
||||
</data>
|
||||
<key>flutter_assets/NOTICES.Z</key>
|
||||
<data>
|
||||
QCDACWf11cA4QfYwAwI/1JnWBaw=
|
||||
</data>
|
||||
<key>flutter_assets/assets/appbar_background.png</key>
|
||||
<data>
|
||||
JkgEiNZSVRa0lrDwrdeN4N1j56k=
|
||||
</data>
|
||||
<key>flutter_assets/assets/logo.png</key>
|
||||
<data>
|
||||
Kp3Vqz9/+Q7JHvx/0dcelGsVQ0Y=
|
||||
</data>
|
||||
<key>flutter_assets/fonts/MaterialIcons-Regular.otf</key>
|
||||
<data>
|
||||
/CUoTuPQqqdexfyOT9lpJhV+2MQ=
|
||||
</data>
|
||||
<key>flutter_assets/isolate_snapshot_data</key>
|
||||
<data>
|
||||
cU5igDxcIVzLQT2ishbNSdUocVk=
|
||||
</data>
|
||||
<key>flutter_assets/kernel_blob.bin</key>
|
||||
<data>
|
||||
2S861NjVoBUyLZO/rAR+4BdQj3A=
|
||||
</data>
|
||||
<key>flutter_assets/packages/cupertino_icons/assets/CupertinoIcons.ttf</key>
|
||||
<data>
|
||||
Bvk+P1ykE1PGRdktwgwDyz6AOqM=
|
||||
</data>
|
||||
<key>flutter_assets/shaders/ink_sparkle.frag</key>
|
||||
<data>
|
||||
hBZgIGdEvhX+IvXd5bjkjJVu6+s=
|
||||
</data>
|
||||
<key>flutter_assets/vm_snapshot_data</key>
|
||||
<data>
|
||||
ap40xllbguuMfkV4mJkKh/NQWg4=
|
||||
</data>
|
||||
</dict>
|
||||
<key>files2</key>
|
||||
<dict>
|
||||
<key>flutter_assets/AssetManifest.bin</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
q8Ie4Ld3/fiNviXBIo+2I1C35qbB9odFDYKbahX2XZY=
|
||||
</data>
|
||||
</dict>
|
||||
<key>flutter_assets/AssetManifest.json</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
Bmf/DHmOo0s6mgjvOjLEVTky39BPm3x3AhVDJwMtcmw=
|
||||
</data>
|
||||
</dict>
|
||||
<key>flutter_assets/FontManifest.json</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
zX4DZFvESy3Ue3y2JvUcTsv1Whl6t3JBYotHrBZfviE=
|
||||
</data>
|
||||
</dict>
|
||||
<key>flutter_assets/NOTICES.Z</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
uxaMPyJTnaE0nTnvDYOClHo7+tK7avIaA0XpeSqftdE=
|
||||
</data>
|
||||
</dict>
|
||||
<key>flutter_assets/assets/appbar_background.png</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
EhS8+djmZXDI2ucxttToNMvFcA3W1ezHx112CQRIqpw=
|
||||
</data>
|
||||
</dict>
|
||||
<key>flutter_assets/assets/logo.png</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
QQd+B8xc2yWOncyL/vSm9aFtpY4LhK/gaxHds158yCc=
|
||||
</data>
|
||||
</dict>
|
||||
<key>flutter_assets/fonts/MaterialIcons-Regular.otf</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
2YZbZxoJ1oPROoYwidiCXg9ho3aWzl19RIvIAjqmJFM=
|
||||
</data>
|
||||
</dict>
|
||||
<key>flutter_assets/isolate_snapshot_data</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
2xhrt3e9Akh13HCD0k45mouHg3CpgXDn1AwXioeg1PY=
|
||||
</data>
|
||||
</dict>
|
||||
<key>flutter_assets/kernel_blob.bin</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
GQB/lHoxNUJcA5CBiQBdyBuX3jr7Tfbc7Ubr79pH6iM=
|
||||
</data>
|
||||
</dict>
|
||||
<key>flutter_assets/packages/cupertino_icons/assets/CupertinoIcons.ttf</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
Z8RP6Rg7AC553ef2l34piGYcmj5KPF/OloeH79vtgjw=
|
||||
</data>
|
||||
</dict>
|
||||
<key>flutter_assets/shaders/ink_sparkle.frag</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
0T+w183eMSTh5phjUfkXjg4ZpPYnVqkH4Gv3Ge4QCh8=
|
||||
</data>
|
||||
</dict>
|
||||
<key>flutter_assets/vm_snapshot_data</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
6eubeZZqyUNzwtBtT1r66GIIirzwERUZET0Gp6oe/CI=
|
||||
</data>
|
||||
</dict>
|
||||
</dict>
|
||||
<key>rules</key>
|
||||
<dict>
|
||||
<key>^.*</key>
|
||||
<true/>
|
||||
<key>^.*\.lproj/</key>
|
||||
<dict>
|
||||
<key>optional</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>1000</real>
|
||||
</dict>
|
||||
<key>^.*\.lproj/locversion.plist$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>1100</real>
|
||||
</dict>
|
||||
<key>^Base\.lproj/</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>1010</real>
|
||||
</dict>
|
||||
<key>^version.plist$</key>
|
||||
<true/>
|
||||
</dict>
|
||||
<key>rules2</key>
|
||||
<dict>
|
||||
<key>.*\.dSYM($|/)</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>11</real>
|
||||
</dict>
|
||||
<key>^(.*/)?\.DS_Store$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>2000</real>
|
||||
</dict>
|
||||
<key>^.*</key>
|
||||
<true/>
|
||||
<key>^.*\.lproj/</key>
|
||||
<dict>
|
||||
<key>optional</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>1000</real>
|
||||
</dict>
|
||||
<key>^.*\.lproj/locversion.plist$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>1100</real>
|
||||
</dict>
|
||||
<key>^Base\.lproj/</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>1010</real>
|
||||
</dict>
|
||||
<key>^Info\.plist$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>20</real>
|
||||
</dict>
|
||||
<key>^PkgInfo$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>20</real>
|
||||
</dict>
|
||||
<key>^embedded\.provisionprofile$</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>20</real>
|
||||
</dict>
|
||||
<key>^version\.plist$</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>20</real>
|
||||
</dict>
|
||||
</dict>
|
||||
</dict>
|
||||
</plist>
|
||||
|
|
@ -0,0 +1 @@
|
|||
assets/appbar_background.png
asset assets/appbar_background.pngassets/logo.png
assetassets/logo.png2packages/cupertino_icons/assets/CupertinoIcons.ttf
asset2packages/cupertino_icons/assets/CupertinoIcons.ttf
|
||||
|
|
@ -0,0 +1 @@
|
|||
{"assets/appbar_background.png":["assets/appbar_background.png"],"assets/logo.png":["assets/logo.png"],"packages/cupertino_icons/assets/CupertinoIcons.ttf":["packages/cupertino_icons/assets/CupertinoIcons.ttf"]}
|
||||
|
|
@ -0,0 +1 @@
|
|||
[{"family":"MaterialIcons","fonts":[{"asset":"fonts/MaterialIcons-Regular.otf"}]},{"family":"packages/cupertino_icons/CupertinoIcons","fonts":[{"asset":"packages/cupertino_icons/assets/CupertinoIcons.ttf"}]}]
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 4.6 MiB After Width: | Height: | Size: 4.6 MiB |
|
Before Width: | Height: | Size: 4.6 KiB After Width: | Height: | Size: 4.6 KiB |
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
|
|
@ -0,0 +1,24 @@
|
|||
// 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_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTER_H_
|
||||
#define FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTER_H_
|
||||
|
||||
#import "FlutterAppDelegate.h"
|
||||
#import "FlutterBinaryMessenger.h"
|
||||
#import "FlutterCallbackCache.h"
|
||||
#import "FlutterChannels.h"
|
||||
#import "FlutterCodecs.h"
|
||||
#import "FlutterDartProject.h"
|
||||
#import "FlutterEngine.h"
|
||||
#import "FlutterEngineGroup.h"
|
||||
#import "FlutterHeadlessDartRunner.h"
|
||||
#import "FlutterMacros.h"
|
||||
#import "FlutterPlatformViews.h"
|
||||
#import "FlutterPlugin.h"
|
||||
#import "FlutterPluginAppLifeCycleDelegate.h"
|
||||
#import "FlutterTexture.h"
|
||||
#import "FlutterViewController.h"
|
||||
|
||||
#endif // FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTER_H_
|
||||
|
|
@ -0,0 +1,34 @@
|
|||
// 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_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERAPPDELEGATE_H_
|
||||
#define FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERAPPDELEGATE_H_
|
||||
|
||||
#import <UIKit/UIKit.h>
|
||||
|
||||
#import "FlutterMacros.h"
|
||||
#import "FlutterPlugin.h"
|
||||
|
||||
/**
|
||||
* `UIApplicationDelegate` subclass for simple apps that want default behavior.
|
||||
*
|
||||
* This class implements the following behaviors:
|
||||
* * Status bar touches are forwarded to the key window's root view
|
||||
* `FlutterViewController`, in order to trigger scroll to top.
|
||||
* * Keeps the Flutter connection open in debug mode when the phone screen
|
||||
* locks.
|
||||
*
|
||||
* App delegates for Flutter applications are *not* required to inherit from
|
||||
* this class. Developers of custom app delegate classes should copy and paste
|
||||
* code as necessary from FlutterAppDelegate.mm.
|
||||
*/
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
@interface FlutterAppDelegate
|
||||
: UIResponder <UIApplicationDelegate, FlutterPluginRegistry, FlutterAppLifeCycleProvider>
|
||||
|
||||
@property(strong, nonatomic) UIWindow* window;
|
||||
|
||||
@end
|
||||
|
||||
#endif // FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERAPPDELEGATE_H_
|
||||
|
|
@ -0,0 +1,106 @@
|
|||
// 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_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERBINARYMESSENGER_H_
|
||||
#define FLUTTER_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERBINARYMESSENGER_H_
|
||||
|
||||
#import <Foundation/Foundation.h>
|
||||
|
||||
#import "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);
|
||||
|
||||
typedef int64_t FlutterBinaryMessengerConnection;
|
||||
|
||||
@protocol FlutterTaskQueue <NSObject>
|
||||
@end
|
||||
|
||||
/**
|
||||
* 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_DARWIN_EXPORT
|
||||
@protocol FlutterBinaryMessenger <NSObject>
|
||||
/// TODO(gaaclarke): Remove optional when macos supports Background Platform Channels.
|
||||
@optional
|
||||
- (NSObject<FlutterTaskQueue>*)makeBackgroundTaskQueue;
|
||||
|
||||
- (FlutterBinaryMessengerConnection)
|
||||
setMessageHandlerOnChannel:(NSString*)channel
|
||||
binaryMessageHandler:(FlutterBinaryMessageHandler _Nullable)handler
|
||||
taskQueue:(NSObject<FlutterTaskQueue>* _Nullable)taskQueue;
|
||||
|
||||
@required
|
||||
/**
|
||||
* 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;
|
||||
|
||||
/**
|
||||
* 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.
|
||||
* @return An identifier that represents the connection that was just created to the channel.
|
||||
*/
|
||||
- (FlutterBinaryMessengerConnection)setMessageHandlerOnChannel:(NSString*)channel
|
||||
binaryMessageHandler:
|
||||
(FlutterBinaryMessageHandler _Nullable)handler;
|
||||
|
||||
/**
|
||||
* Clears out a channel's message handler if that handler is still the one that
|
||||
* was created as a result of
|
||||
* `setMessageHandlerOnChannel:binaryMessageHandler:`.
|
||||
*
|
||||
* @param connection The result from `setMessageHandlerOnChannel:binaryMessageHandler:`.
|
||||
*/
|
||||
- (void)cleanUpConnection:(FlutterBinaryMessengerConnection)connection;
|
||||
@end
|
||||
NS_ASSUME_NONNULL_END
|
||||
#endif // FLUTTER_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERBINARYMESSENGER_H_
|
||||
|
|
@ -0,0 +1,54 @@
|
|||
// 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_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERCALLBACKCACHE_H_
|
||||
#define FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERCALLBACKCACHE_H_
|
||||
|
||||
#import <Foundation/Foundation.h>
|
||||
|
||||
#import "FlutterMacros.h"
|
||||
|
||||
/**
|
||||
* An object containing the result of `FlutterCallbackCache`'s `lookupCallbackInformation`
|
||||
* method.
|
||||
*/
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
@interface FlutterCallbackInformation : NSObject
|
||||
/**
|
||||
* The name of the callback.
|
||||
*/
|
||||
@property(copy) NSString* callbackName;
|
||||
/**
|
||||
* The class name of the callback.
|
||||
*/
|
||||
@property(copy) NSString* callbackClassName;
|
||||
/**
|
||||
* The library path of the callback.
|
||||
*/
|
||||
@property(copy) NSString* callbackLibraryPath;
|
||||
@end
|
||||
|
||||
/**
|
||||
* The cache containing callback information for spawning a
|
||||
* `FlutterHeadlessDartRunner`.
|
||||
*/
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
@interface FlutterCallbackCache : NSObject
|
||||
/**
|
||||
* Returns the callback information for the given callback handle.
|
||||
* This callback information can be used when spawning a
|
||||
* `FlutterHeadlessDartRunner`.
|
||||
*
|
||||
* @param handle The handle for a callback, provided by the
|
||||
* Dart method `PluginUtilities.getCallbackHandle`.
|
||||
* @return A `FlutterCallbackInformation` object which contains the name of the
|
||||
* callback, the name of the class in which the callback is defined, and the
|
||||
* path of the library which contains the callback. If the provided handle is
|
||||
* invalid, nil is returned.
|
||||
*/
|
||||
+ (FlutterCallbackInformation*)lookupCallbackInformation:(int64_t)handle;
|
||||
|
||||
@end
|
||||
|
||||
#endif // FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERCALLBACKCACHE_H_
|
||||
|
|
@ -0,0 +1,487 @@
|
|||
// 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_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERCHANNELS_H_
|
||||
#define FLUTTER_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERCHANNELS_H_
|
||||
|
||||
#import "FlutterBinaryMessenger.h"
|
||||
#import "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 which can be invoked from any
|
||||
* thread.
|
||||
*/
|
||||
typedef void (^FlutterMessageHandler)(id _Nullable message, FlutterReply callback);
|
||||
|
||||
/**
|
||||
* A channel for communicating with the Flutter side using basic, asynchronous
|
||||
* message passing.
|
||||
*/
|
||||
FLUTTER_DARWIN_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;
|
||||
|
||||
/**
|
||||
* 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.
|
||||
* @param taskQueue The FlutterTaskQueue that executes the handler (see
|
||||
-[FlutterBinaryMessenger makeBackgroundTaskQueue]).
|
||||
*/
|
||||
- (instancetype)initWithName:(NSString*)name
|
||||
binaryMessenger:(NSObject<FlutterBinaryMessenger>*)messenger
|
||||
codec:(NSObject<FlutterMessageCodec>*)codec
|
||||
taskQueue:(NSObject<FlutterTaskQueue>* _Nullable)taskQueue;
|
||||
|
||||
/**
|
||||
* 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;
|
||||
|
||||
/**
|
||||
* 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;
|
||||
|
||||
/**
|
||||
* Adjusts the number of messages that will get buffered when sending messages to
|
||||
* channels that aren't fully set up yet. For example, the engine isn't running
|
||||
* yet or the channel's message handler isn't set up on the Dart side yet.
|
||||
*
|
||||
* @param name The channel name.
|
||||
* @param messenger The binary messenger.
|
||||
* @param newSize The number of messages that will get buffered.
|
||||
*/
|
||||
+ (void)resizeChannelWithName:(NSString*)name
|
||||
binaryMessenger:(NSObject<FlutterBinaryMessenger>*)messenger
|
||||
size:(NSInteger)newSize;
|
||||
|
||||
/**
|
||||
* Adjusts the number of messages that will get buffered when sending messages to
|
||||
* channels that aren't fully set up yet. For example, the engine isn't running
|
||||
* yet or the channel's message handler isn't set up on the Dart side yet.
|
||||
*
|
||||
* @param newSize The number of messages that will get buffered.
|
||||
*/
|
||||
- (void)resizeChannelBuffer:(NSInteger)newSize;
|
||||
|
||||
/**
|
||||
* Defines whether the channel should show warning messages when discarding messages
|
||||
* due to overflow.
|
||||
*
|
||||
* @param warns When false, the channel is expected to overflow and warning messages
|
||||
* will not be shown.
|
||||
* @param name The channel name.
|
||||
* @param messenger The binary messenger.
|
||||
*/
|
||||
+ (void)setWarnsOnOverflow:(BOOL)warns
|
||||
forChannelWithName:(NSString*)name
|
||||
binaryMessenger:(NSObject<FlutterBinaryMessenger>*)messenger;
|
||||
|
||||
/**
|
||||
* Defines whether the channel should show warning messages when discarding messages
|
||||
* due to overflow.
|
||||
*
|
||||
* @param warns When false, the channel is expected to overflow and warning messages
|
||||
* will not be shown.
|
||||
*/
|
||||
- (void)setWarnsOnOverflow:(BOOL)warns;
|
||||
|
||||
@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. This can be invoked from any thread.
|
||||
*/
|
||||
typedef void (^FlutterMethodCallHandler)(FlutterMethodCall* call, FlutterResult result);
|
||||
|
||||
/**
|
||||
* A constant used with `FlutterMethodCallHandler` to respond to the call of an
|
||||
* unknown method.
|
||||
*/
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
extern NSObject const* FlutterMethodNotImplemented;
|
||||
|
||||
/**
|
||||
* A channel for communicating with the Flutter side using invocation of
|
||||
* asynchronous methods.
|
||||
*/
|
||||
FLUTTER_DARWIN_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;
|
||||
|
||||
/**
|
||||
* Initializes a `FlutterMethodChannel` with the specified name, binary messenger,
|
||||
* method codec, and task queue.
|
||||
*
|
||||
* 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.
|
||||
* @param taskQueue The FlutterTaskQueue that executes the handler (see
|
||||
-[FlutterBinaryMessenger makeBackgroundTaskQueue]).
|
||||
*/
|
||||
- (instancetype)initWithName:(NSString*)name
|
||||
binaryMessenger:(NSObject<FlutterBinaryMessenger>*)messenger
|
||||
codec:(NSObject<FlutterMethodCodec>*)codec
|
||||
taskQueue:(NSObject<FlutterTaskQueue>* _Nullable)taskQueue;
|
||||
|
||||
// clang-format off
|
||||
/**
|
||||
* Invokes the specified Flutter method with the specified arguments, expecting
|
||||
* no results.
|
||||
*
|
||||
* @see [MethodChannel.setMethodCallHandler](https://api.flutter.dev/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;
|
||||
/**
|
||||
* 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;
|
||||
|
||||
/**
|
||||
* Adjusts the number of messages that will get buffered when sending messages to
|
||||
* channels that aren't fully set up yet. For example, the engine isn't running
|
||||
* yet or the channel's message handler isn't set up on the Dart side yet.
|
||||
*/
|
||||
- (void)resizeChannelBuffer:(NSInteger)newSize;
|
||||
|
||||
@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_DARWIN_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_DARWIN_EXPORT
|
||||
extern NSObject const* FlutterEndOfEventStream;
|
||||
|
||||
/**
|
||||
* A channel for communicating with the Flutter side using event streams.
|
||||
*/
|
||||
FLUTTER_DARWIN_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;
|
||||
|
||||
/**
|
||||
* Initializes a `FlutterEventChannel` with the specified name, binary messenger,
|
||||
* method codec and task queue.
|
||||
*
|
||||
* 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.
|
||||
* @param taskQueue The FlutterTaskQueue that executes the handler (see
|
||||
-[FlutterBinaryMessenger makeBackgroundTaskQueue]).
|
||||
*/
|
||||
- (instancetype)initWithName:(NSString*)name
|
||||
binaryMessenger:(NSObject<FlutterBinaryMessenger>*)messenger
|
||||
codec:(NSObject<FlutterMethodCodec>*)codec
|
||||
taskQueue:(NSObject<FlutterTaskQueue>* _Nullable)taskQueue;
|
||||
/**
|
||||
* 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_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERCHANNELS_H_
|
||||
|
|
@ -0,0 +1,478 @@
|
|||
// 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_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERCODECS_H_
|
||||
#define FLUTTER_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERCODECS_H_
|
||||
|
||||
#import <Foundation/Foundation.h>
|
||||
|
||||
#import "FlutterMacros.h"
|
||||
|
||||
NS_ASSUME_NONNULL_BEGIN
|
||||
|
||||
/**
|
||||
* A message encoding/decoding mechanism.
|
||||
*/
|
||||
FLUTTER_DARWIN_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://api.flutter.dev/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_DARWIN_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://api.flutter.dev/flutter/services/StringCodec-class.html)
|
||||
* on the Dart side. These parts of the Flutter SDK are evolved synchronously.
|
||||
*/
|
||||
FLUTTER_DARWIN_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://api.flutter.dev/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_DARWIN_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_DARWIN_EXPORT
|
||||
@interface FlutterStandardWriter : NSObject
|
||||
/**
|
||||
* Create a `FlutterStandardWriter` who will write to \p data.
|
||||
*/
|
||||
- (instancetype)initWithData:(NSMutableData*)data;
|
||||
/** Write a 8-bit byte. */
|
||||
- (void)writeByte:(UInt8)value;
|
||||
/** Write an array of \p bytes of size \p length. */
|
||||
- (void)writeBytes:(const void*)bytes length:(NSUInteger)length;
|
||||
/** Write an array of bytes contained in \p data. */
|
||||
- (void)writeData:(NSData*)data;
|
||||
/** Write 32-bit unsigned integer that represents a \p size of a collection. */
|
||||
- (void)writeSize:(UInt32)size;
|
||||
/** Write zero padding until data is aligned with \p alignment. */
|
||||
- (void)writeAlignment:(UInt8)alignment;
|
||||
/** Write a string with UTF-8 encoding. */
|
||||
- (void)writeUTF8:(NSString*)value;
|
||||
/** Introspects into an object and writes its representation.
|
||||
*
|
||||
* Supported Data Types:
|
||||
* - NSNull
|
||||
* - NSNumber
|
||||
* - NSString (as UTF-8)
|
||||
* - FlutterStandardTypedData
|
||||
* - NSArray of supported types
|
||||
* - NSDictionary of supporte types
|
||||
*
|
||||
* NSAsserts on failure.
|
||||
*/
|
||||
- (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_DARWIN_EXPORT
|
||||
@interface FlutterStandardReader : NSObject
|
||||
/**
|
||||
* Create a new `FlutterStandardReader` who reads from \p data.
|
||||
*/
|
||||
- (instancetype)initWithData:(NSData*)data;
|
||||
/** Returns YES when the reader hasn't reached the end of its data. */
|
||||
- (BOOL)hasMore;
|
||||
/** Reads a byte value and increments the position. */
|
||||
- (UInt8)readByte;
|
||||
/** Reads a sequence of byte values of \p length and increments the position. */
|
||||
- (void)readBytes:(void*)destination length:(NSUInteger)length;
|
||||
/** Reads a sequence of byte values of \p length and increments the position. */
|
||||
- (NSData*)readData:(NSUInteger)length;
|
||||
/** Reads a 32-bit unsigned integer representing a collection size and increments the position.*/
|
||||
- (UInt32)readSize;
|
||||
/** Advances the read position until it is aligned with \p alignment. */
|
||||
- (void)readAlignment:(UInt8)alignment;
|
||||
/** Read a null terminated string encoded with UTF-8/ */
|
||||
- (NSString*)readUTF8;
|
||||
/**
|
||||
* Reads a byte for `FlutterStandardField` the decodes a value matching that type.
|
||||
*
|
||||
* See also: -[FlutterStandardWriter writeValue]
|
||||
*/
|
||||
- (nullable id)readValue;
|
||||
/**
|
||||
* Decodes a value matching the \p type specified.
|
||||
*
|
||||
* See also:
|
||||
* - `FlutterStandardField`
|
||||
* - `-[FlutterStandardWriter writeValue]`
|
||||
*/
|
||||
- (nullable id)readValueOfType:(UInt8)type;
|
||||
@end
|
||||
|
||||
/**
|
||||
* A factory of compatible reader/writer instances using the Flutter standard
|
||||
* binary encoding or extensions thereof.
|
||||
*/
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
@interface FlutterStandardReaderWriter : NSObject
|
||||
/**
|
||||
* Create a new `FlutterStandardWriter` for writing to \p data.
|
||||
*/
|
||||
- (FlutterStandardWriter*)writerWithData:(NSMutableData*)data;
|
||||
/**
|
||||
* Create a new `FlutterStandardReader` for reading from \p 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://api.flutter.dev/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_DARWIN_EXPORT
|
||||
@interface FlutterStandardMessageCodec : NSObject <FlutterMessageCodec>
|
||||
/**
|
||||
* Create a `FlutterStandardMessageCodec` who will read and write to \p readerWriter.
|
||||
*/
|
||||
+ (instancetype)codecWithReaderWriter:(FlutterStandardReaderWriter*)readerWriter;
|
||||
@end
|
||||
|
||||
/**
|
||||
* Command object representing a method call on a `FlutterMethodChannel`.
|
||||
*/
|
||||
FLUTTER_DARWIN_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_DARWIN_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) {
|
||||
// NOLINTBEGIN(readability-identifier-naming)
|
||||
FlutterStandardDataTypeUInt8,
|
||||
FlutterStandardDataTypeInt32,
|
||||
FlutterStandardDataTypeInt64,
|
||||
FlutterStandardDataTypeFloat32,
|
||||
FlutterStandardDataTypeFloat64,
|
||||
// NOLINTEND(readability-identifier-naming)
|
||||
};
|
||||
|
||||
/**
|
||||
* 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_DARWIN_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 32-bit floats.
|
||||
*
|
||||
* @param data the byte data. The length must be divisible by 8.
|
||||
*/
|
||||
+ (instancetype)typedDataWithFloat32:(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, assign) FlutterStandardDataType type;
|
||||
|
||||
/**
|
||||
* The number of value items encoded.
|
||||
*/
|
||||
@property(readonly, nonatomic, assign) UInt32 elementCount;
|
||||
|
||||
/**
|
||||
* The number of bytes used by the encoding of a single value item.
|
||||
*/
|
||||
@property(readonly, nonatomic, assign) UInt8 elementSize;
|
||||
@end
|
||||
|
||||
/**
|
||||
* An arbitrarily large integer value, used with `FlutterStandardMessageCodec`
|
||||
* and `FlutterStandardMethodCodec`.
|
||||
*/
|
||||
FLUTTER_DARWIN_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_DARWIN_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://api.flutter.dev/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_DARWIN_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://api.flutter.dev/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_DARWIN_EXPORT
|
||||
@interface FlutterStandardMethodCodec : NSObject <FlutterMethodCodec>
|
||||
/**
|
||||
* Create a `FlutterStandardMethodCodec` who will read and write to \p readerWriter.
|
||||
*/
|
||||
+ (instancetype)codecWithReaderWriter:(FlutterStandardReaderWriter*)readerWriter;
|
||||
@end
|
||||
|
||||
NS_ASSUME_NONNULL_END
|
||||
|
||||
#endif // FLUTTER_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERCODECS_H_
|
||||
|
|
@ -0,0 +1,103 @@
|
|||
// 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_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERDARTPROJECT_H_
|
||||
#define FLUTTER_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERDARTPROJECT_H_
|
||||
|
||||
#import <Foundation/Foundation.h>
|
||||
#import <TargetConditionals.h>
|
||||
|
||||
#import "FlutterMacros.h"
|
||||
|
||||
NS_ASSUME_NONNULL_BEGIN
|
||||
|
||||
/**
|
||||
* A set of Flutter and Dart assets used by a `FlutterEngine` to initialize execution.
|
||||
*
|
||||
*/
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
@interface FlutterDartProject : NSObject
|
||||
|
||||
/**
|
||||
* Initializes a Flutter Dart project from a bundle.
|
||||
*
|
||||
* The bundle must either contain a flutter_assets resource directory, or set the Info.plist key
|
||||
* FLTAssetsPath to override that name (if you are doing a custom build using a different name).
|
||||
*
|
||||
* @param bundle The bundle containing the Flutter assets directory. If nil, the App framework
|
||||
* created by Flutter will be used.
|
||||
*/
|
||||
- (instancetype)initWithPrecompiledDartBundle:(nullable NSBundle*)bundle NS_DESIGNATED_INITIALIZER;
|
||||
/**
|
||||
* Unavailable - use `init` instead.
|
||||
*/
|
||||
- (instancetype)initFromDefaultSourceForConfiguration API_UNAVAILABLE(macos)
|
||||
FLUTTER_UNAVAILABLE("Use -init instead.");
|
||||
|
||||
/**
|
||||
* Returns the default identifier for the bundle where we expect to find the Flutter Dart
|
||||
* application.
|
||||
*/
|
||||
+ (NSString*)defaultBundleIdentifier;
|
||||
|
||||
/**
|
||||
* An NSArray of NSStrings to be passed as command line arguments to the Dart entrypoint.
|
||||
*
|
||||
* If this is not explicitly set, this will default to the contents of
|
||||
* [NSProcessInfo arguments], without the binary name.
|
||||
*
|
||||
* Set this to nil to pass no arguments to the Dart entrypoint.
|
||||
*/
|
||||
@property(nonatomic, nullable, copy)
|
||||
NSArray<NSString*>* dartEntrypointArguments API_UNAVAILABLE(ios);
|
||||
|
||||
/**
|
||||
* Returns the file name for the given asset. If the bundle with the identifier
|
||||
* "io.flutter.flutter.app" exists, it will try use that bundle; otherwise, it
|
||||
* will use the main bundle. To specify a different bundle, use
|
||||
* `+lookupKeyForAsset:fromBundle`.
|
||||
*
|
||||
* @param asset The name of the asset. The name can be hierarchical.
|
||||
* @return the file name to be used for lookup in the main bundle.
|
||||
*/
|
||||
+ (NSString*)lookupKeyForAsset:(NSString*)asset;
|
||||
|
||||
/**
|
||||
* Returns the file name for the given asset.
|
||||
* The returned file name can be used to access the asset in the supplied bundle.
|
||||
*
|
||||
* @param asset The name of the asset. The name can be hierarchical.
|
||||
* @param bundle The `NSBundle` to use for looking up the asset.
|
||||
* @return the file name to be used for lookup in the main bundle.
|
||||
*/
|
||||
+ (NSString*)lookupKeyForAsset:(NSString*)asset fromBundle:(nullable NSBundle*)bundle;
|
||||
|
||||
/**
|
||||
* Returns the file name for the given asset which originates from the specified package.
|
||||
* The returned file name can be used to access the asset in the application's main bundle.
|
||||
*
|
||||
* @param asset The name of the asset. The name can be hierarchical.
|
||||
* @param package The name of the package from which the asset originates.
|
||||
* @return the file name to be used for lookup in the main bundle.
|
||||
*/
|
||||
+ (NSString*)lookupKeyForAsset:(NSString*)asset fromPackage:(NSString*)package;
|
||||
|
||||
/**
|
||||
* Returns the file name for the given asset which originates from the specified package.
|
||||
* The returned file name can be used to access the asset in the specified bundle.
|
||||
*
|
||||
* @param asset The name of the asset. The name can be hierarchical.
|
||||
* @param package The name of the package from which the asset originates.
|
||||
* @param bundle The bundle to use when doing the lookup.
|
||||
* @return the file name to be used for lookup in the main bundle.
|
||||
*/
|
||||
+ (NSString*)lookupKeyForAsset:(NSString*)asset
|
||||
fromPackage:(NSString*)package
|
||||
fromBundle:(nullable NSBundle*)bundle;
|
||||
|
||||
@end
|
||||
|
||||
NS_ASSUME_NONNULL_END
|
||||
|
||||
#endif // FLUTTER_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERDARTPROJECT_H_
|
||||
|
|
@ -0,0 +1,462 @@
|
|||
// 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_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERENGINE_H_
|
||||
#define FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERENGINE_H_
|
||||
|
||||
#import <Foundation/Foundation.h>
|
||||
#import <UIKit/UIKit.h>
|
||||
|
||||
#import "FlutterBinaryMessenger.h"
|
||||
#import "FlutterDartProject.h"
|
||||
#import "FlutterMacros.h"
|
||||
#import "FlutterPlugin.h"
|
||||
#import "FlutterTexture.h"
|
||||
|
||||
@class FlutterViewController;
|
||||
|
||||
NS_ASSUME_NONNULL_BEGIN
|
||||
|
||||
/**
|
||||
* The dart entrypoint that is associated with `main()`. This is to be used as an argument to the
|
||||
* `runWithEntrypoint*` methods.
|
||||
*/
|
||||
// NOLINTNEXTLINE(readability-identifier-naming)
|
||||
extern NSString* const FlutterDefaultDartEntrypoint;
|
||||
|
||||
/**
|
||||
* The default Flutter initial route ("/").
|
||||
*/
|
||||
// NOLINTNEXTLINE(readability-identifier-naming)
|
||||
extern NSString* const FlutterDefaultInitialRoute;
|
||||
|
||||
/**
|
||||
* The FlutterEngine class coordinates a single instance of execution for a
|
||||
* `FlutterDartProject`. It may have zero or one `FlutterViewController` at a
|
||||
* time, which can be specified via `-setViewController:`.
|
||||
* `FlutterViewController`'s `initWithEngine` initializer will automatically call
|
||||
* `-setViewController:` for itself.
|
||||
*
|
||||
* A FlutterEngine can be created independently of a `FlutterViewController` for
|
||||
* headless execution. It can also persist across the lifespan of multiple
|
||||
* `FlutterViewController` instances to maintain state and/or asynchronous tasks
|
||||
* (such as downloading a large file).
|
||||
*
|
||||
* A FlutterEngine can also be used to prewarm the Dart execution environment and reduce the
|
||||
* latency of showing the Flutter screen when a `FlutterViewController` is created and presented.
|
||||
* See http://flutter.dev/docs/development/add-to-app/performance for more details on loading
|
||||
* performance.
|
||||
*
|
||||
* Alternatively, you can simply create a new `FlutterViewController` with only a
|
||||
* `FlutterDartProject`. That `FlutterViewController` will internally manage its
|
||||
* own instance of a FlutterEngine, but will not guarantee survival of the engine
|
||||
* beyond the life of the ViewController.
|
||||
*
|
||||
* A newly initialized FlutterEngine will not actually run a Dart Isolate until
|
||||
* either `-runWithEntrypoint:` or `-runWithEntrypoint:libraryURI` is invoked.
|
||||
* One of these methods must be invoked before calling `-setViewController:`.
|
||||
*/
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
@interface FlutterEngine : NSObject <FlutterPluginRegistry>
|
||||
|
||||
/**
|
||||
* Default initializer for a FlutterEngine.
|
||||
*
|
||||
* Threads created by this FlutterEngine will appear as "FlutterEngine #" in
|
||||
* Instruments. The prefix can be customized using `initWithName`.
|
||||
*
|
||||
* The engine will execute the project located in the bundle with the identifier
|
||||
* "io.flutter.flutter.app" (the default for Flutter projects).
|
||||
*
|
||||
* A newly initialized engine will not run until either `-runWithEntrypoint:` or
|
||||
* `-runWithEntrypoint:libraryURI:` is called.
|
||||
*
|
||||
* FlutterEngine created with this method will have allowHeadlessExecution set to `YES`.
|
||||
* This means that the engine will continue to run regardless of whether a `FlutterViewController`
|
||||
* is attached to it or not, until `-destroyContext:` is called or the process finishes.
|
||||
*/
|
||||
- (instancetype)init;
|
||||
|
||||
/**
|
||||
* Initialize this FlutterEngine.
|
||||
*
|
||||
* The engine will execute the project located in the bundle with the identifier
|
||||
* "io.flutter.flutter.app" (the default for Flutter projects).
|
||||
*
|
||||
* A newly initialized engine will not run until either `-runWithEntrypoint:` or
|
||||
* `-runWithEntrypoint:libraryURI:` is called.
|
||||
*
|
||||
* FlutterEngine created with this method will have allowHeadlessExecution set to `YES`.
|
||||
* This means that the engine will continue to run regardless of whether a `FlutterViewController`
|
||||
* is attached to it or not, until `-destroyContext:` is called or the process finishes.
|
||||
*
|
||||
* @param labelPrefix The label prefix used to identify threads for this instance. Should
|
||||
* be unique across FlutterEngine instances, and is used in instrumentation to label
|
||||
* the threads used by this FlutterEngine.
|
||||
*/
|
||||
- (instancetype)initWithName:(NSString*)labelPrefix;
|
||||
|
||||
/**
|
||||
* Initialize this FlutterEngine with a `FlutterDartProject`.
|
||||
*
|
||||
* If the FlutterDartProject is not specified, the FlutterEngine will attempt to locate
|
||||
* the project in a default location (the flutter_assets folder in the iOS application
|
||||
* bundle).
|
||||
*
|
||||
* A newly initialized engine will not run the `FlutterDartProject` until either
|
||||
* `-runWithEntrypoint:` or `-runWithEntrypoint:libraryURI:` is called.
|
||||
*
|
||||
* FlutterEngine created with this method will have allowHeadlessExecution set to `YES`.
|
||||
* This means that the engine will continue to run regardless of whether a `FlutterViewController`
|
||||
* is attached to it or not, until `-destroyContext:` is called or the process finishes.
|
||||
*
|
||||
* @param labelPrefix The label prefix used to identify threads for this instance. Should
|
||||
* be unique across FlutterEngine instances, and is used in instrumentation to label
|
||||
* the threads used by this FlutterEngine.
|
||||
* @param project The `FlutterDartProject` to run.
|
||||
*/
|
||||
- (instancetype)initWithName:(NSString*)labelPrefix project:(nullable FlutterDartProject*)project;
|
||||
|
||||
/**
|
||||
* Initialize this FlutterEngine with a `FlutterDartProject`.
|
||||
*
|
||||
* If the FlutterDartProject is not specified, the FlutterEngine will attempt to locate
|
||||
* the project in a default location (the flutter_assets folder in the iOS application
|
||||
* bundle).
|
||||
*
|
||||
* A newly initialized engine will not run the `FlutterDartProject` until either
|
||||
* `-runWithEntrypoint:` or `-runWithEntrypoint:libraryURI:` is called.
|
||||
*
|
||||
* @param labelPrefix The label prefix used to identify threads for this instance. Should
|
||||
* be unique across FlutterEngine instances, and is used in instrumentation to label
|
||||
* the threads used by this FlutterEngine.
|
||||
* @param project The `FlutterDartProject` to run.
|
||||
* @param allowHeadlessExecution Whether or not to allow this instance to continue
|
||||
* running after passing a nil `FlutterViewController` to `-setViewController:`.
|
||||
*/
|
||||
- (instancetype)initWithName:(NSString*)labelPrefix
|
||||
project:(nullable FlutterDartProject*)project
|
||||
allowHeadlessExecution:(BOOL)allowHeadlessExecution;
|
||||
|
||||
/**
|
||||
* Initialize this FlutterEngine with a `FlutterDartProject`.
|
||||
*
|
||||
* If the FlutterDartProject is not specified, the FlutterEngine will attempt to locate
|
||||
* the project in a default location (the flutter_assets folder in the iOS application
|
||||
* bundle).
|
||||
*
|
||||
* A newly initialized engine will not run the `FlutterDartProject` until either
|
||||
* `-runWithEntrypoint:` or `-runWithEntrypoint:libraryURI:` is called.
|
||||
*
|
||||
* @param labelPrefix The label prefix used to identify threads for this instance. Should
|
||||
* be unique across FlutterEngine instances, and is used in instrumentation to label
|
||||
* the threads used by this FlutterEngine.
|
||||
* @param project The `FlutterDartProject` to run.
|
||||
* @param allowHeadlessExecution Whether or not to allow this instance to continue
|
||||
* running after passing a nil `FlutterViewController` to `-setViewController:`.
|
||||
* @param restorationEnabled Whether state restoration is enabled. When true, the framework will
|
||||
* wait for the attached view controller to provide restoration data.
|
||||
*/
|
||||
- (instancetype)initWithName:(NSString*)labelPrefix
|
||||
project:(nullable FlutterDartProject*)project
|
||||
allowHeadlessExecution:(BOOL)allowHeadlessExecution
|
||||
restorationEnabled:(BOOL)restorationEnabled NS_DESIGNATED_INITIALIZER;
|
||||
|
||||
/**
|
||||
* Runs a Dart program on an Isolate from the main Dart library (i.e. the library that
|
||||
* contains `main()`), using `main()` as the entrypoint (the default for Flutter projects),
|
||||
* and using "/" (the default route) as the initial route.
|
||||
*
|
||||
* The first call to this method will create a new Isolate. Subsequent calls will return
|
||||
* immediately and have no effect.
|
||||
*
|
||||
* @return YES if the call succeeds in creating and running a Flutter Engine instance; NO otherwise.
|
||||
*/
|
||||
- (BOOL)run;
|
||||
|
||||
/**
|
||||
* Runs a Dart program on an Isolate from the main Dart library (i.e. the library that
|
||||
* contains `main()`), using "/" (the default route) as the initial route.
|
||||
*
|
||||
* The first call to this method will create a new Isolate. Subsequent calls will return
|
||||
* immediately and have no effect.
|
||||
*
|
||||
* @param entrypoint The name of a top-level function from the same Dart
|
||||
* library that contains the app's main() function. If this is FlutterDefaultDartEntrypoint (or
|
||||
* nil) it will default to `main()`. If it is not the app's main() function, that function must
|
||||
* be decorated with `@pragma(vm:entry-point)` to ensure the method is not tree-shaken by the Dart
|
||||
* compiler.
|
||||
* @return YES if the call succeeds in creating and running a Flutter Engine instance; NO otherwise.
|
||||
*/
|
||||
- (BOOL)runWithEntrypoint:(nullable NSString*)entrypoint;
|
||||
|
||||
/**
|
||||
* Runs a Dart program on an Isolate from the main Dart library (i.e. the library that
|
||||
* contains `main()`).
|
||||
*
|
||||
* The first call to this method will create a new Isolate. Subsequent calls will return
|
||||
* immediately and have no effect.
|
||||
*
|
||||
* @param entrypoint The name of a top-level function from the same Dart
|
||||
* library that contains the app's main() function. If this is FlutterDefaultDartEntrypoint (or
|
||||
* nil), it will default to `main()`. If it is not the app's main() function, that function must
|
||||
* be decorated with `@pragma(vm:entry-point)` to ensure the method is not tree-shaken by the Dart
|
||||
* compiler.
|
||||
* @param initialRoute The name of the initial Flutter `Navigator` `Route` to load. If this is
|
||||
* FlutterDefaultInitialRoute (or nil), it will default to the "/" route.
|
||||
* @return YES if the call succeeds in creating and running a Flutter Engine instance; NO otherwise.
|
||||
*/
|
||||
- (BOOL)runWithEntrypoint:(nullable NSString*)entrypoint
|
||||
initialRoute:(nullable NSString*)initialRoute;
|
||||
|
||||
/**
|
||||
* Runs a Dart program on an Isolate using the specified entrypoint and Dart library,
|
||||
* which may not be the same as the library containing the Dart program's `main()` function.
|
||||
*
|
||||
* The first call to this method will create a new Isolate. Subsequent calls will return
|
||||
* immediately and have no effect.
|
||||
*
|
||||
* @param entrypoint The name of a top-level function from a Dart library. If this is
|
||||
* FlutterDefaultDartEntrypoint (or nil); this will default to `main()`. If it is not the app's
|
||||
* main() function, that function must be decorated with `@pragma(vm:entry-point)` to ensure the
|
||||
* method is not tree-shaken by the Dart compiler.
|
||||
* @param uri The URI of the Dart library which contains the entrypoint method
|
||||
* (example "package:foo_package/main.dart"). If nil, this will default to
|
||||
* the same library as the `main()` function in the Dart program.
|
||||
* @return YES if the call succeeds in creating and running a Flutter Engine instance; NO otherwise.
|
||||
*/
|
||||
- (BOOL)runWithEntrypoint:(nullable NSString*)entrypoint libraryURI:(nullable NSString*)uri;
|
||||
|
||||
/**
|
||||
* Runs a Dart program on an Isolate using the specified entrypoint and Dart library,
|
||||
* which may not be the same as the library containing the Dart program's `main()` function.
|
||||
*
|
||||
* The first call to this method will create a new Isolate. Subsequent calls will return
|
||||
* immediately and have no effect.
|
||||
*
|
||||
* @param entrypoint The name of a top-level function from a Dart library. If this is
|
||||
* FlutterDefaultDartEntrypoint (or nil); this will default to `main()`. If it is not the app's
|
||||
* main() function, that function must be decorated with `@pragma(vm:entry-point)` to ensure the
|
||||
* method is not tree-shaken by the Dart compiler.
|
||||
* @param libraryURI The URI of the Dart library which contains the entrypoint
|
||||
* method (example "package:foo_package/main.dart"). If nil, this will
|
||||
* default to the same library as the `main()` function in the Dart program.
|
||||
* @param initialRoute The name of the initial Flutter `Navigator` `Route` to load. If this is
|
||||
* FlutterDefaultInitialRoute (or nil), it will default to the "/" route.
|
||||
* @return YES if the call succeeds in creating and running a Flutter Engine instance; NO otherwise.
|
||||
*/
|
||||
- (BOOL)runWithEntrypoint:(nullable NSString*)entrypoint
|
||||
libraryURI:(nullable NSString*)libraryURI
|
||||
initialRoute:(nullable NSString*)initialRoute;
|
||||
|
||||
/**
|
||||
* Runs a Dart program on an Isolate using the specified entrypoint and Dart library,
|
||||
* which may not be the same as the library containing the Dart program's `main()` function.
|
||||
*
|
||||
* The first call to this method will create a new Isolate. Subsequent calls will return
|
||||
* immediately and have no effect.
|
||||
*
|
||||
* @param entrypoint The name of a top-level function from a Dart library. If this is
|
||||
* FlutterDefaultDartEntrypoint (or nil); this will default to `main()`. If it is not the app's
|
||||
* main() function, that function must be decorated with `@pragma(vm:entry-point)` to ensure the
|
||||
* method is not tree-shaken by the Dart compiler.
|
||||
* @param libraryURI The URI of the Dart library which contains the entrypoint
|
||||
* method (example "package:foo_package/main.dart"). If nil, this will
|
||||
* default to the same library as the `main()` function in the Dart program.
|
||||
* @param initialRoute The name of the initial Flutter `Navigator` `Route` to load. If this is
|
||||
* FlutterDefaultInitialRoute (or nil), it will default to the "/" route.
|
||||
* @param entrypointArgs Arguments passed as a list of string to Dart's entrypoint function.
|
||||
* @return YES if the call succeeds in creating and running a Flutter Engine instance; NO otherwise.
|
||||
*/
|
||||
- (BOOL)runWithEntrypoint:(nullable NSString*)entrypoint
|
||||
libraryURI:(nullable NSString*)libraryURI
|
||||
initialRoute:(nullable NSString*)initialRoute
|
||||
entrypointArgs:(nullable NSArray<NSString*>*)entrypointArgs;
|
||||
|
||||
/**
|
||||
* Destroy running context for an engine.
|
||||
*
|
||||
* This method can be used to force the FlutterEngine object to release all resources.
|
||||
* After sending this message, the object will be in an unusable state until it is deallocated.
|
||||
* Accessing properties or sending messages to it will result in undefined behavior or runtime
|
||||
* errors.
|
||||
*/
|
||||
- (void)destroyContext;
|
||||
|
||||
/**
|
||||
* Ensures that Flutter will generate a semantics tree.
|
||||
*
|
||||
* This is enabled by default if certain accessibility services are turned on by
|
||||
* the user, or when using a Simulator. This method allows a user to turn
|
||||
* semantics on when they would not ordinarily be generated and the performance
|
||||
* overhead is not a concern, e.g. for UI testing. Note that semantics should
|
||||
* never be programmatically turned off, as it would potentially disable
|
||||
* accessibility services an end user has requested.
|
||||
*
|
||||
* This method must only be called after launching the engine via
|
||||
* `-runWithEntrypoint:` or `-runWithEntryPoint:libraryURI`.
|
||||
*
|
||||
* Although this method returns synchronously, it does not guarantee that a
|
||||
* semantics tree is actually available when the method returns. It
|
||||
* synchronously ensures that the next frame the Flutter framework creates will
|
||||
* have a semantics tree.
|
||||
*
|
||||
* You can subscribe to semantics updates via `NSNotificationCenter` by adding
|
||||
* an observer for the name `FlutterSemanticsUpdateNotification`. The `object`
|
||||
* parameter will be the `FlutterViewController` associated with the semantics
|
||||
* update. This will asynchronously fire after a semantics tree has actually
|
||||
* built (which may be some time after the frame has been rendered).
|
||||
*/
|
||||
- (void)ensureSemanticsEnabled;
|
||||
|
||||
/**
|
||||
* Sets the `FlutterViewController` for this instance. The FlutterEngine must be
|
||||
* running (e.g. a successful call to `-runWithEntrypoint:` or `-runWithEntrypoint:libraryURI`)
|
||||
* before calling this method. Callers may pass nil to remove the viewController
|
||||
* and have the engine run headless in the current process.
|
||||
*
|
||||
* A FlutterEngine can only have one `FlutterViewController` at a time. If there is
|
||||
* already a `FlutterViewController` associated with this instance, this method will replace
|
||||
* the engine's current viewController with the newly specified one.
|
||||
*
|
||||
* Setting the viewController will signal the engine to start animations and drawing, and unsetting
|
||||
* it will signal the engine to stop animations and drawing. However, neither will impact the state
|
||||
* of the Dart program's execution.
|
||||
*/
|
||||
@property(nonatomic, weak) FlutterViewController* viewController;
|
||||
|
||||
/**
|
||||
* The `FlutterMethodChannel` used for localization related platform messages, such as
|
||||
* setting the locale.
|
||||
*
|
||||
* Can be nil after `destroyContext` is called.
|
||||
*/
|
||||
@property(nonatomic, readonly, nullable) FlutterMethodChannel* localizationChannel;
|
||||
/**
|
||||
* The `FlutterMethodChannel` used for navigation related platform messages.
|
||||
*
|
||||
* Can be nil after `destroyContext` is called.
|
||||
*
|
||||
* @see [Navigation
|
||||
* Channel](https://api.flutter.dev/flutter/services/SystemChannels/navigation-constant.html)
|
||||
* @see [Navigator Widget](https://api.flutter.dev/flutter/widgets/Navigator-class.html)
|
||||
*/
|
||||
@property(nonatomic, readonly) FlutterMethodChannel* navigationChannel;
|
||||
|
||||
/**
|
||||
* The `FlutterMethodChannel` used for restoration related platform messages.
|
||||
*
|
||||
* Can be nil after `destroyContext` is called.
|
||||
*
|
||||
* @see [Restoration
|
||||
* Channel](https://api.flutter.dev/flutter/services/SystemChannels/restoration-constant.html)
|
||||
*/
|
||||
@property(nonatomic, readonly) FlutterMethodChannel* restorationChannel;
|
||||
|
||||
/**
|
||||
* The `FlutterMethodChannel` used for core platform messages, such as
|
||||
* information about the screen orientation.
|
||||
*
|
||||
* Can be nil after `destroyContext` is called.
|
||||
*/
|
||||
@property(nonatomic, readonly) FlutterMethodChannel* platformChannel;
|
||||
|
||||
/**
|
||||
* The `FlutterMethodChannel` used to communicate text input events to the
|
||||
* Dart Isolate.
|
||||
*
|
||||
* Can be nil after `destroyContext` is called.
|
||||
*
|
||||
* @see [Text Input
|
||||
* Channel](https://api.flutter.dev/flutter/services/SystemChannels/textInput-constant.html)
|
||||
*/
|
||||
@property(nonatomic, readonly) FlutterMethodChannel* textInputChannel;
|
||||
|
||||
/**
|
||||
* The `FlutterBasicMessageChannel` used to communicate app lifecycle events
|
||||
* to the Dart Isolate.
|
||||
*
|
||||
* Can be nil after `destroyContext` is called.
|
||||
*
|
||||
* @see [Lifecycle
|
||||
* Channel](https://api.flutter.dev/flutter/services/SystemChannels/lifecycle-constant.html)
|
||||
*/
|
||||
@property(nonatomic, readonly) FlutterBasicMessageChannel* lifecycleChannel;
|
||||
|
||||
/**
|
||||
* The `FlutterBasicMessageChannel` used for communicating system events, such as
|
||||
* memory pressure events.
|
||||
*
|
||||
* Can be nil after `destroyContext` is called.
|
||||
*
|
||||
* @see [System
|
||||
* Channel](https://api.flutter.dev/flutter/services/SystemChannels/system-constant.html)
|
||||
*/
|
||||
@property(nonatomic, readonly) FlutterBasicMessageChannel* systemChannel;
|
||||
|
||||
/**
|
||||
* The `FlutterBasicMessageChannel` used for communicating user settings such as
|
||||
* clock format and text scale.
|
||||
*
|
||||
* Can be nil after `destroyContext` is called.
|
||||
*/
|
||||
@property(nonatomic, readonly) FlutterBasicMessageChannel* settingsChannel;
|
||||
|
||||
/**
|
||||
* The `FlutterBasicMessageChannel` used for communicating key events
|
||||
* from physical keyboards
|
||||
*
|
||||
* Can be nil after `destroyContext` is called.
|
||||
*/
|
||||
@property(nonatomic, readonly) FlutterBasicMessageChannel* keyEventChannel;
|
||||
|
||||
/**
|
||||
* The depcreated `NSURL` of the Dart VM Service for the service isolate.
|
||||
*
|
||||
* This is only set in debug and profile runtime modes, and only after the
|
||||
* Dart VM Service is ready. In release mode or before the Dart VM Service has
|
||||
* started, it returns `nil`.
|
||||
*/
|
||||
@property(nonatomic, readonly, nullable)
|
||||
NSURL* observatoryUrl FLUTTER_DEPRECATED("Use vmServiceUrl instead");
|
||||
|
||||
/**
|
||||
* The `NSURL` of the Dart VM Service for the service isolate.
|
||||
*
|
||||
* This is only set in debug and profile runtime modes, and only after the
|
||||
* Dart VM Service is ready. In release mode or before the Dart VM Service has
|
||||
* started, it returns `nil`.
|
||||
*/
|
||||
@property(nonatomic, readonly, nullable) NSURL* vmServiceUrl;
|
||||
|
||||
/**
|
||||
* The `FlutterBinaryMessenger` associated with this FlutterEngine (used for communicating with
|
||||
* channels).
|
||||
*/
|
||||
@property(nonatomic, readonly) NSObject<FlutterBinaryMessenger>* binaryMessenger;
|
||||
|
||||
/**
|
||||
* The `FlutterTextureRegistry` associated with this FlutterEngine (used to register textures).
|
||||
*/
|
||||
@property(nonatomic, readonly) NSObject<FlutterTextureRegistry>* textureRegistry;
|
||||
|
||||
/**
|
||||
* The UI Isolate ID of the engine.
|
||||
*
|
||||
* This property will be nil if the engine is not running.
|
||||
*/
|
||||
@property(nonatomic, readonly, copy, nullable) NSString* isolateId;
|
||||
|
||||
/**
|
||||
* Whether or not GPU calls are allowed.
|
||||
*
|
||||
* Typically this is set when the app is backgrounded and foregrounded.
|
||||
*/
|
||||
@property(nonatomic, assign) BOOL isGpuDisabled;
|
||||
|
||||
@end
|
||||
|
||||
NS_ASSUME_NONNULL_END
|
||||
|
||||
#endif // FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERENGINE_H_
|
||||
|
|
@ -0,0 +1,110 @@
|
|||
// 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>
|
||||
|
||||
#import "FlutterEngine.h"
|
||||
|
||||
NS_ASSUME_NONNULL_BEGIN
|
||||
|
||||
/** Options that control how a FlutterEngine should be created. */
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
@interface FlutterEngineGroupOptions : NSObject
|
||||
|
||||
/**
|
||||
* The name of a top-level function from a Dart library. If this is FlutterDefaultDartEntrypoint
|
||||
* (or nil); this will default to `main()`. If it is not the app's main() function, that function
|
||||
* must be decorated with `@pragma(vm:entry-point)` to ensure themethod is not tree-shaken by the
|
||||
* Dart compiler.
|
||||
*/
|
||||
@property(nonatomic, copy, nullable) NSString* entrypoint;
|
||||
|
||||
/**
|
||||
* The URI of the Dart library which contains the entrypoint method. If nil, this will default to
|
||||
* the same library as the `main()` function in the Dart program.
|
||||
*/
|
||||
@property(nonatomic, copy, nullable) NSString* libraryURI;
|
||||
|
||||
/**
|
||||
* The name of the initial Flutter `Navigator` `Route` to load. If this is
|
||||
* FlutterDefaultInitialRoute (or nil), it will default to the "/" route.
|
||||
*/
|
||||
@property(nonatomic, copy, nullable) NSString* initialRoute;
|
||||
|
||||
/**
|
||||
* Arguments passed as a list of string to Dart's entrypoint function.
|
||||
*/
|
||||
@property(nonatomic, retain, nullable) NSArray<NSString*>* entrypointArgs;
|
||||
@end
|
||||
|
||||
/**
|
||||
* Represents a collection of FlutterEngines who share resources which allows
|
||||
* them to be created with less time const and occupy less memory than just
|
||||
* creating multiple FlutterEngines.
|
||||
*
|
||||
* Deleting a FlutterEngineGroup doesn't invalidate existing FlutterEngines, but
|
||||
* it eliminates the possibility to create more FlutterEngines in that group.
|
||||
*
|
||||
* @warning This class is a work-in-progress and may change.
|
||||
* @see https://github.com/flutter/flutter/issues/72009
|
||||
*/
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
@interface FlutterEngineGroup : NSObject
|
||||
- (instancetype)init NS_UNAVAILABLE;
|
||||
|
||||
/**
|
||||
* Initialize a new FlutterEngineGroup.
|
||||
*
|
||||
* @param name The name that will present in the threads shared across the
|
||||
* engines in this group.
|
||||
* @param project The `FlutterDartProject` that all FlutterEngines in this group
|
||||
* will be executing.
|
||||
*/
|
||||
- (instancetype)initWithName:(NSString*)name
|
||||
project:(nullable FlutterDartProject*)project NS_DESIGNATED_INITIALIZER;
|
||||
|
||||
/**
|
||||
* Creates a running `FlutterEngine` that shares components with this group.
|
||||
*
|
||||
* @param entrypoint The name of a top-level function from a Dart library. If this is
|
||||
* FlutterDefaultDartEntrypoint (or nil); this will default to `main()`. If it is not the app's
|
||||
* main() function, that function must be decorated with `@pragma(vm:entry-point)` to ensure the
|
||||
* method is not tree-shaken by the Dart compiler.
|
||||
* @param libraryURI The URI of the Dart library which contains the entrypoint method. IF nil,
|
||||
* this will default to the same library as the `main()` function in the Dart program.
|
||||
*
|
||||
* @see FlutterEngineGroup
|
||||
*/
|
||||
- (FlutterEngine*)makeEngineWithEntrypoint:(nullable NSString*)entrypoint
|
||||
libraryURI:(nullable NSString*)libraryURI;
|
||||
|
||||
/**
|
||||
* Creates a running `FlutterEngine` that shares components with this group.
|
||||
*
|
||||
* @param entrypoint The name of a top-level function from a Dart library. If this is
|
||||
* FlutterDefaultDartEntrypoint (or nil); this will default to `main()`. If it is not the app's
|
||||
* main() function, that function must be decorated with `@pragma(vm:entry-point)` to ensure the
|
||||
* method is not tree-shaken by the Dart compiler.
|
||||
* @param libraryURI The URI of the Dart library which contains the entrypoint method. IF nil,
|
||||
* this will default to the same library as the `main()` function in the Dart program.
|
||||
* @param initialRoute The name of the initial Flutter `Navigator` `Route` to load. If this is
|
||||
* FlutterDefaultInitialRoute (or nil), it will default to the "/" route.
|
||||
*
|
||||
* @see FlutterEngineGroup
|
||||
*/
|
||||
- (FlutterEngine*)makeEngineWithEntrypoint:(nullable NSString*)entrypoint
|
||||
libraryURI:(nullable NSString*)libraryURI
|
||||
initialRoute:(nullable NSString*)initialRoute;
|
||||
|
||||
/**
|
||||
* Creates a running `FlutterEngine` that shares components with this group.
|
||||
*
|
||||
* @param options Options that control how a FlutterEngine should be created.
|
||||
*
|
||||
* @see FlutterEngineGroupOptions
|
||||
*/
|
||||
- (FlutterEngine*)makeEngineWithOptions:(nullable FlutterEngineGroupOptions*)options;
|
||||
@end
|
||||
|
||||
NS_ASSUME_NONNULL_END
|
||||
|
|
@ -0,0 +1,97 @@
|
|||
// 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_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERHEADLESSDARTRUNNER_H_
|
||||
#define FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERHEADLESSDARTRUNNER_H_
|
||||
|
||||
#import <Foundation/Foundation.h>
|
||||
|
||||
#import "FlutterBinaryMessenger.h"
|
||||
#import "FlutterDartProject.h"
|
||||
#import "FlutterEngine.h"
|
||||
#import "FlutterMacros.h"
|
||||
|
||||
/**
|
||||
* A callback for when FlutterHeadlessDartRunner has attempted to start a Dart
|
||||
* Isolate in the background.
|
||||
*
|
||||
* @param success YES if the Isolate was started and run successfully, NO
|
||||
* otherwise.
|
||||
*/
|
||||
typedef void (^FlutterHeadlessDartRunnerCallback)(BOOL success);
|
||||
|
||||
/**
|
||||
* The deprecated FlutterHeadlessDartRunner runs Flutter Dart code with a null rasterizer,
|
||||
* and no native drawing surface. It is appropriate for use in running Dart
|
||||
* code e.g. in the background from a plugin.
|
||||
*
|
||||
* Most callers should prefer using `FlutterEngine` directly; this interface exists
|
||||
* for legacy support.
|
||||
*/
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
FLUTTER_DEPRECATED("FlutterEngine should be used rather than FlutterHeadlessDartRunner")
|
||||
@interface FlutterHeadlessDartRunner : FlutterEngine
|
||||
|
||||
/**
|
||||
* Initialize this FlutterHeadlessDartRunner with a `FlutterDartProject`.
|
||||
*
|
||||
* If the FlutterDartProject is not specified, the FlutterHeadlessDartRunner will attempt to locate
|
||||
* the project in a default location.
|
||||
*
|
||||
* A newly initialized engine will not run the `FlutterDartProject` until either
|
||||
* `-runWithEntrypoint:` or `-runWithEntrypoint:libraryURI` is called.
|
||||
*
|
||||
* @param labelPrefix The label prefix used to identify threads for this instance. Should
|
||||
* be unique across FlutterEngine instances
|
||||
* @param projectOrNil The `FlutterDartProject` to run.
|
||||
*/
|
||||
- (instancetype)initWithName:(NSString*)labelPrefix project:(FlutterDartProject*)projectOrNil;
|
||||
|
||||
/**
|
||||
* Initialize this FlutterHeadlessDartRunner with a `FlutterDartProject`.
|
||||
*
|
||||
* If the FlutterDartProject is not specified, the FlutterHeadlessDartRunner will attempt to locate
|
||||
* the project in a default location.
|
||||
*
|
||||
* A newly initialized engine will not run the `FlutterDartProject` until either
|
||||
* `-runWithEntrypoint:` or `-runWithEntrypoint:libraryURI` is called.
|
||||
*
|
||||
* @param labelPrefix The label prefix used to identify threads for this instance. Should
|
||||
* be unique across FlutterEngine instances
|
||||
* @param projectOrNil The `FlutterDartProject` to run.
|
||||
* @param allowHeadlessExecution Must be set to `YES`.
|
||||
*/
|
||||
- (instancetype)initWithName:(NSString*)labelPrefix
|
||||
project:(FlutterDartProject*)projectOrNil
|
||||
allowHeadlessExecution:(BOOL)allowHeadlessExecution;
|
||||
|
||||
/**
|
||||
* Initialize this FlutterHeadlessDartRunner with a `FlutterDartProject`.
|
||||
*
|
||||
* If the FlutterDartProject is not specified, the FlutterHeadlessDartRunner will attempt to locate
|
||||
* the project in a default location.
|
||||
*
|
||||
* A newly initialized engine will not run the `FlutterDartProject` until either
|
||||
* `-runWithEntrypoint:` or `-runWithEntrypoint:libraryURI` is called.
|
||||
*
|
||||
* @param labelPrefix The label prefix used to identify threads for this instance. Should
|
||||
* be unique across FlutterEngine instances
|
||||
* @param projectOrNil The `FlutterDartProject` to run.
|
||||
* @param allowHeadlessExecution Must be set to `YES`.
|
||||
* @param restorationEnabled Must be set to `NO`.
|
||||
*/
|
||||
- (instancetype)initWithName:(NSString*)labelPrefix
|
||||
project:(FlutterDartProject*)projectOrNil
|
||||
allowHeadlessExecution:(BOOL)allowHeadlessExecution
|
||||
restorationEnabled:(BOOL)restorationEnabled NS_DESIGNATED_INITIALIZER;
|
||||
|
||||
/**
|
||||
* Not recommended for use - will initialize with a default label ("io.flutter.headless")
|
||||
* and the default FlutterDartProject.
|
||||
*/
|
||||
- (instancetype)init;
|
||||
|
||||
@end
|
||||
|
||||
#endif // FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERHEADLESSDARTRUNNER_H_
|
||||
|
|
@ -0,0 +1,48 @@
|
|||
// 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_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERMACROS_H_
|
||||
#define FLUTTER_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERMACROS_H_
|
||||
|
||||
#if defined(FLUTTER_FRAMEWORK)
|
||||
|
||||
#define FLUTTER_DARWIN_EXPORT __attribute__((visibility("default")))
|
||||
|
||||
#else // defined(FLUTTER_SDK)
|
||||
|
||||
#define FLUTTER_DARWIN_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)))
|
||||
|
||||
#if __has_feature(objc_arc)
|
||||
#define FLUTTER_ASSERT_ARC
|
||||
#define FLUTTER_ASSERT_NOT_ARC #error ARC must be disabled !
|
||||
#else
|
||||
#define FLUTTER_ASSERT_ARC #error ARC must be enabled !
|
||||
#define FLUTTER_ASSERT_NOT_ARC
|
||||
#endif
|
||||
|
||||
#endif // FLUTTER_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERMACROS_H_
|
||||
|
|
@ -0,0 +1,56 @@
|
|||
// 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_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERPLATFORMVIEWS_H_
|
||||
#define FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERPLATFORMVIEWS_H_
|
||||
|
||||
#import <UIKit/UIKit.h>
|
||||
|
||||
#import "FlutterCodecs.h"
|
||||
#import "FlutterMacros.h"
|
||||
|
||||
NS_ASSUME_NONNULL_BEGIN
|
||||
|
||||
/**
|
||||
* Wraps a `UIView` for embedding in the Flutter hierarchy
|
||||
*/
|
||||
@protocol FlutterPlatformView <NSObject>
|
||||
/**
|
||||
* Returns a reference to the `UIView` that is wrapped by this `FlutterPlatformView`.
|
||||
*/
|
||||
- (UIView*)view;
|
||||
@end
|
||||
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
@protocol FlutterPlatformViewFactory <NSObject>
|
||||
/**
|
||||
* Create a `FlutterPlatformView`.
|
||||
*
|
||||
* Implemented by iOS code that expose a `UIView` for embedding in a Flutter app.
|
||||
*
|
||||
* The implementation of this method should create a new `UIView` and return it.
|
||||
*
|
||||
* @param frame The rectangle for the newly created `UIView` measured in points.
|
||||
* @param viewId A unique identifier for this `UIView`.
|
||||
* @param args Parameters for creating the `UIView` sent from the Dart side of the Flutter app.
|
||||
* If `createArgsCodec` is not implemented, or if no creation arguments were sent from the Dart
|
||||
* code, this will be null. Otherwise this will be the value sent from the Dart code as decoded by
|
||||
* `createArgsCodec`.
|
||||
*/
|
||||
- (NSObject<FlutterPlatformView>*)createWithFrame:(CGRect)frame
|
||||
viewIdentifier:(int64_t)viewId
|
||||
arguments:(id _Nullable)args;
|
||||
|
||||
/**
|
||||
* Returns the `FlutterMessageCodec` for decoding the args parameter of `createWithFrame`.
|
||||
*
|
||||
* Only needs to be implemented if `createWithFrame` needs an arguments parameter.
|
||||
*/
|
||||
@optional
|
||||
- (NSObject<FlutterMessageCodec>*)createArgsCodec;
|
||||
@end
|
||||
|
||||
NS_ASSUME_NONNULL_END
|
||||
|
||||
#endif // FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERPLATFORMVIEWS_H_
|
||||
|
|
@ -0,0 +1,448 @@
|
|||
// 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_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERPLUGIN_H_
|
||||
#define FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERPLUGIN_H_
|
||||
|
||||
#import <UIKit/UIKit.h>
|
||||
#import <UserNotifications/UNUserNotificationCenter.h>
|
||||
|
||||
#import "FlutterBinaryMessenger.h"
|
||||
#import "FlutterChannels.h"
|
||||
#import "FlutterCodecs.h"
|
||||
#import "FlutterPlatformViews.h"
|
||||
#import "FlutterTexture.h"
|
||||
|
||||
NS_ASSUME_NONNULL_BEGIN
|
||||
@protocol FlutterPluginRegistrar;
|
||||
@protocol FlutterPluginRegistry;
|
||||
|
||||
#pragma mark -
|
||||
/**
|
||||
* Protocol for listener of events from the UIApplication, typically a FlutterPlugin.
|
||||
*/
|
||||
@protocol FlutterApplicationLifeCycleDelegate <UNUserNotificationCenterDelegate>
|
||||
|
||||
@optional
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*
|
||||
* @return `NO` if this vetos application launch.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
didFinishLaunchingWithOptions:(NSDictionary*)launchOptions;
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*
|
||||
* @return `NO` if this vetos application launch.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
willFinishLaunchingWithOptions:(NSDictionary*)launchOptions;
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*/
|
||||
- (void)applicationDidBecomeActive:(UIApplication*)application;
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*/
|
||||
- (void)applicationWillResignActive:(UIApplication*)application;
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*/
|
||||
- (void)applicationDidEnterBackground:(UIApplication*)application;
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*/
|
||||
- (void)applicationWillEnterForeground:(UIApplication*)application;
|
||||
|
||||
/**
|
||||
Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*/
|
||||
- (void)applicationWillTerminate:(UIApplication*)application;
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*/
|
||||
- (void)application:(UIApplication*)application
|
||||
didRegisterUserNotificationSettings:(UIUserNotificationSettings*)notificationSettings
|
||||
API_DEPRECATED(
|
||||
"See -[UIApplicationDelegate application:didRegisterUserNotificationSettings:] deprecation",
|
||||
ios(8.0, 10.0));
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*/
|
||||
- (void)application:(UIApplication*)application
|
||||
didRegisterForRemoteNotificationsWithDeviceToken:(NSData*)deviceToken;
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*/
|
||||
- (void)application:(UIApplication*)application
|
||||
didFailToRegisterForRemoteNotificationsWithError:(NSError*)error;
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*
|
||||
* @return `YES` if this handles the request.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
didReceiveRemoteNotification:(NSDictionary*)userInfo
|
||||
fetchCompletionHandler:(void (^)(UIBackgroundFetchResult result))completionHandler;
|
||||
|
||||
/**
|
||||
* Calls all plugins registered for `UIApplicationDelegate` callbacks.
|
||||
*/
|
||||
- (void)application:(UIApplication*)application
|
||||
didReceiveLocalNotification:(UILocalNotification*)notification
|
||||
API_DEPRECATED(
|
||||
"See -[UIApplicationDelegate application:didReceiveLocalNotification:] deprecation",
|
||||
ios(4.0, 10.0));
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*
|
||||
* @return `YES` if this handles the request.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
openURL:(NSURL*)url
|
||||
options:(NSDictionary<UIApplicationOpenURLOptionsKey, id>*)options;
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*
|
||||
* @return `YES` if this handles the request.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application handleOpenURL:(NSURL*)url;
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*
|
||||
* @return `YES` if this handles the request.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
openURL:(NSURL*)url
|
||||
sourceApplication:(NSString*)sourceApplication
|
||||
annotation:(id)annotation;
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*
|
||||
* @return `YES` if this handles the request.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
performActionForShortcutItem:(UIApplicationShortcutItem*)shortcutItem
|
||||
completionHandler:(void (^)(BOOL succeeded))completionHandler
|
||||
API_AVAILABLE(ios(9.0));
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*
|
||||
* @return `YES` if this handles the request.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
handleEventsForBackgroundURLSession:(nonnull NSString*)identifier
|
||||
completionHandler:(nonnull void (^)(void))completionHandler;
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*
|
||||
* @return `YES` if this handles the request.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
performFetchWithCompletionHandler:(void (^)(UIBackgroundFetchResult result))completionHandler;
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*
|
||||
* @return `YES` if this handles the request.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
continueUserActivity:(NSUserActivity*)userActivity
|
||||
restorationHandler:(void (^)(NSArray*))restorationHandler;
|
||||
@end
|
||||
|
||||
#pragma mark -
|
||||
/**
|
||||
* A plugin registration callback.
|
||||
*
|
||||
* Used for registering plugins with additional instances of
|
||||
* `FlutterPluginRegistry`.
|
||||
*
|
||||
* @param registry The registry to register plugins with.
|
||||
*/
|
||||
typedef void (*FlutterPluginRegistrantCallback)(NSObject<FlutterPluginRegistry>* registry);
|
||||
|
||||
#pragma mark -
|
||||
/**
|
||||
* Implemented by the iOS part 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.
|
||||
*/
|
||||
@protocol FlutterPlugin <NSObject, FlutterApplicationLifeCycleDelegate>
|
||||
@required
|
||||
/**
|
||||
* Registers this plugin using the context information and callback registration
|
||||
* methods exposed by the given registrar.
|
||||
*
|
||||
* The registrar is obtained from a `FlutterPluginRegistry` which keeps track of
|
||||
* the identity of registered plugins and provides basic support for cross-plugin
|
||||
* coordination.
|
||||
*
|
||||
* The caller of this method, a plugin registrant, is usually autogenerated by
|
||||
* Flutter tooling based on declared plugin dependencies. The generated registrant
|
||||
* asks the registry for a registrar for each plugin, and calls this method to
|
||||
* allow the plugin to initialize itself and register callbacks with application
|
||||
* objects available through the registrar protocol.
|
||||
*
|
||||
* @param registrar A helper providing application context and methods for
|
||||
* registering callbacks.
|
||||
*/
|
||||
+ (void)registerWithRegistrar:(NSObject<FlutterPluginRegistrar>*)registrar;
|
||||
@optional
|
||||
/**
|
||||
* Set a callback for registering plugins to an additional `FlutterPluginRegistry`,
|
||||
* including headless `FlutterEngine` instances.
|
||||
*
|
||||
* This method is typically called from within an application's `AppDelegate` at
|
||||
* startup to allow for plugins which create additional `FlutterEngine` instances
|
||||
* to register the application's plugins.
|
||||
*
|
||||
* @param callback A callback for registering some set of plugins with a
|
||||
* `FlutterPluginRegistry`.
|
||||
*/
|
||||
+ (void)setPluginRegistrantCallback:(FlutterPluginRegistrantCallback)callback;
|
||||
@optional
|
||||
/**
|
||||
* Called if this plugin has been registered to receive `FlutterMethodCall`s.
|
||||
*
|
||||
* @param call The method call command object.
|
||||
* @param result A callback for submitting the result of the call.
|
||||
*/
|
||||
- (void)handleMethodCall:(FlutterMethodCall*)call result:(FlutterResult)result;
|
||||
@optional
|
||||
/**
|
||||
* Called when a plugin is being removed from a `FlutterEngine`, which is
|
||||
* usually the result of the `FlutterEngine` being deallocated. This method
|
||||
* provides the opportunity to do necessary cleanup.
|
||||
*
|
||||
* You will only receive this method if you registered your plugin instance with
|
||||
* the `FlutterEngine` via `-[FlutterPluginRegistry publish:]`.
|
||||
*
|
||||
* @param registrar The registrar that was used to publish the plugin.
|
||||
*
|
||||
*/
|
||||
- (void)detachFromEngineForRegistrar:(NSObject<FlutterPluginRegistrar>*)registrar;
|
||||
@end
|
||||
|
||||
#pragma mark -
|
||||
/**
|
||||
* How the UIGestureRecognizers of a platform view are blocked.
|
||||
*
|
||||
* UIGestureRecognizers of platform views can be blocked based on decisions made by the
|
||||
* Flutter Framework (e.g. When an interact-able widget is covering the platform view).
|
||||
*/
|
||||
typedef enum {
|
||||
// NOLINTBEGIN(readability-identifier-naming)
|
||||
/**
|
||||
* Flutter blocks all the UIGestureRecognizers on the platform view as soon as it
|
||||
* decides they should be blocked.
|
||||
*
|
||||
* With this policy, only the `touchesBegan` method for all the UIGestureRecognizers is guaranteed
|
||||
* to be called.
|
||||
*/
|
||||
FlutterPlatformViewGestureRecognizersBlockingPolicyEager,
|
||||
/**
|
||||
* Flutter blocks the platform view's UIGestureRecognizers from recognizing only after
|
||||
* touchesEnded was invoked.
|
||||
*
|
||||
* This results in the platform view's UIGestureRecognizers seeing the entire touch sequence,
|
||||
* but never recognizing the gesture (and never invoking actions).
|
||||
*/
|
||||
FlutterPlatformViewGestureRecognizersBlockingPolicyWaitUntilTouchesEnded,
|
||||
// NOLINTEND(readability-identifier-naming)
|
||||
} FlutterPlatformViewGestureRecognizersBlockingPolicy;
|
||||
|
||||
#pragma mark -
|
||||
/**
|
||||
* Registration context for a single `FlutterPlugin`, providing a one stop shop
|
||||
* for the plugin to access contextual information and register callbacks for
|
||||
* various application events.
|
||||
*
|
||||
* Registrars are obtained from a `FlutterPluginRegistry` which keeps track of
|
||||
* the identity of registered plugins and provides basic support for cross-plugin
|
||||
* coordination.
|
||||
*/
|
||||
@protocol FlutterPluginRegistrar <NSObject>
|
||||
/**
|
||||
* Returns a `FlutterBinaryMessenger` for creating Dart/iOS communication
|
||||
* channels to be used by the plugin.
|
||||
*
|
||||
* @return The messenger.
|
||||
*/
|
||||
- (NSObject<FlutterBinaryMessenger>*)messenger;
|
||||
|
||||
/**
|
||||
* Returns a `FlutterTextureRegistry` for registering textures
|
||||
* provided by the plugin.
|
||||
*
|
||||
* @return The texture registry.
|
||||
*/
|
||||
- (NSObject<FlutterTextureRegistry>*)textures;
|
||||
|
||||
/**
|
||||
* Registers a `FlutterPlatformViewFactory` for creation of platform views.
|
||||
*
|
||||
* Plugins expose `UIView` for embedding in Flutter apps by registering a view factory.
|
||||
*
|
||||
* @param factory The view factory that will be registered.
|
||||
* @param factoryId A unique identifier for the factory, the Dart code of the Flutter app can use
|
||||
* this identifier to request creation of a `UIView` by the registered factory.
|
||||
*/
|
||||
- (void)registerViewFactory:(NSObject<FlutterPlatformViewFactory>*)factory
|
||||
withId:(NSString*)factoryId;
|
||||
|
||||
/**
|
||||
* Registers a `FlutterPlatformViewFactory` for creation of platform views.
|
||||
*
|
||||
* Plugins can expose a `UIView` for embedding in Flutter apps by registering a view factory.
|
||||
*
|
||||
* @param factory The view factory that will be registered.
|
||||
* @param factoryId A unique identifier for the factory, the Dart code of the Flutter app can use
|
||||
* this identifier to request creation of a `UIView` by the registered factory.
|
||||
* @param gestureRecognizersBlockingPolicy How UIGestureRecognizers on the platform views are
|
||||
* blocked.
|
||||
*
|
||||
*/
|
||||
- (void)registerViewFactory:(NSObject<FlutterPlatformViewFactory>*)factory
|
||||
withId:(NSString*)factoryId
|
||||
gestureRecognizersBlockingPolicy:
|
||||
(FlutterPlatformViewGestureRecognizersBlockingPolicy)gestureRecognizersBlockingPolicy;
|
||||
|
||||
/**
|
||||
* Publishes a value for external use of the plugin.
|
||||
*
|
||||
* Plugins may publish a single value, such as an instance of the
|
||||
* plugin's main class, for situations where external control or
|
||||
* interaction is needed.
|
||||
*
|
||||
* The published value will be available from the `FlutterPluginRegistry`.
|
||||
* Repeated calls overwrite any previous publication.
|
||||
*
|
||||
* @param value The value to be published.
|
||||
*/
|
||||
- (void)publish:(NSObject*)value;
|
||||
|
||||
/**
|
||||
* Registers the plugin as a receiver of incoming method calls from the Dart side
|
||||
* on the specified `FlutterMethodChannel`.
|
||||
*
|
||||
* @param delegate The receiving object, such as the plugin's main class.
|
||||
* @param channel The channel
|
||||
*/
|
||||
- (void)addMethodCallDelegate:(NSObject<FlutterPlugin>*)delegate
|
||||
channel:(FlutterMethodChannel*)channel;
|
||||
|
||||
/**
|
||||
* Registers the plugin as a receiver of `UIApplicationDelegate` calls.
|
||||
*
|
||||
* @param delegate The receiving object, such as the plugin's main class.
|
||||
*/
|
||||
- (void)addApplicationDelegate:(NSObject<FlutterPlugin>*)delegate
|
||||
NS_EXTENSION_UNAVAILABLE_IOS("Disallowed in plugins used in app extensions");
|
||||
|
||||
/**
|
||||
* Returns the file name for the given asset.
|
||||
* The returned file name can be used to access the asset in the application's main bundle.
|
||||
*
|
||||
* @param asset The name of the asset. The name can be hierarchical.
|
||||
* @return the file name to be used for lookup in the main bundle.
|
||||
*/
|
||||
- (NSString*)lookupKeyForAsset:(NSString*)asset;
|
||||
|
||||
/**
|
||||
* Returns the file name for the given asset which originates from the specified package.
|
||||
* The returned file name can be used to access the asset in the application's main bundle.
|
||||
*
|
||||
*
|
||||
* @param asset The name of the asset. The name can be hierarchical.
|
||||
* @param package The name of the package from which the asset originates.
|
||||
* @return the file name to be used for lookup in the main bundle.
|
||||
*/
|
||||
- (NSString*)lookupKeyForAsset:(NSString*)asset fromPackage:(NSString*)package;
|
||||
@end
|
||||
|
||||
#pragma mark -
|
||||
/**
|
||||
* A registry of Flutter iOS plugins.
|
||||
*
|
||||
* Plugins are identified by unique string keys, typically the name of the
|
||||
* plugin's main class. The registry tracks plugins by this key, mapping it to
|
||||
* a value published by the plugin during registration, if any. This provides a
|
||||
* very basic means of cross-plugin coordination with loose coupling between
|
||||
* unrelated plugins.
|
||||
*
|
||||
* 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 FlutterPluginRegistry <NSObject>
|
||||
/**
|
||||
* Returns a registrar for registering a plugin.
|
||||
*
|
||||
* @param pluginKey The unique key identifying the plugin.
|
||||
*/
|
||||
- (nullable NSObject<FlutterPluginRegistrar>*)registrarForPlugin:(NSString*)pluginKey;
|
||||
/**
|
||||
* Returns whether the specified plugin has been registered.
|
||||
*
|
||||
* @param pluginKey The unique key identifying the plugin.
|
||||
* @return `YES` if `registrarForPlugin` has been called with `pluginKey`.
|
||||
*/
|
||||
- (BOOL)hasPlugin:(NSString*)pluginKey;
|
||||
|
||||
/**
|
||||
* Returns a value published by the specified plugin.
|
||||
*
|
||||
* @param pluginKey The unique key identifying the plugin.
|
||||
* @return An object published by the plugin, if any. Will be `NSNull` if
|
||||
* nothing has been published. Will be `nil` if the plugin has not been
|
||||
* registered.
|
||||
*/
|
||||
- (nullable NSObject*)valuePublishedByPlugin:(NSString*)pluginKey;
|
||||
@end
|
||||
|
||||
#pragma mark -
|
||||
/**
|
||||
* Implement this in the `UIAppDelegate` of your app to enable Flutter plugins to register
|
||||
* themselves to the application life cycle events.
|
||||
*
|
||||
* For plugins to receive events from `UNUserNotificationCenter`, register this as the
|
||||
* `UNUserNotificationCenterDelegate`.
|
||||
*/
|
||||
@protocol FlutterAppLifeCycleProvider <UNUserNotificationCenterDelegate>
|
||||
|
||||
/**
|
||||
* Called when registering a new `FlutterApplicaitonLifeCycleDelegate`.
|
||||
*
|
||||
* See also: `-[FlutterAppDelegate addApplicationLifeCycleDelegate:]`
|
||||
*/
|
||||
- (void)addApplicationLifeCycleDelegate:(NSObject<FlutterApplicationLifeCycleDelegate>*)delegate;
|
||||
@end
|
||||
|
||||
NS_ASSUME_NONNULL_END
|
||||
|
||||
#endif // FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERPLUGIN_H_
|
||||
|
|
@ -0,0 +1,148 @@
|
|||
// 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_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERPLUGINAPPLIFECYCLEDELEGATE_H_
|
||||
#define FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERPLUGINAPPLIFECYCLEDELEGATE_H_
|
||||
|
||||
#import "FlutterPlugin.h"
|
||||
|
||||
NS_ASSUME_NONNULL_BEGIN
|
||||
|
||||
/**
|
||||
* Propagates `UIAppDelegate` callbacks to registered plugins.
|
||||
*/
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
@interface FlutterPluginAppLifeCycleDelegate : NSObject <UNUserNotificationCenterDelegate>
|
||||
|
||||
/**
|
||||
* Registers `delegate` to receive life cycle callbacks via this FlutterPluginAppLifeCycleDelegate
|
||||
* as long as it is alive.
|
||||
*
|
||||
* `delegate` will only be referenced weakly.
|
||||
*/
|
||||
- (void)addDelegate:(NSObject<FlutterApplicationLifeCycleDelegate>*)delegate;
|
||||
|
||||
/**
|
||||
* Calls all plugins registered for `UIApplicationDelegate` callbacks.
|
||||
*
|
||||
* @return `NO` if any plugin vetos application launch.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
didFinishLaunchingWithOptions:(NSDictionary*)launchOptions;
|
||||
|
||||
/**
|
||||
* Calls all plugins registered for `UIApplicationDelegate` callbacks.
|
||||
*
|
||||
* @return `NO` if any plugin vetos application launch.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
willFinishLaunchingWithOptions:(NSDictionary*)launchOptions;
|
||||
|
||||
/**
|
||||
* Called if this plugin has been registered for `UIApplicationDelegate` callbacks.
|
||||
*/
|
||||
- (void)application:(UIApplication*)application
|
||||
didRegisterUserNotificationSettings:(UIUserNotificationSettings*)notificationSettings
|
||||
API_DEPRECATED(
|
||||
"See -[UIApplicationDelegate application:didRegisterUserNotificationSettings:] deprecation",
|
||||
ios(8.0, 10.0));
|
||||
|
||||
/**
|
||||
* Calls all plugins registered for `UIApplicationDelegate` callbacks.
|
||||
*/
|
||||
- (void)application:(UIApplication*)application
|
||||
didRegisterForRemoteNotificationsWithDeviceToken:(NSData*)deviceToken;
|
||||
|
||||
/**
|
||||
* Calls all plugins registered for `UIApplicationDelegate` callbacks.
|
||||
*/
|
||||
- (void)application:(UIApplication*)application
|
||||
didFailToRegisterForRemoteNotificationsWithError:(NSError*)error;
|
||||
|
||||
/**
|
||||
* Calls all plugins registered for `UIApplicationDelegate` callbacks.
|
||||
*/
|
||||
- (void)application:(UIApplication*)application
|
||||
didReceiveRemoteNotification:(NSDictionary*)userInfo
|
||||
fetchCompletionHandler:(void (^)(UIBackgroundFetchResult result))completionHandler;
|
||||
|
||||
/**
|
||||
* Calls all plugins registered for `UIApplicationDelegate` callbacks.
|
||||
*/
|
||||
- (void)application:(UIApplication*)application
|
||||
didReceiveLocalNotification:(UILocalNotification*)notification
|
||||
API_DEPRECATED(
|
||||
"See -[UIApplicationDelegate application:didReceiveLocalNotification:] deprecation",
|
||||
ios(4.0, 10.0));
|
||||
|
||||
/**
|
||||
* Calls all plugins registered for `UIApplicationDelegate` callbacks in order of registration until
|
||||
* some plugin handles the request.
|
||||
*
|
||||
* @return `YES` if any plugin handles the request.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
openURL:(NSURL*)url
|
||||
options:(NSDictionary<UIApplicationOpenURLOptionsKey, id>*)options;
|
||||
|
||||
/**
|
||||
* Calls all plugins registered for `UIApplicationDelegate` callbacks in order of registration until
|
||||
* some plugin handles the request.
|
||||
*
|
||||
* @return `YES` if any plugin handles the request.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application handleOpenURL:(NSURL*)url;
|
||||
|
||||
/**
|
||||
* Calls all plugins registered for `UIApplicationDelegate` callbacks in order of registration until
|
||||
* some plugin handles the request.
|
||||
*
|
||||
* @return `YES` if any plugin handles the request.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
openURL:(NSURL*)url
|
||||
sourceApplication:(NSString*)sourceApplication
|
||||
annotation:(id)annotation;
|
||||
|
||||
/**
|
||||
* Calls all plugins registered for `UIApplicationDelegate` callbacks.
|
||||
*/
|
||||
- (void)application:(UIApplication*)application
|
||||
performActionForShortcutItem:(UIApplicationShortcutItem*)shortcutItem
|
||||
completionHandler:(void (^)(BOOL succeeded))completionHandler
|
||||
API_AVAILABLE(ios(9.0));
|
||||
|
||||
/**
|
||||
* Calls all plugins registered for `UIApplicationDelegate` callbacks in order of registration until
|
||||
* some plugin handles the request.
|
||||
*
|
||||
* @return `YES` if any plugin handles the request.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
handleEventsForBackgroundURLSession:(nonnull NSString*)identifier
|
||||
completionHandler:(nonnull void (^)(void))completionHandler;
|
||||
|
||||
/**
|
||||
* Calls all plugins registered for `UIApplicationDelegate` callbacks in order of registration until
|
||||
* some plugin handles the request.
|
||||
*
|
||||
* @returns `YES` if any plugin handles the request.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
performFetchWithCompletionHandler:(void (^)(UIBackgroundFetchResult result))completionHandler;
|
||||
|
||||
/**
|
||||
* Calls all plugins registered for `UIApplicationDelegate` callbacks in order of registration until
|
||||
* some plugin handles the request.
|
||||
*
|
||||
* @return `YES` if any plugin handles the request.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
continueUserActivity:(NSUserActivity*)userActivity
|
||||
restorationHandler:(void (^)(NSArray*))restorationHandler;
|
||||
@end
|
||||
|
||||
NS_ASSUME_NONNULL_END
|
||||
|
||||
#endif // FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERPLUGINAPPLIFECYCLEDELEGATE_H_
|
||||
|
|
@ -0,0 +1,62 @@
|
|||
// 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_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERTEXTURE_H_
|
||||
#define FLUTTER_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERTEXTURE_H_
|
||||
|
||||
#import <CoreMedia/CoreMedia.h>
|
||||
#import <Foundation/Foundation.h>
|
||||
|
||||
#import "FlutterMacros.h"
|
||||
|
||||
NS_ASSUME_NONNULL_BEGIN
|
||||
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
/**
|
||||
* Represents a texture that can be shared with Flutter.
|
||||
*
|
||||
* See also: https://github.com/flutter/plugins/tree/master/packages/camera
|
||||
*/
|
||||
@protocol FlutterTexture <NSObject>
|
||||
/** Copy the contents of the texture into a `CVPixelBuffer`. */
|
||||
- (CVPixelBufferRef _Nullable)copyPixelBuffer;
|
||||
|
||||
/**
|
||||
* Called when the texture is unregistered.
|
||||
*
|
||||
* Called on the raster thread.
|
||||
*/
|
||||
@optional
|
||||
- (void)onTextureUnregistered:(NSObject<FlutterTexture>*)texture;
|
||||
@end
|
||||
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
/**
|
||||
* A collection of registered `FlutterTexture`'s.
|
||||
*/
|
||||
@protocol FlutterTextureRegistry <NSObject>
|
||||
/**
|
||||
* Registers a `FlutterTexture` for usage in Flutter and returns an id that can be used to reference
|
||||
* that texture when calling into Flutter with channels. Textures must be registered on the
|
||||
* platform thread. On success returns the pointer to the registered texture, else returns 0.
|
||||
*/
|
||||
- (int64_t)registerTexture:(NSObject<FlutterTexture>*)texture;
|
||||
/**
|
||||
* Notifies Flutter that the content of the previously registered texture has been updated.
|
||||
*
|
||||
* This will trigger a call to `-[FlutterTexture copyPixelBuffer]` on the raster thread.
|
||||
*/
|
||||
- (void)textureFrameAvailable:(int64_t)textureId;
|
||||
/**
|
||||
* Unregisters a `FlutterTexture` that has previously regeistered with `registerTexture:`. Textures
|
||||
* must be unregistered on the platform thread.
|
||||
*
|
||||
* @param textureId The result that was previously returned from `registerTexture:`.
|
||||
*/
|
||||
- (void)unregisterTexture:(int64_t)textureId;
|
||||
@end
|
||||
|
||||
NS_ASSUME_NONNULL_END
|
||||
|
||||
#endif // FLUTTER_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERTEXTURE_H_
|
||||
|
|
@ -0,0 +1,260 @@
|
|||
// 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_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERVIEWCONTROLLER_H_
|
||||
#define FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERVIEWCONTROLLER_H_
|
||||
|
||||
#import <UIKit/UIKit.h>
|
||||
#include <sys/cdefs.h>
|
||||
|
||||
#import "FlutterBinaryMessenger.h"
|
||||
#import "FlutterDartProject.h"
|
||||
#import "FlutterEngine.h"
|
||||
#import "FlutterMacros.h"
|
||||
#import "FlutterPlugin.h"
|
||||
#import "FlutterTexture.h"
|
||||
|
||||
NS_ASSUME_NONNULL_BEGIN
|
||||
|
||||
@class FlutterEngine;
|
||||
|
||||
/**
|
||||
* The name used for semantic update notifications via `NSNotificationCenter`.
|
||||
*
|
||||
* The object passed as the sender is the `FlutterViewController` associated
|
||||
* with the update.
|
||||
*/
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
// NOLINTNEXTLINE(readability-identifier-naming)
|
||||
extern NSNotificationName const FlutterSemanticsUpdateNotification;
|
||||
|
||||
/**
|
||||
* A `UIViewController` implementation for Flutter views.
|
||||
*
|
||||
* Dart execution, channel communication, texture registration, and plugin registration are all
|
||||
* handled by `FlutterEngine`. Calls on this class to those members all proxy through to the
|
||||
* `FlutterEngine` attached FlutterViewController.
|
||||
*
|
||||
* A FlutterViewController can be initialized either with an already-running `FlutterEngine` via the
|
||||
* `initWithEngine:` initializer, or it can be initialized with a `FlutterDartProject` that will be
|
||||
* used to implicitly spin up a new `FlutterEngine`. Creating a `FlutterEngine` before showing a
|
||||
* FlutterViewController can be used to pre-initialize the Dart VM and to prepare the isolate in
|
||||
* order to reduce the latency to the first rendered frame. See
|
||||
* https://flutter.dev/docs/development/add-to-app/performance for more details on loading
|
||||
* latency.
|
||||
*
|
||||
* Holding a `FlutterEngine` independently of FlutterViewControllers can also be used to not to lose
|
||||
* Dart-related state and asynchronous tasks when navigating back and forth between a
|
||||
* FlutterViewController and other `UIViewController`s.
|
||||
*/
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
#ifdef __IPHONE_13_4
|
||||
@interface FlutterViewController
|
||||
: UIViewController <FlutterTextureRegistry, FlutterPluginRegistry, UIGestureRecognizerDelegate>
|
||||
#else
|
||||
@interface FlutterViewController : UIViewController <FlutterTextureRegistry, FlutterPluginRegistry>
|
||||
#endif
|
||||
|
||||
/**
|
||||
* Initializes this FlutterViewController with the specified `FlutterEngine`.
|
||||
*
|
||||
* The initialized viewcontroller will attach itself to the engine as part of this process.
|
||||
*
|
||||
* @param engine The `FlutterEngine` instance to attach to. Cannot be nil.
|
||||
* @param nibName The NIB name to initialize this UIViewController with.
|
||||
* @param nibBundle The NIB bundle.
|
||||
*/
|
||||
- (instancetype)initWithEngine:(FlutterEngine*)engine
|
||||
nibName:(nullable NSString*)nibName
|
||||
bundle:(nullable NSBundle*)nibBundle NS_DESIGNATED_INITIALIZER;
|
||||
|
||||
/**
|
||||
* Initializes a new FlutterViewController and `FlutterEngine` with the specified
|
||||
* `FlutterDartProject`.
|
||||
*
|
||||
* This will implicitly create a new `FlutterEngine` which is retrievable via the `engine` property
|
||||
* after initialization.
|
||||
*
|
||||
* @param project The `FlutterDartProject` to initialize the `FlutterEngine` with.
|
||||
* @param nibName The NIB name to initialize this UIViewController with.
|
||||
* @param nibBundle The NIB bundle.
|
||||
*/
|
||||
- (instancetype)initWithProject:(nullable FlutterDartProject*)project
|
||||
nibName:(nullable NSString*)nibName
|
||||
bundle:(nullable NSBundle*)nibBundle NS_DESIGNATED_INITIALIZER;
|
||||
|
||||
/**
|
||||
* Initializes a new FlutterViewController and `FlutterEngine` with the specified
|
||||
* `FlutterDartProject` and `initialRoute`.
|
||||
*
|
||||
* This will implicitly create a new `FlutterEngine` which is retrievable via the `engine` property
|
||||
* after initialization.
|
||||
*
|
||||
* @param project The `FlutterDartProject` to initialize the `FlutterEngine` with.
|
||||
* @param initialRoute The initial `Navigator` route to load.
|
||||
* @param nibName The NIB name to initialize this UIViewController with.
|
||||
* @param nibBundle The NIB bundle.
|
||||
*/
|
||||
- (instancetype)initWithProject:(nullable FlutterDartProject*)project
|
||||
initialRoute:(nullable NSString*)initialRoute
|
||||
nibName:(nullable NSString*)nibName
|
||||
bundle:(nullable NSBundle*)nibBundle NS_DESIGNATED_INITIALIZER;
|
||||
|
||||
/**
|
||||
* Initializer that is called from loading a FlutterViewController from a XIB.
|
||||
*
|
||||
* See also:
|
||||
* https://developer.apple.com/documentation/foundation/nscoding/1416145-initwithcoder?language=objc
|
||||
*/
|
||||
- (instancetype)initWithCoder:(NSCoder*)aDecoder NS_DESIGNATED_INITIALIZER;
|
||||
|
||||
/**
|
||||
* Registers a callback that will be invoked when the Flutter view has been rendered.
|
||||
* The callback will be fired only once.
|
||||
*
|
||||
* Replaces an existing callback. Use a `nil` callback to unregister the existing one.
|
||||
*/
|
||||
- (void)setFlutterViewDidRenderCallback:(void (^)(void))callback;
|
||||
|
||||
/**
|
||||
* Returns the file name for the given asset.
|
||||
* The returned file name can be used to access the asset in the application's
|
||||
* main bundle.
|
||||
*
|
||||
* @param asset The name of the asset. The name can be hierarchical.
|
||||
* @return The file name to be used for lookup in the main bundle.
|
||||
*/
|
||||
- (NSString*)lookupKeyForAsset:(NSString*)asset;
|
||||
|
||||
/**
|
||||
* Returns the file name for the given asset which originates from the specified
|
||||
* package.
|
||||
* The returned file name can be used to access the asset in the application's
|
||||
* main bundle.
|
||||
*
|
||||
* @param asset The name of the asset. The name can be hierarchical.
|
||||
* @param package The name of the package from which the asset originates.
|
||||
* @return The file name to be used for lookup in the main bundle.
|
||||
*/
|
||||
- (NSString*)lookupKeyForAsset:(NSString*)asset fromPackage:(NSString*)package;
|
||||
|
||||
/**
|
||||
* Deprecated API to set initial route.
|
||||
*
|
||||
* Attempts to set the first route that the Flutter app shows if the Flutter
|
||||
* runtime hasn't yet started. The default is "/".
|
||||
*
|
||||
* This method must be called immediately after `initWithProject` and has no
|
||||
* effect when using `initWithEngine` if the `FlutterEngine` has already been
|
||||
* run.
|
||||
*
|
||||
* Setting this after the Flutter started running has no effect. See `pushRoute`
|
||||
* and `popRoute` to change the route after Flutter started running.
|
||||
*
|
||||
* This is deprecated because it needs to be called at the time of initialization
|
||||
* and thus should just be in the `initWithProject` initializer. If using
|
||||
* `initWithEngine`, the initial route should be set on the engine's
|
||||
* initializer.
|
||||
*
|
||||
* @param route The name of the first route to show.
|
||||
*/
|
||||
- (void)setInitialRoute:(NSString*)route
|
||||
FLUTTER_DEPRECATED("Use FlutterViewController initializer to specify initial route");
|
||||
|
||||
/**
|
||||
* Instructs the Flutter Navigator (if any) to go back.
|
||||
*/
|
||||
- (void)popRoute;
|
||||
|
||||
/**
|
||||
* Instructs the Flutter Navigator (if any) to push a route on to the navigation
|
||||
* stack.
|
||||
*
|
||||
* @param route The name of the route to push to the navigation stack.
|
||||
*/
|
||||
- (void)pushRoute:(NSString*)route;
|
||||
|
||||
/**
|
||||
* The `FlutterPluginRegistry` used by this FlutterViewController.
|
||||
*/
|
||||
- (id<FlutterPluginRegistry>)pluginRegistry;
|
||||
|
||||
/**
|
||||
* A wrapper around UIAccessibilityIsVoiceOverRunning().
|
||||
*
|
||||
* As a C function, UIAccessibilityIsVoiceOverRunning() cannot be mocked in testing. Mock
|
||||
* this class method to testing features depends on UIAccessibilityIsVoiceOverRunning().
|
||||
*/
|
||||
+ (BOOL)isUIAccessibilityIsVoiceOverRunning;
|
||||
|
||||
/**
|
||||
* True if at least one frame has rendered and the ViewController has appeared.
|
||||
*
|
||||
* This property is reset to false when the ViewController disappears. It is
|
||||
* guaranteed to only alternate between true and false for observers.
|
||||
*/
|
||||
@property(nonatomic, readonly, getter=isDisplayingFlutterUI) BOOL displayingFlutterUI;
|
||||
|
||||
/**
|
||||
* Specifies the view to use as a splash screen. Flutter's rendering is asynchronous, so the first
|
||||
* frame rendered by the Flutter application might not immediately appear when the Flutter view is
|
||||
* initially placed in the view hierarchy. The splash screen view will be used as
|
||||
* a replacement until the first frame is rendered.
|
||||
*
|
||||
* The view used should be appropriate for multiple sizes; an autoresizing mask to
|
||||
* have a flexible width and height will be applied automatically.
|
||||
*
|
||||
* Set to nil to remove the splash screen view.
|
||||
*/
|
||||
@property(strong, nonatomic, nullable) UIView* splashScreenView;
|
||||
|
||||
/**
|
||||
* Attempts to set the `splashScreenView` property from the `UILaunchStoryboardName` from the
|
||||
* main bundle's `Info.plist` file. This method will not change the value of `splashScreenView`
|
||||
* if it cannot find a default one from a storyboard or nib.
|
||||
*
|
||||
* @return `YES` if successful, `NO` otherwise.
|
||||
*/
|
||||
- (BOOL)loadDefaultSplashScreenView;
|
||||
|
||||
/**
|
||||
* Controls whether the created view will be opaque or not.
|
||||
*
|
||||
* Default is `YES`. Note that setting this to `NO` may negatively impact performance
|
||||
* when using hardware acceleration, and toggling this will trigger a re-layout of the
|
||||
* view.
|
||||
*/
|
||||
@property(nonatomic, getter=isViewOpaque) BOOL viewOpaque;
|
||||
|
||||
/**
|
||||
* The `FlutterEngine` instance for this view controller. This could be the engine this
|
||||
* `FlutterViewController` is initialized with or a new `FlutterEngine` implicitly created if
|
||||
* no engine was supplied during initialization.
|
||||
*/
|
||||
@property(weak, nonatomic, readonly) FlutterEngine* engine;
|
||||
|
||||
/**
|
||||
* The `FlutterBinaryMessenger` associated with this FlutterViewController (used for communicating
|
||||
* with channels).
|
||||
*
|
||||
* This is just a convenient way to get the |FlutterEngine|'s binary messenger.
|
||||
*/
|
||||
@property(nonatomic, readonly) NSObject<FlutterBinaryMessenger>* binaryMessenger;
|
||||
|
||||
/**
|
||||
* If the `FlutterViewController` creates a `FlutterEngine`, this property
|
||||
* determines if that `FlutterEngine` has `allowHeadlessExecution` set.
|
||||
*
|
||||
* The intention is that this is used with the XIB. Otherwise, a
|
||||
* `FlutterEngine` can just be sent to the init methods.
|
||||
*
|
||||
* See also: `-[FlutterEngine initWithName:project:allowHeadlessExecution:]`
|
||||
*/
|
||||
@property(nonatomic, readonly) BOOL engineAllowHeadlessExecution;
|
||||
|
||||
@end
|
||||
|
||||
NS_ASSUME_NONNULL_END
|
||||
|
||||
#endif // FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERVIEWCONTROLLER_H_
|
||||
|
|
@ -0,0 +1,30 @@
|
|||
<?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>Flutter</string>
|
||||
<key>CFBundleIdentifier</key>
|
||||
<string>io.flutter.flutter</string>
|
||||
<key>CFBundleInfoDictionaryVersion</key>
|
||||
<string>6.0</string>
|
||||
<key>CFBundleName</key>
|
||||
<string>Flutter</string>
|
||||
<key>CFBundlePackageType</key>
|
||||
<string>FMWK</string>
|
||||
<key>CFBundleShortVersionString</key>
|
||||
<string>1.0</string>
|
||||
<key>CFBundleSignature</key>
|
||||
<string>????</string>
|
||||
<key>CFBundleVersion</key>
|
||||
<string>1.0</string>
|
||||
<key>MinimumOSVersion</key>
|
||||
<string>11.0</string>
|
||||
<key>FlutterEngine</key>
|
||||
<string>e76c956498841e1ab458577d3892003e553e4f3c</string>
|
||||
<key>ClangVersion</key>
|
||||
<string>b'Fuchsia clang version 18.0.0 (https://llvm.googlesource.com/llvm-project 725656bdd885483c39f482a01ea25d67acf39c46)'</string>
|
||||
</dict>
|
||||
</plist>
|
||||
|
|
@ -0,0 +1,6 @@
|
|||
framework module Flutter {
|
||||
umbrella header "Flutter.h"
|
||||
|
||||
export *
|
||||
module * { export * }
|
||||
}
|
||||
|
|
@ -0,0 +1,32 @@
|
|||
<?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>NSPrivacyTracking</key>
|
||||
<false/>
|
||||
<key>NSPrivacyTrackingDomains</key>
|
||||
<array/>
|
||||
<key>NSPrivacyCollectedDataTypes</key>
|
||||
<array/>
|
||||
<key>NSPrivacyAccessedAPITypes</key>
|
||||
<array>
|
||||
<dict>
|
||||
<key>NSPrivacyAccessedAPIType</key>
|
||||
<string>NSPrivacyAccessedAPICategoryFileTimestamp</string>
|
||||
<key>NSPrivacyAccessedAPITypeReasons</key>
|
||||
<array>
|
||||
<string>0A2A.1</string>
|
||||
<string>C617.1</string>
|
||||
</array>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>NSPrivacyAccessedAPIType</key>
|
||||
<string>NSPrivacyAccessedAPICategorySystemBootTime</string>
|
||||
<key>NSPrivacyAccessedAPITypeReasons</key>
|
||||
<array>
|
||||
<string>35F9.1</string>
|
||||
</array>
|
||||
</dict>
|
||||
</array>
|
||||
</dict>
|
||||
</plist>
|
||||
|
|
@ -0,0 +1,311 @@
|
|||
<?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>files</key>
|
||||
<dict>
|
||||
<key>Headers/Flutter.h</key>
|
||||
<data>
|
||||
wTPJHICwW6wxY3b87ek7ITN5kJk=
|
||||
</data>
|
||||
<key>Headers/FlutterAppDelegate.h</key>
|
||||
<data>
|
||||
zbvYFr9dywry0lMMrHuNOOaNgkY=
|
||||
</data>
|
||||
<key>Headers/FlutterBinaryMessenger.h</key>
|
||||
<data>
|
||||
ksjIMu5IPw+Q3rw2YkAx0KjxkdM=
|
||||
</data>
|
||||
<key>Headers/FlutterCallbackCache.h</key>
|
||||
<data>
|
||||
V/wkSSsyYdMoexF6wPrC3KgkL4g=
|
||||
</data>
|
||||
<key>Headers/FlutterChannels.h</key>
|
||||
<data>
|
||||
vFsZXNqjflvqKqAzsIptQaTSJho=
|
||||
</data>
|
||||
<key>Headers/FlutterCodecs.h</key>
|
||||
<data>
|
||||
sUgX1PJzkvyinL5i7nS1ro/Kd5o=
|
||||
</data>
|
||||
<key>Headers/FlutterDartProject.h</key>
|
||||
<data>
|
||||
1Ii7W6lYWZUeB6C6rtn269jAxgA=
|
||||
</data>
|
||||
<key>Headers/FlutterEngine.h</key>
|
||||
<data>
|
||||
AqVvCbPmgWMQKrRnib05Okrjbp0=
|
||||
</data>
|
||||
<key>Headers/FlutterEngineGroup.h</key>
|
||||
<data>
|
||||
nZcTgHGDD30QzPLlQfP8gP+S06o=
|
||||
</data>
|
||||
<key>Headers/FlutterHeadlessDartRunner.h</key>
|
||||
<data>
|
||||
UqnnVWwQEYYX56eu7lt6dpR3LIc=
|
||||
</data>
|
||||
<key>Headers/FlutterMacros.h</key>
|
||||
<data>
|
||||
crQ9782ULebLQfIR+MbBkjB7d+k=
|
||||
</data>
|
||||
<key>Headers/FlutterPlatformViews.h</key>
|
||||
<data>
|
||||
ocQVSiAiUMYfVtZIn48LpYTJA5w=
|
||||
</data>
|
||||
<key>Headers/FlutterPlugin.h</key>
|
||||
<data>
|
||||
EARXud6pHb7ZYP8eXPDnluMqcXk=
|
||||
</data>
|
||||
<key>Headers/FlutterPluginAppLifeCycleDelegate.h</key>
|
||||
<data>
|
||||
qWHw5VIWEa0NmJ1PMhD16nlfRKk=
|
||||
</data>
|
||||
<key>Headers/FlutterTexture.h</key>
|
||||
<data>
|
||||
7nFruy6bmD9XHvbzEwfdTXE4Rkk=
|
||||
</data>
|
||||
<key>Headers/FlutterViewController.h</key>
|
||||
<data>
|
||||
n0oqDKaGwBHcAUY4+7F+z78onKc=
|
||||
</data>
|
||||
<key>Info.plist</key>
|
||||
<data>
|
||||
4h4j8sv5dl7Tn/xCcbUeqZHdBTo=
|
||||
</data>
|
||||
<key>Modules/module.modulemap</key>
|
||||
<data>
|
||||
wJV5dCKEGl+FAtDc8wJJh/fvKXs=
|
||||
</data>
|
||||
<key>PrivacyInfo.xcprivacy</key>
|
||||
<data>
|
||||
D+cqXttvC7E/uziGjFdqFabWd7A=
|
||||
</data>
|
||||
<key>icudtl.dat</key>
|
||||
<data>
|
||||
Ubat0LvE4LUgCwHeyl0Anx2vnzk=
|
||||
</data>
|
||||
</dict>
|
||||
<key>files2</key>
|
||||
<dict>
|
||||
<key>Headers/Flutter.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
auaf7wPxiASCYD2ACy1dfbMJvmONwFvSz1BWYAQrrSw=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Headers/FlutterAppDelegate.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
o0iigVsmgwmtZfSv3X7hReDNYP5rXblslDnqq2s6UQc=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Headers/FlutterBinaryMessenger.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
EXDk4t+7qCpyQkar+q9WHqY9bcK8eyohCwGVtBJhMy8=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Headers/FlutterCallbackCache.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
0h9+vK5K+r8moTsiGBfs6+TM9Qog089afHAy3gbcwDU=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Headers/FlutterChannels.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
kg195C3vZLiOn8KeFQUy7DoVuA9VZDpqoBLVn64uGaI=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Headers/FlutterCodecs.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
ZyqlHYuZbpFevVeny9Wdl0rVFgS7szIyssSiCyaaeFM=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Headers/FlutterDartProject.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
Y5PEW7Tws4XpVmn15X/fdaU0d76hSeF803JlgrI20qE=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Headers/FlutterEngine.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
RAOC6nDhZdghbAzsIZgVeq6qPt+MUNTfm/vkUnhmZO4=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Headers/FlutterEngineGroup.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
I+878Ez9ZpVdAR2GOzKJKjaZ5m807AeAF++2pSMQss4=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Headers/FlutterHeadlessDartRunner.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
nmZjZpvFCXrygf4U9aPkNi8VcI7cL5AtA+CY5uUWIL0=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Headers/FlutterMacros.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
ebBVHSZcUnAbN4hRcYq3ttt6++z1Ybc8KVSYhVToD5k=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Headers/FlutterPlatformViews.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
4hl+kRU4PNNKdAHvYrliObXzSjRzow9Z18oOMRZIa0o=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Headers/FlutterPlugin.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
HqbvCHqKWTzs5GjLAwupqEIYVi9yf5CrMdMe31EOwUA=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Headers/FlutterPluginAppLifeCycleDelegate.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
+PMn+5SDj2Vd6RU8CQIt/JYl3T+8Dhp7HImqAzocoNk=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Headers/FlutterTexture.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
4kb25KahvBulQiElAYv/ZSbdkhkb5F/AKRZv4IjLsOw=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Headers/FlutterViewController.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
phm49xhui2KkRomlqtmASHuU7lmd/s3qNCQpYxC0IMc=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Modules/module.modulemap</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
0VjriRpZ7AZZaP/0mMAPMJPhi6LoMB4MhXzL5j24tGs=
|
||||
</data>
|
||||
</dict>
|
||||
<key>PrivacyInfo.xcprivacy</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
n5XX54YqS1a2btkmvW1iLSplRagn0ZhHJ4tDjVcdQhI=
|
||||
</data>
|
||||
</dict>
|
||||
<key>icudtl.dat</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
ZepykIMSjfzhwAcmupMrkaqvXkhza1ZE3TdHjl8odaw=
|
||||
</data>
|
||||
</dict>
|
||||
</dict>
|
||||
<key>rules</key>
|
||||
<dict>
|
||||
<key>^.*</key>
|
||||
<true/>
|
||||
<key>^.*\.lproj/</key>
|
||||
<dict>
|
||||
<key>optional</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>1000</real>
|
||||
</dict>
|
||||
<key>^.*\.lproj/locversion.plist$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>1100</real>
|
||||
</dict>
|
||||
<key>^Base\.lproj/</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>1010</real>
|
||||
</dict>
|
||||
<key>^version.plist$</key>
|
||||
<true/>
|
||||
</dict>
|
||||
<key>rules2</key>
|
||||
<dict>
|
||||
<key>.*\.dSYM($|/)</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>11</real>
|
||||
</dict>
|
||||
<key>^(.*/)?\.DS_Store$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>2000</real>
|
||||
</dict>
|
||||
<key>^.*</key>
|
||||
<true/>
|
||||
<key>^.*\.lproj/</key>
|
||||
<dict>
|
||||
<key>optional</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>1000</real>
|
||||
</dict>
|
||||
<key>^.*\.lproj/locversion.plist$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>1100</real>
|
||||
</dict>
|
||||
<key>^Base\.lproj/</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>1010</real>
|
||||
</dict>
|
||||
<key>^Info\.plist$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>20</real>
|
||||
</dict>
|
||||
<key>^PkgInfo$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>20</real>
|
||||
</dict>
|
||||
<key>^embedded\.provisionprofile$</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>20</real>
|
||||
</dict>
|
||||
<key>^version\.plist$</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>20</real>
|
||||
</dict>
|
||||
</dict>
|
||||
</dict>
|
||||
</plist>
|
||||
Binary file not shown.
|
|
@ -0,0 +1,16 @@
|
|||
#ifdef __OBJC__
|
||||
#import <UIKit/UIKit.h>
|
||||
#else
|
||||
#ifndef FOUNDATION_EXPORT
|
||||
#if defined(__cplusplus)
|
||||
#define FOUNDATION_EXPORT extern "C"
|
||||
#else
|
||||
#define FOUNDATION_EXPORT extern
|
||||
#endif
|
||||
#endif
|
||||
#endif
|
||||
|
||||
|
||||
FOUNDATION_EXPORT double Pods_RunnerVersionNumber;
|
||||
FOUNDATION_EXPORT const unsigned char Pods_RunnerVersionString[];
|
||||
|
||||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
|
After Width: | Height: | Size: 4.0 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 5.7 KiB |
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
|
|
@ -0,0 +1,26 @@
|
|||
<?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>App</string>
|
||||
<key>CFBundleIdentifier</key>
|
||||
<string>io.flutter.flutter.app</string>
|
||||
<key>CFBundleInfoDictionaryVersion</key>
|
||||
<string>6.0</string>
|
||||
<key>CFBundleName</key>
|
||||
<string>App</string>
|
||||
<key>CFBundlePackageType</key>
|
||||
<string>FMWK</string>
|
||||
<key>CFBundleShortVersionString</key>
|
||||
<string>1.0</string>
|
||||
<key>CFBundleSignature</key>
|
||||
<string>????</string>
|
||||
<key>CFBundleVersion</key>
|
||||
<string>1.0</string>
|
||||
<key>MinimumOSVersion</key>
|
||||
<string>12.0</string>
|
||||
</dict>
|
||||
</plist>
|
||||
|
|
@ -0,0 +1,234 @@
|
|||
<?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>files</key>
|
||||
<dict>
|
||||
<key>Info.plist</key>
|
||||
<data>
|
||||
h5OB7aKzS5WR9SemvZAyN6FEkJs=
|
||||
</data>
|
||||
<key>flutter_assets/AssetManifest.bin</key>
|
||||
<data>
|
||||
nppY/SgfJlLHZzmbow3RnZMXeVI=
|
||||
</data>
|
||||
<key>flutter_assets/AssetManifest.json</key>
|
||||
<data>
|
||||
SrA+dnnv0cgCjtutFqnacYn9E/M=
|
||||
</data>
|
||||
<key>flutter_assets/FontManifest.json</key>
|
||||
<data>
|
||||
vKJkVIcw+LGHFnKJGwrQwCREv68=
|
||||
</data>
|
||||
<key>flutter_assets/NOTICES.Z</key>
|
||||
<data>
|
||||
QCDACWf11cA4QfYwAwI/1JnWBaw=
|
||||
</data>
|
||||
<key>flutter_assets/assets/appbar_background.png</key>
|
||||
<data>
|
||||
JkgEiNZSVRa0lrDwrdeN4N1j56k=
|
||||
</data>
|
||||
<key>flutter_assets/assets/logo.png</key>
|
||||
<data>
|
||||
Kp3Vqz9/+Q7JHvx/0dcelGsVQ0Y=
|
||||
</data>
|
||||
<key>flutter_assets/fonts/MaterialIcons-Regular.otf</key>
|
||||
<data>
|
||||
/CUoTuPQqqdexfyOT9lpJhV+2MQ=
|
||||
</data>
|
||||
<key>flutter_assets/isolate_snapshot_data</key>
|
||||
<data>
|
||||
cU5igDxcIVzLQT2ishbNSdUocVk=
|
||||
</data>
|
||||
<key>flutter_assets/kernel_blob.bin</key>
|
||||
<data>
|
||||
2S861NjVoBUyLZO/rAR+4BdQj3A=
|
||||
</data>
|
||||
<key>flutter_assets/packages/cupertino_icons/assets/CupertinoIcons.ttf</key>
|
||||
<data>
|
||||
Bvk+P1ykE1PGRdktwgwDyz6AOqM=
|
||||
</data>
|
||||
<key>flutter_assets/shaders/ink_sparkle.frag</key>
|
||||
<data>
|
||||
hBZgIGdEvhX+IvXd5bjkjJVu6+s=
|
||||
</data>
|
||||
<key>flutter_assets/vm_snapshot_data</key>
|
||||
<data>
|
||||
ap40xllbguuMfkV4mJkKh/NQWg4=
|
||||
</data>
|
||||
</dict>
|
||||
<key>files2</key>
|
||||
<dict>
|
||||
<key>flutter_assets/AssetManifest.bin</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
q8Ie4Ld3/fiNviXBIo+2I1C35qbB9odFDYKbahX2XZY=
|
||||
</data>
|
||||
</dict>
|
||||
<key>flutter_assets/AssetManifest.json</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
Bmf/DHmOo0s6mgjvOjLEVTky39BPm3x3AhVDJwMtcmw=
|
||||
</data>
|
||||
</dict>
|
||||
<key>flutter_assets/FontManifest.json</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
zX4DZFvESy3Ue3y2JvUcTsv1Whl6t3JBYotHrBZfviE=
|
||||
</data>
|
||||
</dict>
|
||||
<key>flutter_assets/NOTICES.Z</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
uxaMPyJTnaE0nTnvDYOClHo7+tK7avIaA0XpeSqftdE=
|
||||
</data>
|
||||
</dict>
|
||||
<key>flutter_assets/assets/appbar_background.png</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
EhS8+djmZXDI2ucxttToNMvFcA3W1ezHx112CQRIqpw=
|
||||
</data>
|
||||
</dict>
|
||||
<key>flutter_assets/assets/logo.png</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
QQd+B8xc2yWOncyL/vSm9aFtpY4LhK/gaxHds158yCc=
|
||||
</data>
|
||||
</dict>
|
||||
<key>flutter_assets/fonts/MaterialIcons-Regular.otf</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
2YZbZxoJ1oPROoYwidiCXg9ho3aWzl19RIvIAjqmJFM=
|
||||
</data>
|
||||
</dict>
|
||||
<key>flutter_assets/isolate_snapshot_data</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
2xhrt3e9Akh13HCD0k45mouHg3CpgXDn1AwXioeg1PY=
|
||||
</data>
|
||||
</dict>
|
||||
<key>flutter_assets/kernel_blob.bin</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
GQB/lHoxNUJcA5CBiQBdyBuX3jr7Tfbc7Ubr79pH6iM=
|
||||
</data>
|
||||
</dict>
|
||||
<key>flutter_assets/packages/cupertino_icons/assets/CupertinoIcons.ttf</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
Z8RP6Rg7AC553ef2l34piGYcmj5KPF/OloeH79vtgjw=
|
||||
</data>
|
||||
</dict>
|
||||
<key>flutter_assets/shaders/ink_sparkle.frag</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
0T+w183eMSTh5phjUfkXjg4ZpPYnVqkH4Gv3Ge4QCh8=
|
||||
</data>
|
||||
</dict>
|
||||
<key>flutter_assets/vm_snapshot_data</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
6eubeZZqyUNzwtBtT1r66GIIirzwERUZET0Gp6oe/CI=
|
||||
</data>
|
||||
</dict>
|
||||
</dict>
|
||||
<key>rules</key>
|
||||
<dict>
|
||||
<key>^.*</key>
|
||||
<true/>
|
||||
<key>^.*\.lproj/</key>
|
||||
<dict>
|
||||
<key>optional</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>1000</real>
|
||||
</dict>
|
||||
<key>^.*\.lproj/locversion.plist$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>1100</real>
|
||||
</dict>
|
||||
<key>^Base\.lproj/</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>1010</real>
|
||||
</dict>
|
||||
<key>^version.plist$</key>
|
||||
<true/>
|
||||
</dict>
|
||||
<key>rules2</key>
|
||||
<dict>
|
||||
<key>.*\.dSYM($|/)</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>11</real>
|
||||
</dict>
|
||||
<key>^(.*/)?\.DS_Store$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>2000</real>
|
||||
</dict>
|
||||
<key>^.*</key>
|
||||
<true/>
|
||||
<key>^.*\.lproj/</key>
|
||||
<dict>
|
||||
<key>optional</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>1000</real>
|
||||
</dict>
|
||||
<key>^.*\.lproj/locversion.plist$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>1100</real>
|
||||
</dict>
|
||||
<key>^Base\.lproj/</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>1010</real>
|
||||
</dict>
|
||||
<key>^Info\.plist$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>20</real>
|
||||
</dict>
|
||||
<key>^PkgInfo$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>20</real>
|
||||
</dict>
|
||||
<key>^embedded\.provisionprofile$</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>20</real>
|
||||
</dict>
|
||||
<key>^version\.plist$</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>20</real>
|
||||
</dict>
|
||||
</dict>
|
||||
</dict>
|
||||
</plist>
|
||||
|
|
@ -0,0 +1 @@
|
|||
assets/appbar_background.png
asset assets/appbar_background.pngassets/logo.png
assetassets/logo.png2packages/cupertino_icons/assets/CupertinoIcons.ttf
asset2packages/cupertino_icons/assets/CupertinoIcons.ttf
|
||||
|
|
@ -0,0 +1 @@
|
|||
{"assets/appbar_background.png":["assets/appbar_background.png"],"assets/logo.png":["assets/logo.png"],"packages/cupertino_icons/assets/CupertinoIcons.ttf":["packages/cupertino_icons/assets/CupertinoIcons.ttf"]}
|
||||
|
|
@ -0,0 +1 @@
|
|||
[{"family":"MaterialIcons","fonts":[{"asset":"fonts/MaterialIcons-Regular.otf"}]},{"family":"packages/cupertino_icons/CupertinoIcons","fonts":[{"asset":"packages/cupertino_icons/assets/CupertinoIcons.ttf"}]}]
|
||||
Binary file not shown.
Binary file not shown.
|
After Width: | Height: | Size: 4.6 MiB |
Binary file not shown.
|
After Width: | Height: | Size: 4.6 KiB |
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
|
|
@ -0,0 +1,24 @@
|
|||
// 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_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTER_H_
|
||||
#define FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTER_H_
|
||||
|
||||
#import "FlutterAppDelegate.h"
|
||||
#import "FlutterBinaryMessenger.h"
|
||||
#import "FlutterCallbackCache.h"
|
||||
#import "FlutterChannels.h"
|
||||
#import "FlutterCodecs.h"
|
||||
#import "FlutterDartProject.h"
|
||||
#import "FlutterEngine.h"
|
||||
#import "FlutterEngineGroup.h"
|
||||
#import "FlutterHeadlessDartRunner.h"
|
||||
#import "FlutterMacros.h"
|
||||
#import "FlutterPlatformViews.h"
|
||||
#import "FlutterPlugin.h"
|
||||
#import "FlutterPluginAppLifeCycleDelegate.h"
|
||||
#import "FlutterTexture.h"
|
||||
#import "FlutterViewController.h"
|
||||
|
||||
#endif // FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTER_H_
|
||||
|
|
@ -0,0 +1,34 @@
|
|||
// 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_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERAPPDELEGATE_H_
|
||||
#define FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERAPPDELEGATE_H_
|
||||
|
||||
#import <UIKit/UIKit.h>
|
||||
|
||||
#import "FlutterMacros.h"
|
||||
#import "FlutterPlugin.h"
|
||||
|
||||
/**
|
||||
* `UIApplicationDelegate` subclass for simple apps that want default behavior.
|
||||
*
|
||||
* This class implements the following behaviors:
|
||||
* * Status bar touches are forwarded to the key window's root view
|
||||
* `FlutterViewController`, in order to trigger scroll to top.
|
||||
* * Keeps the Flutter connection open in debug mode when the phone screen
|
||||
* locks.
|
||||
*
|
||||
* App delegates for Flutter applications are *not* required to inherit from
|
||||
* this class. Developers of custom app delegate classes should copy and paste
|
||||
* code as necessary from FlutterAppDelegate.mm.
|
||||
*/
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
@interface FlutterAppDelegate
|
||||
: UIResponder <UIApplicationDelegate, FlutterPluginRegistry, FlutterAppLifeCycleProvider>
|
||||
|
||||
@property(strong, nonatomic) UIWindow* window;
|
||||
|
||||
@end
|
||||
|
||||
#endif // FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERAPPDELEGATE_H_
|
||||
|
|
@ -0,0 +1,106 @@
|
|||
// 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_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERBINARYMESSENGER_H_
|
||||
#define FLUTTER_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERBINARYMESSENGER_H_
|
||||
|
||||
#import <Foundation/Foundation.h>
|
||||
|
||||
#import "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);
|
||||
|
||||
typedef int64_t FlutterBinaryMessengerConnection;
|
||||
|
||||
@protocol FlutterTaskQueue <NSObject>
|
||||
@end
|
||||
|
||||
/**
|
||||
* 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_DARWIN_EXPORT
|
||||
@protocol FlutterBinaryMessenger <NSObject>
|
||||
/// TODO(gaaclarke): Remove optional when macos supports Background Platform Channels.
|
||||
@optional
|
||||
- (NSObject<FlutterTaskQueue>*)makeBackgroundTaskQueue;
|
||||
|
||||
- (FlutterBinaryMessengerConnection)
|
||||
setMessageHandlerOnChannel:(NSString*)channel
|
||||
binaryMessageHandler:(FlutterBinaryMessageHandler _Nullable)handler
|
||||
taskQueue:(NSObject<FlutterTaskQueue>* _Nullable)taskQueue;
|
||||
|
||||
@required
|
||||
/**
|
||||
* 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;
|
||||
|
||||
/**
|
||||
* 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.
|
||||
* @return An identifier that represents the connection that was just created to the channel.
|
||||
*/
|
||||
- (FlutterBinaryMessengerConnection)setMessageHandlerOnChannel:(NSString*)channel
|
||||
binaryMessageHandler:
|
||||
(FlutterBinaryMessageHandler _Nullable)handler;
|
||||
|
||||
/**
|
||||
* Clears out a channel's message handler if that handler is still the one that
|
||||
* was created as a result of
|
||||
* `setMessageHandlerOnChannel:binaryMessageHandler:`.
|
||||
*
|
||||
* @param connection The result from `setMessageHandlerOnChannel:binaryMessageHandler:`.
|
||||
*/
|
||||
- (void)cleanUpConnection:(FlutterBinaryMessengerConnection)connection;
|
||||
@end
|
||||
NS_ASSUME_NONNULL_END
|
||||
#endif // FLUTTER_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERBINARYMESSENGER_H_
|
||||
|
|
@ -0,0 +1,54 @@
|
|||
// 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_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERCALLBACKCACHE_H_
|
||||
#define FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERCALLBACKCACHE_H_
|
||||
|
||||
#import <Foundation/Foundation.h>
|
||||
|
||||
#import "FlutterMacros.h"
|
||||
|
||||
/**
|
||||
* An object containing the result of `FlutterCallbackCache`'s `lookupCallbackInformation`
|
||||
* method.
|
||||
*/
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
@interface FlutterCallbackInformation : NSObject
|
||||
/**
|
||||
* The name of the callback.
|
||||
*/
|
||||
@property(copy) NSString* callbackName;
|
||||
/**
|
||||
* The class name of the callback.
|
||||
*/
|
||||
@property(copy) NSString* callbackClassName;
|
||||
/**
|
||||
* The library path of the callback.
|
||||
*/
|
||||
@property(copy) NSString* callbackLibraryPath;
|
||||
@end
|
||||
|
||||
/**
|
||||
* The cache containing callback information for spawning a
|
||||
* `FlutterHeadlessDartRunner`.
|
||||
*/
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
@interface FlutterCallbackCache : NSObject
|
||||
/**
|
||||
* Returns the callback information for the given callback handle.
|
||||
* This callback information can be used when spawning a
|
||||
* `FlutterHeadlessDartRunner`.
|
||||
*
|
||||
* @param handle The handle for a callback, provided by the
|
||||
* Dart method `PluginUtilities.getCallbackHandle`.
|
||||
* @return A `FlutterCallbackInformation` object which contains the name of the
|
||||
* callback, the name of the class in which the callback is defined, and the
|
||||
* path of the library which contains the callback. If the provided handle is
|
||||
* invalid, nil is returned.
|
||||
*/
|
||||
+ (FlutterCallbackInformation*)lookupCallbackInformation:(int64_t)handle;
|
||||
|
||||
@end
|
||||
|
||||
#endif // FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERCALLBACKCACHE_H_
|
||||
|
|
@ -0,0 +1,487 @@
|
|||
// 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_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERCHANNELS_H_
|
||||
#define FLUTTER_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERCHANNELS_H_
|
||||
|
||||
#import "FlutterBinaryMessenger.h"
|
||||
#import "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 which can be invoked from any
|
||||
* thread.
|
||||
*/
|
||||
typedef void (^FlutterMessageHandler)(id _Nullable message, FlutterReply callback);
|
||||
|
||||
/**
|
||||
* A channel for communicating with the Flutter side using basic, asynchronous
|
||||
* message passing.
|
||||
*/
|
||||
FLUTTER_DARWIN_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;
|
||||
|
||||
/**
|
||||
* 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.
|
||||
* @param taskQueue The FlutterTaskQueue that executes the handler (see
|
||||
-[FlutterBinaryMessenger makeBackgroundTaskQueue]).
|
||||
*/
|
||||
- (instancetype)initWithName:(NSString*)name
|
||||
binaryMessenger:(NSObject<FlutterBinaryMessenger>*)messenger
|
||||
codec:(NSObject<FlutterMessageCodec>*)codec
|
||||
taskQueue:(NSObject<FlutterTaskQueue>* _Nullable)taskQueue;
|
||||
|
||||
/**
|
||||
* 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;
|
||||
|
||||
/**
|
||||
* 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;
|
||||
|
||||
/**
|
||||
* Adjusts the number of messages that will get buffered when sending messages to
|
||||
* channels that aren't fully set up yet. For example, the engine isn't running
|
||||
* yet or the channel's message handler isn't set up on the Dart side yet.
|
||||
*
|
||||
* @param name The channel name.
|
||||
* @param messenger The binary messenger.
|
||||
* @param newSize The number of messages that will get buffered.
|
||||
*/
|
||||
+ (void)resizeChannelWithName:(NSString*)name
|
||||
binaryMessenger:(NSObject<FlutterBinaryMessenger>*)messenger
|
||||
size:(NSInteger)newSize;
|
||||
|
||||
/**
|
||||
* Adjusts the number of messages that will get buffered when sending messages to
|
||||
* channels that aren't fully set up yet. For example, the engine isn't running
|
||||
* yet or the channel's message handler isn't set up on the Dart side yet.
|
||||
*
|
||||
* @param newSize The number of messages that will get buffered.
|
||||
*/
|
||||
- (void)resizeChannelBuffer:(NSInteger)newSize;
|
||||
|
||||
/**
|
||||
* Defines whether the channel should show warning messages when discarding messages
|
||||
* due to overflow.
|
||||
*
|
||||
* @param warns When false, the channel is expected to overflow and warning messages
|
||||
* will not be shown.
|
||||
* @param name The channel name.
|
||||
* @param messenger The binary messenger.
|
||||
*/
|
||||
+ (void)setWarnsOnOverflow:(BOOL)warns
|
||||
forChannelWithName:(NSString*)name
|
||||
binaryMessenger:(NSObject<FlutterBinaryMessenger>*)messenger;
|
||||
|
||||
/**
|
||||
* Defines whether the channel should show warning messages when discarding messages
|
||||
* due to overflow.
|
||||
*
|
||||
* @param warns When false, the channel is expected to overflow and warning messages
|
||||
* will not be shown.
|
||||
*/
|
||||
- (void)setWarnsOnOverflow:(BOOL)warns;
|
||||
|
||||
@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. This can be invoked from any thread.
|
||||
*/
|
||||
typedef void (^FlutterMethodCallHandler)(FlutterMethodCall* call, FlutterResult result);
|
||||
|
||||
/**
|
||||
* A constant used with `FlutterMethodCallHandler` to respond to the call of an
|
||||
* unknown method.
|
||||
*/
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
extern NSObject const* FlutterMethodNotImplemented;
|
||||
|
||||
/**
|
||||
* A channel for communicating with the Flutter side using invocation of
|
||||
* asynchronous methods.
|
||||
*/
|
||||
FLUTTER_DARWIN_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;
|
||||
|
||||
/**
|
||||
* Initializes a `FlutterMethodChannel` with the specified name, binary messenger,
|
||||
* method codec, and task queue.
|
||||
*
|
||||
* 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.
|
||||
* @param taskQueue The FlutterTaskQueue that executes the handler (see
|
||||
-[FlutterBinaryMessenger makeBackgroundTaskQueue]).
|
||||
*/
|
||||
- (instancetype)initWithName:(NSString*)name
|
||||
binaryMessenger:(NSObject<FlutterBinaryMessenger>*)messenger
|
||||
codec:(NSObject<FlutterMethodCodec>*)codec
|
||||
taskQueue:(NSObject<FlutterTaskQueue>* _Nullable)taskQueue;
|
||||
|
||||
// clang-format off
|
||||
/**
|
||||
* Invokes the specified Flutter method with the specified arguments, expecting
|
||||
* no results.
|
||||
*
|
||||
* @see [MethodChannel.setMethodCallHandler](https://api.flutter.dev/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;
|
||||
/**
|
||||
* 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;
|
||||
|
||||
/**
|
||||
* Adjusts the number of messages that will get buffered when sending messages to
|
||||
* channels that aren't fully set up yet. For example, the engine isn't running
|
||||
* yet or the channel's message handler isn't set up on the Dart side yet.
|
||||
*/
|
||||
- (void)resizeChannelBuffer:(NSInteger)newSize;
|
||||
|
||||
@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_DARWIN_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_DARWIN_EXPORT
|
||||
extern NSObject const* FlutterEndOfEventStream;
|
||||
|
||||
/**
|
||||
* A channel for communicating with the Flutter side using event streams.
|
||||
*/
|
||||
FLUTTER_DARWIN_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;
|
||||
|
||||
/**
|
||||
* Initializes a `FlutterEventChannel` with the specified name, binary messenger,
|
||||
* method codec and task queue.
|
||||
*
|
||||
* 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.
|
||||
* @param taskQueue The FlutterTaskQueue that executes the handler (see
|
||||
-[FlutterBinaryMessenger makeBackgroundTaskQueue]).
|
||||
*/
|
||||
- (instancetype)initWithName:(NSString*)name
|
||||
binaryMessenger:(NSObject<FlutterBinaryMessenger>*)messenger
|
||||
codec:(NSObject<FlutterMethodCodec>*)codec
|
||||
taskQueue:(NSObject<FlutterTaskQueue>* _Nullable)taskQueue;
|
||||
/**
|
||||
* 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_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERCHANNELS_H_
|
||||
|
|
@ -0,0 +1,478 @@
|
|||
// 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_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERCODECS_H_
|
||||
#define FLUTTER_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERCODECS_H_
|
||||
|
||||
#import <Foundation/Foundation.h>
|
||||
|
||||
#import "FlutterMacros.h"
|
||||
|
||||
NS_ASSUME_NONNULL_BEGIN
|
||||
|
||||
/**
|
||||
* A message encoding/decoding mechanism.
|
||||
*/
|
||||
FLUTTER_DARWIN_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://api.flutter.dev/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_DARWIN_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://api.flutter.dev/flutter/services/StringCodec-class.html)
|
||||
* on the Dart side. These parts of the Flutter SDK are evolved synchronously.
|
||||
*/
|
||||
FLUTTER_DARWIN_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://api.flutter.dev/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_DARWIN_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_DARWIN_EXPORT
|
||||
@interface FlutterStandardWriter : NSObject
|
||||
/**
|
||||
* Create a `FlutterStandardWriter` who will write to \p data.
|
||||
*/
|
||||
- (instancetype)initWithData:(NSMutableData*)data;
|
||||
/** Write a 8-bit byte. */
|
||||
- (void)writeByte:(UInt8)value;
|
||||
/** Write an array of \p bytes of size \p length. */
|
||||
- (void)writeBytes:(const void*)bytes length:(NSUInteger)length;
|
||||
/** Write an array of bytes contained in \p data. */
|
||||
- (void)writeData:(NSData*)data;
|
||||
/** Write 32-bit unsigned integer that represents a \p size of a collection. */
|
||||
- (void)writeSize:(UInt32)size;
|
||||
/** Write zero padding until data is aligned with \p alignment. */
|
||||
- (void)writeAlignment:(UInt8)alignment;
|
||||
/** Write a string with UTF-8 encoding. */
|
||||
- (void)writeUTF8:(NSString*)value;
|
||||
/** Introspects into an object and writes its representation.
|
||||
*
|
||||
* Supported Data Types:
|
||||
* - NSNull
|
||||
* - NSNumber
|
||||
* - NSString (as UTF-8)
|
||||
* - FlutterStandardTypedData
|
||||
* - NSArray of supported types
|
||||
* - NSDictionary of supporte types
|
||||
*
|
||||
* NSAsserts on failure.
|
||||
*/
|
||||
- (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_DARWIN_EXPORT
|
||||
@interface FlutterStandardReader : NSObject
|
||||
/**
|
||||
* Create a new `FlutterStandardReader` who reads from \p data.
|
||||
*/
|
||||
- (instancetype)initWithData:(NSData*)data;
|
||||
/** Returns YES when the reader hasn't reached the end of its data. */
|
||||
- (BOOL)hasMore;
|
||||
/** Reads a byte value and increments the position. */
|
||||
- (UInt8)readByte;
|
||||
/** Reads a sequence of byte values of \p length and increments the position. */
|
||||
- (void)readBytes:(void*)destination length:(NSUInteger)length;
|
||||
/** Reads a sequence of byte values of \p length and increments the position. */
|
||||
- (NSData*)readData:(NSUInteger)length;
|
||||
/** Reads a 32-bit unsigned integer representing a collection size and increments the position.*/
|
||||
- (UInt32)readSize;
|
||||
/** Advances the read position until it is aligned with \p alignment. */
|
||||
- (void)readAlignment:(UInt8)alignment;
|
||||
/** Read a null terminated string encoded with UTF-8/ */
|
||||
- (NSString*)readUTF8;
|
||||
/**
|
||||
* Reads a byte for `FlutterStandardField` the decodes a value matching that type.
|
||||
*
|
||||
* See also: -[FlutterStandardWriter writeValue]
|
||||
*/
|
||||
- (nullable id)readValue;
|
||||
/**
|
||||
* Decodes a value matching the \p type specified.
|
||||
*
|
||||
* See also:
|
||||
* - `FlutterStandardField`
|
||||
* - `-[FlutterStandardWriter writeValue]`
|
||||
*/
|
||||
- (nullable id)readValueOfType:(UInt8)type;
|
||||
@end
|
||||
|
||||
/**
|
||||
* A factory of compatible reader/writer instances using the Flutter standard
|
||||
* binary encoding or extensions thereof.
|
||||
*/
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
@interface FlutterStandardReaderWriter : NSObject
|
||||
/**
|
||||
* Create a new `FlutterStandardWriter` for writing to \p data.
|
||||
*/
|
||||
- (FlutterStandardWriter*)writerWithData:(NSMutableData*)data;
|
||||
/**
|
||||
* Create a new `FlutterStandardReader` for reading from \p 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://api.flutter.dev/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_DARWIN_EXPORT
|
||||
@interface FlutterStandardMessageCodec : NSObject <FlutterMessageCodec>
|
||||
/**
|
||||
* Create a `FlutterStandardMessageCodec` who will read and write to \p readerWriter.
|
||||
*/
|
||||
+ (instancetype)codecWithReaderWriter:(FlutterStandardReaderWriter*)readerWriter;
|
||||
@end
|
||||
|
||||
/**
|
||||
* Command object representing a method call on a `FlutterMethodChannel`.
|
||||
*/
|
||||
FLUTTER_DARWIN_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_DARWIN_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) {
|
||||
// NOLINTBEGIN(readability-identifier-naming)
|
||||
FlutterStandardDataTypeUInt8,
|
||||
FlutterStandardDataTypeInt32,
|
||||
FlutterStandardDataTypeInt64,
|
||||
FlutterStandardDataTypeFloat32,
|
||||
FlutterStandardDataTypeFloat64,
|
||||
// NOLINTEND(readability-identifier-naming)
|
||||
};
|
||||
|
||||
/**
|
||||
* 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_DARWIN_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 32-bit floats.
|
||||
*
|
||||
* @param data the byte data. The length must be divisible by 8.
|
||||
*/
|
||||
+ (instancetype)typedDataWithFloat32:(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, assign) FlutterStandardDataType type;
|
||||
|
||||
/**
|
||||
* The number of value items encoded.
|
||||
*/
|
||||
@property(readonly, nonatomic, assign) UInt32 elementCount;
|
||||
|
||||
/**
|
||||
* The number of bytes used by the encoding of a single value item.
|
||||
*/
|
||||
@property(readonly, nonatomic, assign) UInt8 elementSize;
|
||||
@end
|
||||
|
||||
/**
|
||||
* An arbitrarily large integer value, used with `FlutterStandardMessageCodec`
|
||||
* and `FlutterStandardMethodCodec`.
|
||||
*/
|
||||
FLUTTER_DARWIN_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_DARWIN_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://api.flutter.dev/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_DARWIN_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://api.flutter.dev/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_DARWIN_EXPORT
|
||||
@interface FlutterStandardMethodCodec : NSObject <FlutterMethodCodec>
|
||||
/**
|
||||
* Create a `FlutterStandardMethodCodec` who will read and write to \p readerWriter.
|
||||
*/
|
||||
+ (instancetype)codecWithReaderWriter:(FlutterStandardReaderWriter*)readerWriter;
|
||||
@end
|
||||
|
||||
NS_ASSUME_NONNULL_END
|
||||
|
||||
#endif // FLUTTER_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERCODECS_H_
|
||||
|
|
@ -0,0 +1,103 @@
|
|||
// 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_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERDARTPROJECT_H_
|
||||
#define FLUTTER_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERDARTPROJECT_H_
|
||||
|
||||
#import <Foundation/Foundation.h>
|
||||
#import <TargetConditionals.h>
|
||||
|
||||
#import "FlutterMacros.h"
|
||||
|
||||
NS_ASSUME_NONNULL_BEGIN
|
||||
|
||||
/**
|
||||
* A set of Flutter and Dart assets used by a `FlutterEngine` to initialize execution.
|
||||
*
|
||||
*/
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
@interface FlutterDartProject : NSObject
|
||||
|
||||
/**
|
||||
* Initializes a Flutter Dart project from a bundle.
|
||||
*
|
||||
* The bundle must either contain a flutter_assets resource directory, or set the Info.plist key
|
||||
* FLTAssetsPath to override that name (if you are doing a custom build using a different name).
|
||||
*
|
||||
* @param bundle The bundle containing the Flutter assets directory. If nil, the App framework
|
||||
* created by Flutter will be used.
|
||||
*/
|
||||
- (instancetype)initWithPrecompiledDartBundle:(nullable NSBundle*)bundle NS_DESIGNATED_INITIALIZER;
|
||||
/**
|
||||
* Unavailable - use `init` instead.
|
||||
*/
|
||||
- (instancetype)initFromDefaultSourceForConfiguration API_UNAVAILABLE(macos)
|
||||
FLUTTER_UNAVAILABLE("Use -init instead.");
|
||||
|
||||
/**
|
||||
* Returns the default identifier for the bundle where we expect to find the Flutter Dart
|
||||
* application.
|
||||
*/
|
||||
+ (NSString*)defaultBundleIdentifier;
|
||||
|
||||
/**
|
||||
* An NSArray of NSStrings to be passed as command line arguments to the Dart entrypoint.
|
||||
*
|
||||
* If this is not explicitly set, this will default to the contents of
|
||||
* [NSProcessInfo arguments], without the binary name.
|
||||
*
|
||||
* Set this to nil to pass no arguments to the Dart entrypoint.
|
||||
*/
|
||||
@property(nonatomic, nullable, copy)
|
||||
NSArray<NSString*>* dartEntrypointArguments API_UNAVAILABLE(ios);
|
||||
|
||||
/**
|
||||
* Returns the file name for the given asset. If the bundle with the identifier
|
||||
* "io.flutter.flutter.app" exists, it will try use that bundle; otherwise, it
|
||||
* will use the main bundle. To specify a different bundle, use
|
||||
* `+lookupKeyForAsset:fromBundle`.
|
||||
*
|
||||
* @param asset The name of the asset. The name can be hierarchical.
|
||||
* @return the file name to be used for lookup in the main bundle.
|
||||
*/
|
||||
+ (NSString*)lookupKeyForAsset:(NSString*)asset;
|
||||
|
||||
/**
|
||||
* Returns the file name for the given asset.
|
||||
* The returned file name can be used to access the asset in the supplied bundle.
|
||||
*
|
||||
* @param asset The name of the asset. The name can be hierarchical.
|
||||
* @param bundle The `NSBundle` to use for looking up the asset.
|
||||
* @return the file name to be used for lookup in the main bundle.
|
||||
*/
|
||||
+ (NSString*)lookupKeyForAsset:(NSString*)asset fromBundle:(nullable NSBundle*)bundle;
|
||||
|
||||
/**
|
||||
* Returns the file name for the given asset which originates from the specified package.
|
||||
* The returned file name can be used to access the asset in the application's main bundle.
|
||||
*
|
||||
* @param asset The name of the asset. The name can be hierarchical.
|
||||
* @param package The name of the package from which the asset originates.
|
||||
* @return the file name to be used for lookup in the main bundle.
|
||||
*/
|
||||
+ (NSString*)lookupKeyForAsset:(NSString*)asset fromPackage:(NSString*)package;
|
||||
|
||||
/**
|
||||
* Returns the file name for the given asset which originates from the specified package.
|
||||
* The returned file name can be used to access the asset in the specified bundle.
|
||||
*
|
||||
* @param asset The name of the asset. The name can be hierarchical.
|
||||
* @param package The name of the package from which the asset originates.
|
||||
* @param bundle The bundle to use when doing the lookup.
|
||||
* @return the file name to be used for lookup in the main bundle.
|
||||
*/
|
||||
+ (NSString*)lookupKeyForAsset:(NSString*)asset
|
||||
fromPackage:(NSString*)package
|
||||
fromBundle:(nullable NSBundle*)bundle;
|
||||
|
||||
@end
|
||||
|
||||
NS_ASSUME_NONNULL_END
|
||||
|
||||
#endif // FLUTTER_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERDARTPROJECT_H_
|
||||
|
|
@ -0,0 +1,462 @@
|
|||
// 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_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERENGINE_H_
|
||||
#define FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERENGINE_H_
|
||||
|
||||
#import <Foundation/Foundation.h>
|
||||
#import <UIKit/UIKit.h>
|
||||
|
||||
#import "FlutterBinaryMessenger.h"
|
||||
#import "FlutterDartProject.h"
|
||||
#import "FlutterMacros.h"
|
||||
#import "FlutterPlugin.h"
|
||||
#import "FlutterTexture.h"
|
||||
|
||||
@class FlutterViewController;
|
||||
|
||||
NS_ASSUME_NONNULL_BEGIN
|
||||
|
||||
/**
|
||||
* The dart entrypoint that is associated with `main()`. This is to be used as an argument to the
|
||||
* `runWithEntrypoint*` methods.
|
||||
*/
|
||||
// NOLINTNEXTLINE(readability-identifier-naming)
|
||||
extern NSString* const FlutterDefaultDartEntrypoint;
|
||||
|
||||
/**
|
||||
* The default Flutter initial route ("/").
|
||||
*/
|
||||
// NOLINTNEXTLINE(readability-identifier-naming)
|
||||
extern NSString* const FlutterDefaultInitialRoute;
|
||||
|
||||
/**
|
||||
* The FlutterEngine class coordinates a single instance of execution for a
|
||||
* `FlutterDartProject`. It may have zero or one `FlutterViewController` at a
|
||||
* time, which can be specified via `-setViewController:`.
|
||||
* `FlutterViewController`'s `initWithEngine` initializer will automatically call
|
||||
* `-setViewController:` for itself.
|
||||
*
|
||||
* A FlutterEngine can be created independently of a `FlutterViewController` for
|
||||
* headless execution. It can also persist across the lifespan of multiple
|
||||
* `FlutterViewController` instances to maintain state and/or asynchronous tasks
|
||||
* (such as downloading a large file).
|
||||
*
|
||||
* A FlutterEngine can also be used to prewarm the Dart execution environment and reduce the
|
||||
* latency of showing the Flutter screen when a `FlutterViewController` is created and presented.
|
||||
* See http://flutter.dev/docs/development/add-to-app/performance for more details on loading
|
||||
* performance.
|
||||
*
|
||||
* Alternatively, you can simply create a new `FlutterViewController` with only a
|
||||
* `FlutterDartProject`. That `FlutterViewController` will internally manage its
|
||||
* own instance of a FlutterEngine, but will not guarantee survival of the engine
|
||||
* beyond the life of the ViewController.
|
||||
*
|
||||
* A newly initialized FlutterEngine will not actually run a Dart Isolate until
|
||||
* either `-runWithEntrypoint:` or `-runWithEntrypoint:libraryURI` is invoked.
|
||||
* One of these methods must be invoked before calling `-setViewController:`.
|
||||
*/
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
@interface FlutterEngine : NSObject <FlutterPluginRegistry>
|
||||
|
||||
/**
|
||||
* Default initializer for a FlutterEngine.
|
||||
*
|
||||
* Threads created by this FlutterEngine will appear as "FlutterEngine #" in
|
||||
* Instruments. The prefix can be customized using `initWithName`.
|
||||
*
|
||||
* The engine will execute the project located in the bundle with the identifier
|
||||
* "io.flutter.flutter.app" (the default for Flutter projects).
|
||||
*
|
||||
* A newly initialized engine will not run until either `-runWithEntrypoint:` or
|
||||
* `-runWithEntrypoint:libraryURI:` is called.
|
||||
*
|
||||
* FlutterEngine created with this method will have allowHeadlessExecution set to `YES`.
|
||||
* This means that the engine will continue to run regardless of whether a `FlutterViewController`
|
||||
* is attached to it or not, until `-destroyContext:` is called or the process finishes.
|
||||
*/
|
||||
- (instancetype)init;
|
||||
|
||||
/**
|
||||
* Initialize this FlutterEngine.
|
||||
*
|
||||
* The engine will execute the project located in the bundle with the identifier
|
||||
* "io.flutter.flutter.app" (the default for Flutter projects).
|
||||
*
|
||||
* A newly initialized engine will not run until either `-runWithEntrypoint:` or
|
||||
* `-runWithEntrypoint:libraryURI:` is called.
|
||||
*
|
||||
* FlutterEngine created with this method will have allowHeadlessExecution set to `YES`.
|
||||
* This means that the engine will continue to run regardless of whether a `FlutterViewController`
|
||||
* is attached to it or not, until `-destroyContext:` is called or the process finishes.
|
||||
*
|
||||
* @param labelPrefix The label prefix used to identify threads for this instance. Should
|
||||
* be unique across FlutterEngine instances, and is used in instrumentation to label
|
||||
* the threads used by this FlutterEngine.
|
||||
*/
|
||||
- (instancetype)initWithName:(NSString*)labelPrefix;
|
||||
|
||||
/**
|
||||
* Initialize this FlutterEngine with a `FlutterDartProject`.
|
||||
*
|
||||
* If the FlutterDartProject is not specified, the FlutterEngine will attempt to locate
|
||||
* the project in a default location (the flutter_assets folder in the iOS application
|
||||
* bundle).
|
||||
*
|
||||
* A newly initialized engine will not run the `FlutterDartProject` until either
|
||||
* `-runWithEntrypoint:` or `-runWithEntrypoint:libraryURI:` is called.
|
||||
*
|
||||
* FlutterEngine created with this method will have allowHeadlessExecution set to `YES`.
|
||||
* This means that the engine will continue to run regardless of whether a `FlutterViewController`
|
||||
* is attached to it or not, until `-destroyContext:` is called or the process finishes.
|
||||
*
|
||||
* @param labelPrefix The label prefix used to identify threads for this instance. Should
|
||||
* be unique across FlutterEngine instances, and is used in instrumentation to label
|
||||
* the threads used by this FlutterEngine.
|
||||
* @param project The `FlutterDartProject` to run.
|
||||
*/
|
||||
- (instancetype)initWithName:(NSString*)labelPrefix project:(nullable FlutterDartProject*)project;
|
||||
|
||||
/**
|
||||
* Initialize this FlutterEngine with a `FlutterDartProject`.
|
||||
*
|
||||
* If the FlutterDartProject is not specified, the FlutterEngine will attempt to locate
|
||||
* the project in a default location (the flutter_assets folder in the iOS application
|
||||
* bundle).
|
||||
*
|
||||
* A newly initialized engine will not run the `FlutterDartProject` until either
|
||||
* `-runWithEntrypoint:` or `-runWithEntrypoint:libraryURI:` is called.
|
||||
*
|
||||
* @param labelPrefix The label prefix used to identify threads for this instance. Should
|
||||
* be unique across FlutterEngine instances, and is used in instrumentation to label
|
||||
* the threads used by this FlutterEngine.
|
||||
* @param project The `FlutterDartProject` to run.
|
||||
* @param allowHeadlessExecution Whether or not to allow this instance to continue
|
||||
* running after passing a nil `FlutterViewController` to `-setViewController:`.
|
||||
*/
|
||||
- (instancetype)initWithName:(NSString*)labelPrefix
|
||||
project:(nullable FlutterDartProject*)project
|
||||
allowHeadlessExecution:(BOOL)allowHeadlessExecution;
|
||||
|
||||
/**
|
||||
* Initialize this FlutterEngine with a `FlutterDartProject`.
|
||||
*
|
||||
* If the FlutterDartProject is not specified, the FlutterEngine will attempt to locate
|
||||
* the project in a default location (the flutter_assets folder in the iOS application
|
||||
* bundle).
|
||||
*
|
||||
* A newly initialized engine will not run the `FlutterDartProject` until either
|
||||
* `-runWithEntrypoint:` or `-runWithEntrypoint:libraryURI:` is called.
|
||||
*
|
||||
* @param labelPrefix The label prefix used to identify threads for this instance. Should
|
||||
* be unique across FlutterEngine instances, and is used in instrumentation to label
|
||||
* the threads used by this FlutterEngine.
|
||||
* @param project The `FlutterDartProject` to run.
|
||||
* @param allowHeadlessExecution Whether or not to allow this instance to continue
|
||||
* running after passing a nil `FlutterViewController` to `-setViewController:`.
|
||||
* @param restorationEnabled Whether state restoration is enabled. When true, the framework will
|
||||
* wait for the attached view controller to provide restoration data.
|
||||
*/
|
||||
- (instancetype)initWithName:(NSString*)labelPrefix
|
||||
project:(nullable FlutterDartProject*)project
|
||||
allowHeadlessExecution:(BOOL)allowHeadlessExecution
|
||||
restorationEnabled:(BOOL)restorationEnabled NS_DESIGNATED_INITIALIZER;
|
||||
|
||||
/**
|
||||
* Runs a Dart program on an Isolate from the main Dart library (i.e. the library that
|
||||
* contains `main()`), using `main()` as the entrypoint (the default for Flutter projects),
|
||||
* and using "/" (the default route) as the initial route.
|
||||
*
|
||||
* The first call to this method will create a new Isolate. Subsequent calls will return
|
||||
* immediately and have no effect.
|
||||
*
|
||||
* @return YES if the call succeeds in creating and running a Flutter Engine instance; NO otherwise.
|
||||
*/
|
||||
- (BOOL)run;
|
||||
|
||||
/**
|
||||
* Runs a Dart program on an Isolate from the main Dart library (i.e. the library that
|
||||
* contains `main()`), using "/" (the default route) as the initial route.
|
||||
*
|
||||
* The first call to this method will create a new Isolate. Subsequent calls will return
|
||||
* immediately and have no effect.
|
||||
*
|
||||
* @param entrypoint The name of a top-level function from the same Dart
|
||||
* library that contains the app's main() function. If this is FlutterDefaultDartEntrypoint (or
|
||||
* nil) it will default to `main()`. If it is not the app's main() function, that function must
|
||||
* be decorated with `@pragma(vm:entry-point)` to ensure the method is not tree-shaken by the Dart
|
||||
* compiler.
|
||||
* @return YES if the call succeeds in creating and running a Flutter Engine instance; NO otherwise.
|
||||
*/
|
||||
- (BOOL)runWithEntrypoint:(nullable NSString*)entrypoint;
|
||||
|
||||
/**
|
||||
* Runs a Dart program on an Isolate from the main Dart library (i.e. the library that
|
||||
* contains `main()`).
|
||||
*
|
||||
* The first call to this method will create a new Isolate. Subsequent calls will return
|
||||
* immediately and have no effect.
|
||||
*
|
||||
* @param entrypoint The name of a top-level function from the same Dart
|
||||
* library that contains the app's main() function. If this is FlutterDefaultDartEntrypoint (or
|
||||
* nil), it will default to `main()`. If it is not the app's main() function, that function must
|
||||
* be decorated with `@pragma(vm:entry-point)` to ensure the method is not tree-shaken by the Dart
|
||||
* compiler.
|
||||
* @param initialRoute The name of the initial Flutter `Navigator` `Route` to load. If this is
|
||||
* FlutterDefaultInitialRoute (or nil), it will default to the "/" route.
|
||||
* @return YES if the call succeeds in creating and running a Flutter Engine instance; NO otherwise.
|
||||
*/
|
||||
- (BOOL)runWithEntrypoint:(nullable NSString*)entrypoint
|
||||
initialRoute:(nullable NSString*)initialRoute;
|
||||
|
||||
/**
|
||||
* Runs a Dart program on an Isolate using the specified entrypoint and Dart library,
|
||||
* which may not be the same as the library containing the Dart program's `main()` function.
|
||||
*
|
||||
* The first call to this method will create a new Isolate. Subsequent calls will return
|
||||
* immediately and have no effect.
|
||||
*
|
||||
* @param entrypoint The name of a top-level function from a Dart library. If this is
|
||||
* FlutterDefaultDartEntrypoint (or nil); this will default to `main()`. If it is not the app's
|
||||
* main() function, that function must be decorated with `@pragma(vm:entry-point)` to ensure the
|
||||
* method is not tree-shaken by the Dart compiler.
|
||||
* @param uri The URI of the Dart library which contains the entrypoint method
|
||||
* (example "package:foo_package/main.dart"). If nil, this will default to
|
||||
* the same library as the `main()` function in the Dart program.
|
||||
* @return YES if the call succeeds in creating and running a Flutter Engine instance; NO otherwise.
|
||||
*/
|
||||
- (BOOL)runWithEntrypoint:(nullable NSString*)entrypoint libraryURI:(nullable NSString*)uri;
|
||||
|
||||
/**
|
||||
* Runs a Dart program on an Isolate using the specified entrypoint and Dart library,
|
||||
* which may not be the same as the library containing the Dart program's `main()` function.
|
||||
*
|
||||
* The first call to this method will create a new Isolate. Subsequent calls will return
|
||||
* immediately and have no effect.
|
||||
*
|
||||
* @param entrypoint The name of a top-level function from a Dart library. If this is
|
||||
* FlutterDefaultDartEntrypoint (or nil); this will default to `main()`. If it is not the app's
|
||||
* main() function, that function must be decorated with `@pragma(vm:entry-point)` to ensure the
|
||||
* method is not tree-shaken by the Dart compiler.
|
||||
* @param libraryURI The URI of the Dart library which contains the entrypoint
|
||||
* method (example "package:foo_package/main.dart"). If nil, this will
|
||||
* default to the same library as the `main()` function in the Dart program.
|
||||
* @param initialRoute The name of the initial Flutter `Navigator` `Route` to load. If this is
|
||||
* FlutterDefaultInitialRoute (or nil), it will default to the "/" route.
|
||||
* @return YES if the call succeeds in creating and running a Flutter Engine instance; NO otherwise.
|
||||
*/
|
||||
- (BOOL)runWithEntrypoint:(nullable NSString*)entrypoint
|
||||
libraryURI:(nullable NSString*)libraryURI
|
||||
initialRoute:(nullable NSString*)initialRoute;
|
||||
|
||||
/**
|
||||
* Runs a Dart program on an Isolate using the specified entrypoint and Dart library,
|
||||
* which may not be the same as the library containing the Dart program's `main()` function.
|
||||
*
|
||||
* The first call to this method will create a new Isolate. Subsequent calls will return
|
||||
* immediately and have no effect.
|
||||
*
|
||||
* @param entrypoint The name of a top-level function from a Dart library. If this is
|
||||
* FlutterDefaultDartEntrypoint (or nil); this will default to `main()`. If it is not the app's
|
||||
* main() function, that function must be decorated with `@pragma(vm:entry-point)` to ensure the
|
||||
* method is not tree-shaken by the Dart compiler.
|
||||
* @param libraryURI The URI of the Dart library which contains the entrypoint
|
||||
* method (example "package:foo_package/main.dart"). If nil, this will
|
||||
* default to the same library as the `main()` function in the Dart program.
|
||||
* @param initialRoute The name of the initial Flutter `Navigator` `Route` to load. If this is
|
||||
* FlutterDefaultInitialRoute (or nil), it will default to the "/" route.
|
||||
* @param entrypointArgs Arguments passed as a list of string to Dart's entrypoint function.
|
||||
* @return YES if the call succeeds in creating and running a Flutter Engine instance; NO otherwise.
|
||||
*/
|
||||
- (BOOL)runWithEntrypoint:(nullable NSString*)entrypoint
|
||||
libraryURI:(nullable NSString*)libraryURI
|
||||
initialRoute:(nullable NSString*)initialRoute
|
||||
entrypointArgs:(nullable NSArray<NSString*>*)entrypointArgs;
|
||||
|
||||
/**
|
||||
* Destroy running context for an engine.
|
||||
*
|
||||
* This method can be used to force the FlutterEngine object to release all resources.
|
||||
* After sending this message, the object will be in an unusable state until it is deallocated.
|
||||
* Accessing properties or sending messages to it will result in undefined behavior or runtime
|
||||
* errors.
|
||||
*/
|
||||
- (void)destroyContext;
|
||||
|
||||
/**
|
||||
* Ensures that Flutter will generate a semantics tree.
|
||||
*
|
||||
* This is enabled by default if certain accessibility services are turned on by
|
||||
* the user, or when using a Simulator. This method allows a user to turn
|
||||
* semantics on when they would not ordinarily be generated and the performance
|
||||
* overhead is not a concern, e.g. for UI testing. Note that semantics should
|
||||
* never be programmatically turned off, as it would potentially disable
|
||||
* accessibility services an end user has requested.
|
||||
*
|
||||
* This method must only be called after launching the engine via
|
||||
* `-runWithEntrypoint:` or `-runWithEntryPoint:libraryURI`.
|
||||
*
|
||||
* Although this method returns synchronously, it does not guarantee that a
|
||||
* semantics tree is actually available when the method returns. It
|
||||
* synchronously ensures that the next frame the Flutter framework creates will
|
||||
* have a semantics tree.
|
||||
*
|
||||
* You can subscribe to semantics updates via `NSNotificationCenter` by adding
|
||||
* an observer for the name `FlutterSemanticsUpdateNotification`. The `object`
|
||||
* parameter will be the `FlutterViewController` associated with the semantics
|
||||
* update. This will asynchronously fire after a semantics tree has actually
|
||||
* built (which may be some time after the frame has been rendered).
|
||||
*/
|
||||
- (void)ensureSemanticsEnabled;
|
||||
|
||||
/**
|
||||
* Sets the `FlutterViewController` for this instance. The FlutterEngine must be
|
||||
* running (e.g. a successful call to `-runWithEntrypoint:` or `-runWithEntrypoint:libraryURI`)
|
||||
* before calling this method. Callers may pass nil to remove the viewController
|
||||
* and have the engine run headless in the current process.
|
||||
*
|
||||
* A FlutterEngine can only have one `FlutterViewController` at a time. If there is
|
||||
* already a `FlutterViewController` associated with this instance, this method will replace
|
||||
* the engine's current viewController with the newly specified one.
|
||||
*
|
||||
* Setting the viewController will signal the engine to start animations and drawing, and unsetting
|
||||
* it will signal the engine to stop animations and drawing. However, neither will impact the state
|
||||
* of the Dart program's execution.
|
||||
*/
|
||||
@property(nonatomic, weak) FlutterViewController* viewController;
|
||||
|
||||
/**
|
||||
* The `FlutterMethodChannel` used for localization related platform messages, such as
|
||||
* setting the locale.
|
||||
*
|
||||
* Can be nil after `destroyContext` is called.
|
||||
*/
|
||||
@property(nonatomic, readonly, nullable) FlutterMethodChannel* localizationChannel;
|
||||
/**
|
||||
* The `FlutterMethodChannel` used for navigation related platform messages.
|
||||
*
|
||||
* Can be nil after `destroyContext` is called.
|
||||
*
|
||||
* @see [Navigation
|
||||
* Channel](https://api.flutter.dev/flutter/services/SystemChannels/navigation-constant.html)
|
||||
* @see [Navigator Widget](https://api.flutter.dev/flutter/widgets/Navigator-class.html)
|
||||
*/
|
||||
@property(nonatomic, readonly) FlutterMethodChannel* navigationChannel;
|
||||
|
||||
/**
|
||||
* The `FlutterMethodChannel` used for restoration related platform messages.
|
||||
*
|
||||
* Can be nil after `destroyContext` is called.
|
||||
*
|
||||
* @see [Restoration
|
||||
* Channel](https://api.flutter.dev/flutter/services/SystemChannels/restoration-constant.html)
|
||||
*/
|
||||
@property(nonatomic, readonly) FlutterMethodChannel* restorationChannel;
|
||||
|
||||
/**
|
||||
* The `FlutterMethodChannel` used for core platform messages, such as
|
||||
* information about the screen orientation.
|
||||
*
|
||||
* Can be nil after `destroyContext` is called.
|
||||
*/
|
||||
@property(nonatomic, readonly) FlutterMethodChannel* platformChannel;
|
||||
|
||||
/**
|
||||
* The `FlutterMethodChannel` used to communicate text input events to the
|
||||
* Dart Isolate.
|
||||
*
|
||||
* Can be nil after `destroyContext` is called.
|
||||
*
|
||||
* @see [Text Input
|
||||
* Channel](https://api.flutter.dev/flutter/services/SystemChannels/textInput-constant.html)
|
||||
*/
|
||||
@property(nonatomic, readonly) FlutterMethodChannel* textInputChannel;
|
||||
|
||||
/**
|
||||
* The `FlutterBasicMessageChannel` used to communicate app lifecycle events
|
||||
* to the Dart Isolate.
|
||||
*
|
||||
* Can be nil after `destroyContext` is called.
|
||||
*
|
||||
* @see [Lifecycle
|
||||
* Channel](https://api.flutter.dev/flutter/services/SystemChannels/lifecycle-constant.html)
|
||||
*/
|
||||
@property(nonatomic, readonly) FlutterBasicMessageChannel* lifecycleChannel;
|
||||
|
||||
/**
|
||||
* The `FlutterBasicMessageChannel` used for communicating system events, such as
|
||||
* memory pressure events.
|
||||
*
|
||||
* Can be nil after `destroyContext` is called.
|
||||
*
|
||||
* @see [System
|
||||
* Channel](https://api.flutter.dev/flutter/services/SystemChannels/system-constant.html)
|
||||
*/
|
||||
@property(nonatomic, readonly) FlutterBasicMessageChannel* systemChannel;
|
||||
|
||||
/**
|
||||
* The `FlutterBasicMessageChannel` used for communicating user settings such as
|
||||
* clock format and text scale.
|
||||
*
|
||||
* Can be nil after `destroyContext` is called.
|
||||
*/
|
||||
@property(nonatomic, readonly) FlutterBasicMessageChannel* settingsChannel;
|
||||
|
||||
/**
|
||||
* The `FlutterBasicMessageChannel` used for communicating key events
|
||||
* from physical keyboards
|
||||
*
|
||||
* Can be nil after `destroyContext` is called.
|
||||
*/
|
||||
@property(nonatomic, readonly) FlutterBasicMessageChannel* keyEventChannel;
|
||||
|
||||
/**
|
||||
* The depcreated `NSURL` of the Dart VM Service for the service isolate.
|
||||
*
|
||||
* This is only set in debug and profile runtime modes, and only after the
|
||||
* Dart VM Service is ready. In release mode or before the Dart VM Service has
|
||||
* started, it returns `nil`.
|
||||
*/
|
||||
@property(nonatomic, readonly, nullable)
|
||||
NSURL* observatoryUrl FLUTTER_DEPRECATED("Use vmServiceUrl instead");
|
||||
|
||||
/**
|
||||
* The `NSURL` of the Dart VM Service for the service isolate.
|
||||
*
|
||||
* This is only set in debug and profile runtime modes, and only after the
|
||||
* Dart VM Service is ready. In release mode or before the Dart VM Service has
|
||||
* started, it returns `nil`.
|
||||
*/
|
||||
@property(nonatomic, readonly, nullable) NSURL* vmServiceUrl;
|
||||
|
||||
/**
|
||||
* The `FlutterBinaryMessenger` associated with this FlutterEngine (used for communicating with
|
||||
* channels).
|
||||
*/
|
||||
@property(nonatomic, readonly) NSObject<FlutterBinaryMessenger>* binaryMessenger;
|
||||
|
||||
/**
|
||||
* The `FlutterTextureRegistry` associated with this FlutterEngine (used to register textures).
|
||||
*/
|
||||
@property(nonatomic, readonly) NSObject<FlutterTextureRegistry>* textureRegistry;
|
||||
|
||||
/**
|
||||
* The UI Isolate ID of the engine.
|
||||
*
|
||||
* This property will be nil if the engine is not running.
|
||||
*/
|
||||
@property(nonatomic, readonly, copy, nullable) NSString* isolateId;
|
||||
|
||||
/**
|
||||
* Whether or not GPU calls are allowed.
|
||||
*
|
||||
* Typically this is set when the app is backgrounded and foregrounded.
|
||||
*/
|
||||
@property(nonatomic, assign) BOOL isGpuDisabled;
|
||||
|
||||
@end
|
||||
|
||||
NS_ASSUME_NONNULL_END
|
||||
|
||||
#endif // FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERENGINE_H_
|
||||
|
|
@ -0,0 +1,110 @@
|
|||
// 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>
|
||||
|
||||
#import "FlutterEngine.h"
|
||||
|
||||
NS_ASSUME_NONNULL_BEGIN
|
||||
|
||||
/** Options that control how a FlutterEngine should be created. */
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
@interface FlutterEngineGroupOptions : NSObject
|
||||
|
||||
/**
|
||||
* The name of a top-level function from a Dart library. If this is FlutterDefaultDartEntrypoint
|
||||
* (or nil); this will default to `main()`. If it is not the app's main() function, that function
|
||||
* must be decorated with `@pragma(vm:entry-point)` to ensure themethod is not tree-shaken by the
|
||||
* Dart compiler.
|
||||
*/
|
||||
@property(nonatomic, copy, nullable) NSString* entrypoint;
|
||||
|
||||
/**
|
||||
* The URI of the Dart library which contains the entrypoint method. If nil, this will default to
|
||||
* the same library as the `main()` function in the Dart program.
|
||||
*/
|
||||
@property(nonatomic, copy, nullable) NSString* libraryURI;
|
||||
|
||||
/**
|
||||
* The name of the initial Flutter `Navigator` `Route` to load. If this is
|
||||
* FlutterDefaultInitialRoute (or nil), it will default to the "/" route.
|
||||
*/
|
||||
@property(nonatomic, copy, nullable) NSString* initialRoute;
|
||||
|
||||
/**
|
||||
* Arguments passed as a list of string to Dart's entrypoint function.
|
||||
*/
|
||||
@property(nonatomic, retain, nullable) NSArray<NSString*>* entrypointArgs;
|
||||
@end
|
||||
|
||||
/**
|
||||
* Represents a collection of FlutterEngines who share resources which allows
|
||||
* them to be created with less time const and occupy less memory than just
|
||||
* creating multiple FlutterEngines.
|
||||
*
|
||||
* Deleting a FlutterEngineGroup doesn't invalidate existing FlutterEngines, but
|
||||
* it eliminates the possibility to create more FlutterEngines in that group.
|
||||
*
|
||||
* @warning This class is a work-in-progress and may change.
|
||||
* @see https://github.com/flutter/flutter/issues/72009
|
||||
*/
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
@interface FlutterEngineGroup : NSObject
|
||||
- (instancetype)init NS_UNAVAILABLE;
|
||||
|
||||
/**
|
||||
* Initialize a new FlutterEngineGroup.
|
||||
*
|
||||
* @param name The name that will present in the threads shared across the
|
||||
* engines in this group.
|
||||
* @param project The `FlutterDartProject` that all FlutterEngines in this group
|
||||
* will be executing.
|
||||
*/
|
||||
- (instancetype)initWithName:(NSString*)name
|
||||
project:(nullable FlutterDartProject*)project NS_DESIGNATED_INITIALIZER;
|
||||
|
||||
/**
|
||||
* Creates a running `FlutterEngine` that shares components with this group.
|
||||
*
|
||||
* @param entrypoint The name of a top-level function from a Dart library. If this is
|
||||
* FlutterDefaultDartEntrypoint (or nil); this will default to `main()`. If it is not the app's
|
||||
* main() function, that function must be decorated with `@pragma(vm:entry-point)` to ensure the
|
||||
* method is not tree-shaken by the Dart compiler.
|
||||
* @param libraryURI The URI of the Dart library which contains the entrypoint method. IF nil,
|
||||
* this will default to the same library as the `main()` function in the Dart program.
|
||||
*
|
||||
* @see FlutterEngineGroup
|
||||
*/
|
||||
- (FlutterEngine*)makeEngineWithEntrypoint:(nullable NSString*)entrypoint
|
||||
libraryURI:(nullable NSString*)libraryURI;
|
||||
|
||||
/**
|
||||
* Creates a running `FlutterEngine` that shares components with this group.
|
||||
*
|
||||
* @param entrypoint The name of a top-level function from a Dart library. If this is
|
||||
* FlutterDefaultDartEntrypoint (or nil); this will default to `main()`. If it is not the app's
|
||||
* main() function, that function must be decorated with `@pragma(vm:entry-point)` to ensure the
|
||||
* method is not tree-shaken by the Dart compiler.
|
||||
* @param libraryURI The URI of the Dart library which contains the entrypoint method. IF nil,
|
||||
* this will default to the same library as the `main()` function in the Dart program.
|
||||
* @param initialRoute The name of the initial Flutter `Navigator` `Route` to load. If this is
|
||||
* FlutterDefaultInitialRoute (or nil), it will default to the "/" route.
|
||||
*
|
||||
* @see FlutterEngineGroup
|
||||
*/
|
||||
- (FlutterEngine*)makeEngineWithEntrypoint:(nullable NSString*)entrypoint
|
||||
libraryURI:(nullable NSString*)libraryURI
|
||||
initialRoute:(nullable NSString*)initialRoute;
|
||||
|
||||
/**
|
||||
* Creates a running `FlutterEngine` that shares components with this group.
|
||||
*
|
||||
* @param options Options that control how a FlutterEngine should be created.
|
||||
*
|
||||
* @see FlutterEngineGroupOptions
|
||||
*/
|
||||
- (FlutterEngine*)makeEngineWithOptions:(nullable FlutterEngineGroupOptions*)options;
|
||||
@end
|
||||
|
||||
NS_ASSUME_NONNULL_END
|
||||
|
|
@ -0,0 +1,97 @@
|
|||
// 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_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERHEADLESSDARTRUNNER_H_
|
||||
#define FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERHEADLESSDARTRUNNER_H_
|
||||
|
||||
#import <Foundation/Foundation.h>
|
||||
|
||||
#import "FlutterBinaryMessenger.h"
|
||||
#import "FlutterDartProject.h"
|
||||
#import "FlutterEngine.h"
|
||||
#import "FlutterMacros.h"
|
||||
|
||||
/**
|
||||
* A callback for when FlutterHeadlessDartRunner has attempted to start a Dart
|
||||
* Isolate in the background.
|
||||
*
|
||||
* @param success YES if the Isolate was started and run successfully, NO
|
||||
* otherwise.
|
||||
*/
|
||||
typedef void (^FlutterHeadlessDartRunnerCallback)(BOOL success);
|
||||
|
||||
/**
|
||||
* The deprecated FlutterHeadlessDartRunner runs Flutter Dart code with a null rasterizer,
|
||||
* and no native drawing surface. It is appropriate for use in running Dart
|
||||
* code e.g. in the background from a plugin.
|
||||
*
|
||||
* Most callers should prefer using `FlutterEngine` directly; this interface exists
|
||||
* for legacy support.
|
||||
*/
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
FLUTTER_DEPRECATED("FlutterEngine should be used rather than FlutterHeadlessDartRunner")
|
||||
@interface FlutterHeadlessDartRunner : FlutterEngine
|
||||
|
||||
/**
|
||||
* Initialize this FlutterHeadlessDartRunner with a `FlutterDartProject`.
|
||||
*
|
||||
* If the FlutterDartProject is not specified, the FlutterHeadlessDartRunner will attempt to locate
|
||||
* the project in a default location.
|
||||
*
|
||||
* A newly initialized engine will not run the `FlutterDartProject` until either
|
||||
* `-runWithEntrypoint:` or `-runWithEntrypoint:libraryURI` is called.
|
||||
*
|
||||
* @param labelPrefix The label prefix used to identify threads for this instance. Should
|
||||
* be unique across FlutterEngine instances
|
||||
* @param projectOrNil The `FlutterDartProject` to run.
|
||||
*/
|
||||
- (instancetype)initWithName:(NSString*)labelPrefix project:(FlutterDartProject*)projectOrNil;
|
||||
|
||||
/**
|
||||
* Initialize this FlutterHeadlessDartRunner with a `FlutterDartProject`.
|
||||
*
|
||||
* If the FlutterDartProject is not specified, the FlutterHeadlessDartRunner will attempt to locate
|
||||
* the project in a default location.
|
||||
*
|
||||
* A newly initialized engine will not run the `FlutterDartProject` until either
|
||||
* `-runWithEntrypoint:` or `-runWithEntrypoint:libraryURI` is called.
|
||||
*
|
||||
* @param labelPrefix The label prefix used to identify threads for this instance. Should
|
||||
* be unique across FlutterEngine instances
|
||||
* @param projectOrNil The `FlutterDartProject` to run.
|
||||
* @param allowHeadlessExecution Must be set to `YES`.
|
||||
*/
|
||||
- (instancetype)initWithName:(NSString*)labelPrefix
|
||||
project:(FlutterDartProject*)projectOrNil
|
||||
allowHeadlessExecution:(BOOL)allowHeadlessExecution;
|
||||
|
||||
/**
|
||||
* Initialize this FlutterHeadlessDartRunner with a `FlutterDartProject`.
|
||||
*
|
||||
* If the FlutterDartProject is not specified, the FlutterHeadlessDartRunner will attempt to locate
|
||||
* the project in a default location.
|
||||
*
|
||||
* A newly initialized engine will not run the `FlutterDartProject` until either
|
||||
* `-runWithEntrypoint:` or `-runWithEntrypoint:libraryURI` is called.
|
||||
*
|
||||
* @param labelPrefix The label prefix used to identify threads for this instance. Should
|
||||
* be unique across FlutterEngine instances
|
||||
* @param projectOrNil The `FlutterDartProject` to run.
|
||||
* @param allowHeadlessExecution Must be set to `YES`.
|
||||
* @param restorationEnabled Must be set to `NO`.
|
||||
*/
|
||||
- (instancetype)initWithName:(NSString*)labelPrefix
|
||||
project:(FlutterDartProject*)projectOrNil
|
||||
allowHeadlessExecution:(BOOL)allowHeadlessExecution
|
||||
restorationEnabled:(BOOL)restorationEnabled NS_DESIGNATED_INITIALIZER;
|
||||
|
||||
/**
|
||||
* Not recommended for use - will initialize with a default label ("io.flutter.headless")
|
||||
* and the default FlutterDartProject.
|
||||
*/
|
||||
- (instancetype)init;
|
||||
|
||||
@end
|
||||
|
||||
#endif // FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERHEADLESSDARTRUNNER_H_
|
||||
|
|
@ -0,0 +1,48 @@
|
|||
// 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_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERMACROS_H_
|
||||
#define FLUTTER_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERMACROS_H_
|
||||
|
||||
#if defined(FLUTTER_FRAMEWORK)
|
||||
|
||||
#define FLUTTER_DARWIN_EXPORT __attribute__((visibility("default")))
|
||||
|
||||
#else // defined(FLUTTER_SDK)
|
||||
|
||||
#define FLUTTER_DARWIN_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)))
|
||||
|
||||
#if __has_feature(objc_arc)
|
||||
#define FLUTTER_ASSERT_ARC
|
||||
#define FLUTTER_ASSERT_NOT_ARC #error ARC must be disabled !
|
||||
#else
|
||||
#define FLUTTER_ASSERT_ARC #error ARC must be enabled !
|
||||
#define FLUTTER_ASSERT_NOT_ARC
|
||||
#endif
|
||||
|
||||
#endif // FLUTTER_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERMACROS_H_
|
||||
|
|
@ -0,0 +1,56 @@
|
|||
// 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_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERPLATFORMVIEWS_H_
|
||||
#define FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERPLATFORMVIEWS_H_
|
||||
|
||||
#import <UIKit/UIKit.h>
|
||||
|
||||
#import "FlutterCodecs.h"
|
||||
#import "FlutterMacros.h"
|
||||
|
||||
NS_ASSUME_NONNULL_BEGIN
|
||||
|
||||
/**
|
||||
* Wraps a `UIView` for embedding in the Flutter hierarchy
|
||||
*/
|
||||
@protocol FlutterPlatformView <NSObject>
|
||||
/**
|
||||
* Returns a reference to the `UIView` that is wrapped by this `FlutterPlatformView`.
|
||||
*/
|
||||
- (UIView*)view;
|
||||
@end
|
||||
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
@protocol FlutterPlatformViewFactory <NSObject>
|
||||
/**
|
||||
* Create a `FlutterPlatformView`.
|
||||
*
|
||||
* Implemented by iOS code that expose a `UIView` for embedding in a Flutter app.
|
||||
*
|
||||
* The implementation of this method should create a new `UIView` and return it.
|
||||
*
|
||||
* @param frame The rectangle for the newly created `UIView` measured in points.
|
||||
* @param viewId A unique identifier for this `UIView`.
|
||||
* @param args Parameters for creating the `UIView` sent from the Dart side of the Flutter app.
|
||||
* If `createArgsCodec` is not implemented, or if no creation arguments were sent from the Dart
|
||||
* code, this will be null. Otherwise this will be the value sent from the Dart code as decoded by
|
||||
* `createArgsCodec`.
|
||||
*/
|
||||
- (NSObject<FlutterPlatformView>*)createWithFrame:(CGRect)frame
|
||||
viewIdentifier:(int64_t)viewId
|
||||
arguments:(id _Nullable)args;
|
||||
|
||||
/**
|
||||
* Returns the `FlutterMessageCodec` for decoding the args parameter of `createWithFrame`.
|
||||
*
|
||||
* Only needs to be implemented if `createWithFrame` needs an arguments parameter.
|
||||
*/
|
||||
@optional
|
||||
- (NSObject<FlutterMessageCodec>*)createArgsCodec;
|
||||
@end
|
||||
|
||||
NS_ASSUME_NONNULL_END
|
||||
|
||||
#endif // FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERPLATFORMVIEWS_H_
|
||||
|
|
@ -0,0 +1,448 @@
|
|||
// 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_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERPLUGIN_H_
|
||||
#define FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERPLUGIN_H_
|
||||
|
||||
#import <UIKit/UIKit.h>
|
||||
#import <UserNotifications/UNUserNotificationCenter.h>
|
||||
|
||||
#import "FlutterBinaryMessenger.h"
|
||||
#import "FlutterChannels.h"
|
||||
#import "FlutterCodecs.h"
|
||||
#import "FlutterPlatformViews.h"
|
||||
#import "FlutterTexture.h"
|
||||
|
||||
NS_ASSUME_NONNULL_BEGIN
|
||||
@protocol FlutterPluginRegistrar;
|
||||
@protocol FlutterPluginRegistry;
|
||||
|
||||
#pragma mark -
|
||||
/**
|
||||
* Protocol for listener of events from the UIApplication, typically a FlutterPlugin.
|
||||
*/
|
||||
@protocol FlutterApplicationLifeCycleDelegate <UNUserNotificationCenterDelegate>
|
||||
|
||||
@optional
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*
|
||||
* @return `NO` if this vetos application launch.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
didFinishLaunchingWithOptions:(NSDictionary*)launchOptions;
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*
|
||||
* @return `NO` if this vetos application launch.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
willFinishLaunchingWithOptions:(NSDictionary*)launchOptions;
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*/
|
||||
- (void)applicationDidBecomeActive:(UIApplication*)application;
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*/
|
||||
- (void)applicationWillResignActive:(UIApplication*)application;
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*/
|
||||
- (void)applicationDidEnterBackground:(UIApplication*)application;
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*/
|
||||
- (void)applicationWillEnterForeground:(UIApplication*)application;
|
||||
|
||||
/**
|
||||
Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*/
|
||||
- (void)applicationWillTerminate:(UIApplication*)application;
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*/
|
||||
- (void)application:(UIApplication*)application
|
||||
didRegisterUserNotificationSettings:(UIUserNotificationSettings*)notificationSettings
|
||||
API_DEPRECATED(
|
||||
"See -[UIApplicationDelegate application:didRegisterUserNotificationSettings:] deprecation",
|
||||
ios(8.0, 10.0));
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*/
|
||||
- (void)application:(UIApplication*)application
|
||||
didRegisterForRemoteNotificationsWithDeviceToken:(NSData*)deviceToken;
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*/
|
||||
- (void)application:(UIApplication*)application
|
||||
didFailToRegisterForRemoteNotificationsWithError:(NSError*)error;
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*
|
||||
* @return `YES` if this handles the request.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
didReceiveRemoteNotification:(NSDictionary*)userInfo
|
||||
fetchCompletionHandler:(void (^)(UIBackgroundFetchResult result))completionHandler;
|
||||
|
||||
/**
|
||||
* Calls all plugins registered for `UIApplicationDelegate` callbacks.
|
||||
*/
|
||||
- (void)application:(UIApplication*)application
|
||||
didReceiveLocalNotification:(UILocalNotification*)notification
|
||||
API_DEPRECATED(
|
||||
"See -[UIApplicationDelegate application:didReceiveLocalNotification:] deprecation",
|
||||
ios(4.0, 10.0));
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*
|
||||
* @return `YES` if this handles the request.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
openURL:(NSURL*)url
|
||||
options:(NSDictionary<UIApplicationOpenURLOptionsKey, id>*)options;
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*
|
||||
* @return `YES` if this handles the request.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application handleOpenURL:(NSURL*)url;
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*
|
||||
* @return `YES` if this handles the request.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
openURL:(NSURL*)url
|
||||
sourceApplication:(NSString*)sourceApplication
|
||||
annotation:(id)annotation;
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*
|
||||
* @return `YES` if this handles the request.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
performActionForShortcutItem:(UIApplicationShortcutItem*)shortcutItem
|
||||
completionHandler:(void (^)(BOOL succeeded))completionHandler
|
||||
API_AVAILABLE(ios(9.0));
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*
|
||||
* @return `YES` if this handles the request.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
handleEventsForBackgroundURLSession:(nonnull NSString*)identifier
|
||||
completionHandler:(nonnull void (^)(void))completionHandler;
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*
|
||||
* @return `YES` if this handles the request.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
performFetchWithCompletionHandler:(void (^)(UIBackgroundFetchResult result))completionHandler;
|
||||
|
||||
/**
|
||||
* Called if this has been registered for `UIApplicationDelegate` callbacks.
|
||||
*
|
||||
* @return `YES` if this handles the request.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
continueUserActivity:(NSUserActivity*)userActivity
|
||||
restorationHandler:(void (^)(NSArray*))restorationHandler;
|
||||
@end
|
||||
|
||||
#pragma mark -
|
||||
/**
|
||||
* A plugin registration callback.
|
||||
*
|
||||
* Used for registering plugins with additional instances of
|
||||
* `FlutterPluginRegistry`.
|
||||
*
|
||||
* @param registry The registry to register plugins with.
|
||||
*/
|
||||
typedef void (*FlutterPluginRegistrantCallback)(NSObject<FlutterPluginRegistry>* registry);
|
||||
|
||||
#pragma mark -
|
||||
/**
|
||||
* Implemented by the iOS part 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.
|
||||
*/
|
||||
@protocol FlutterPlugin <NSObject, FlutterApplicationLifeCycleDelegate>
|
||||
@required
|
||||
/**
|
||||
* Registers this plugin using the context information and callback registration
|
||||
* methods exposed by the given registrar.
|
||||
*
|
||||
* The registrar is obtained from a `FlutterPluginRegistry` which keeps track of
|
||||
* the identity of registered plugins and provides basic support for cross-plugin
|
||||
* coordination.
|
||||
*
|
||||
* The caller of this method, a plugin registrant, is usually autogenerated by
|
||||
* Flutter tooling based on declared plugin dependencies. The generated registrant
|
||||
* asks the registry for a registrar for each plugin, and calls this method to
|
||||
* allow the plugin to initialize itself and register callbacks with application
|
||||
* objects available through the registrar protocol.
|
||||
*
|
||||
* @param registrar A helper providing application context and methods for
|
||||
* registering callbacks.
|
||||
*/
|
||||
+ (void)registerWithRegistrar:(NSObject<FlutterPluginRegistrar>*)registrar;
|
||||
@optional
|
||||
/**
|
||||
* Set a callback for registering plugins to an additional `FlutterPluginRegistry`,
|
||||
* including headless `FlutterEngine` instances.
|
||||
*
|
||||
* This method is typically called from within an application's `AppDelegate` at
|
||||
* startup to allow for plugins which create additional `FlutterEngine` instances
|
||||
* to register the application's plugins.
|
||||
*
|
||||
* @param callback A callback for registering some set of plugins with a
|
||||
* `FlutterPluginRegistry`.
|
||||
*/
|
||||
+ (void)setPluginRegistrantCallback:(FlutterPluginRegistrantCallback)callback;
|
||||
@optional
|
||||
/**
|
||||
* Called if this plugin has been registered to receive `FlutterMethodCall`s.
|
||||
*
|
||||
* @param call The method call command object.
|
||||
* @param result A callback for submitting the result of the call.
|
||||
*/
|
||||
- (void)handleMethodCall:(FlutterMethodCall*)call result:(FlutterResult)result;
|
||||
@optional
|
||||
/**
|
||||
* Called when a plugin is being removed from a `FlutterEngine`, which is
|
||||
* usually the result of the `FlutterEngine` being deallocated. This method
|
||||
* provides the opportunity to do necessary cleanup.
|
||||
*
|
||||
* You will only receive this method if you registered your plugin instance with
|
||||
* the `FlutterEngine` via `-[FlutterPluginRegistry publish:]`.
|
||||
*
|
||||
* @param registrar The registrar that was used to publish the plugin.
|
||||
*
|
||||
*/
|
||||
- (void)detachFromEngineForRegistrar:(NSObject<FlutterPluginRegistrar>*)registrar;
|
||||
@end
|
||||
|
||||
#pragma mark -
|
||||
/**
|
||||
* How the UIGestureRecognizers of a platform view are blocked.
|
||||
*
|
||||
* UIGestureRecognizers of platform views can be blocked based on decisions made by the
|
||||
* Flutter Framework (e.g. When an interact-able widget is covering the platform view).
|
||||
*/
|
||||
typedef enum {
|
||||
// NOLINTBEGIN(readability-identifier-naming)
|
||||
/**
|
||||
* Flutter blocks all the UIGestureRecognizers on the platform view as soon as it
|
||||
* decides they should be blocked.
|
||||
*
|
||||
* With this policy, only the `touchesBegan` method for all the UIGestureRecognizers is guaranteed
|
||||
* to be called.
|
||||
*/
|
||||
FlutterPlatformViewGestureRecognizersBlockingPolicyEager,
|
||||
/**
|
||||
* Flutter blocks the platform view's UIGestureRecognizers from recognizing only after
|
||||
* touchesEnded was invoked.
|
||||
*
|
||||
* This results in the platform view's UIGestureRecognizers seeing the entire touch sequence,
|
||||
* but never recognizing the gesture (and never invoking actions).
|
||||
*/
|
||||
FlutterPlatformViewGestureRecognizersBlockingPolicyWaitUntilTouchesEnded,
|
||||
// NOLINTEND(readability-identifier-naming)
|
||||
} FlutterPlatformViewGestureRecognizersBlockingPolicy;
|
||||
|
||||
#pragma mark -
|
||||
/**
|
||||
* Registration context for a single `FlutterPlugin`, providing a one stop shop
|
||||
* for the plugin to access contextual information and register callbacks for
|
||||
* various application events.
|
||||
*
|
||||
* Registrars are obtained from a `FlutterPluginRegistry` which keeps track of
|
||||
* the identity of registered plugins and provides basic support for cross-plugin
|
||||
* coordination.
|
||||
*/
|
||||
@protocol FlutterPluginRegistrar <NSObject>
|
||||
/**
|
||||
* Returns a `FlutterBinaryMessenger` for creating Dart/iOS communication
|
||||
* channels to be used by the plugin.
|
||||
*
|
||||
* @return The messenger.
|
||||
*/
|
||||
- (NSObject<FlutterBinaryMessenger>*)messenger;
|
||||
|
||||
/**
|
||||
* Returns a `FlutterTextureRegistry` for registering textures
|
||||
* provided by the plugin.
|
||||
*
|
||||
* @return The texture registry.
|
||||
*/
|
||||
- (NSObject<FlutterTextureRegistry>*)textures;
|
||||
|
||||
/**
|
||||
* Registers a `FlutterPlatformViewFactory` for creation of platform views.
|
||||
*
|
||||
* Plugins expose `UIView` for embedding in Flutter apps by registering a view factory.
|
||||
*
|
||||
* @param factory The view factory that will be registered.
|
||||
* @param factoryId A unique identifier for the factory, the Dart code of the Flutter app can use
|
||||
* this identifier to request creation of a `UIView` by the registered factory.
|
||||
*/
|
||||
- (void)registerViewFactory:(NSObject<FlutterPlatformViewFactory>*)factory
|
||||
withId:(NSString*)factoryId;
|
||||
|
||||
/**
|
||||
* Registers a `FlutterPlatformViewFactory` for creation of platform views.
|
||||
*
|
||||
* Plugins can expose a `UIView` for embedding in Flutter apps by registering a view factory.
|
||||
*
|
||||
* @param factory The view factory that will be registered.
|
||||
* @param factoryId A unique identifier for the factory, the Dart code of the Flutter app can use
|
||||
* this identifier to request creation of a `UIView` by the registered factory.
|
||||
* @param gestureRecognizersBlockingPolicy How UIGestureRecognizers on the platform views are
|
||||
* blocked.
|
||||
*
|
||||
*/
|
||||
- (void)registerViewFactory:(NSObject<FlutterPlatformViewFactory>*)factory
|
||||
withId:(NSString*)factoryId
|
||||
gestureRecognizersBlockingPolicy:
|
||||
(FlutterPlatformViewGestureRecognizersBlockingPolicy)gestureRecognizersBlockingPolicy;
|
||||
|
||||
/**
|
||||
* Publishes a value for external use of the plugin.
|
||||
*
|
||||
* Plugins may publish a single value, such as an instance of the
|
||||
* plugin's main class, for situations where external control or
|
||||
* interaction is needed.
|
||||
*
|
||||
* The published value will be available from the `FlutterPluginRegistry`.
|
||||
* Repeated calls overwrite any previous publication.
|
||||
*
|
||||
* @param value The value to be published.
|
||||
*/
|
||||
- (void)publish:(NSObject*)value;
|
||||
|
||||
/**
|
||||
* Registers the plugin as a receiver of incoming method calls from the Dart side
|
||||
* on the specified `FlutterMethodChannel`.
|
||||
*
|
||||
* @param delegate The receiving object, such as the plugin's main class.
|
||||
* @param channel The channel
|
||||
*/
|
||||
- (void)addMethodCallDelegate:(NSObject<FlutterPlugin>*)delegate
|
||||
channel:(FlutterMethodChannel*)channel;
|
||||
|
||||
/**
|
||||
* Registers the plugin as a receiver of `UIApplicationDelegate` calls.
|
||||
*
|
||||
* @param delegate The receiving object, such as the plugin's main class.
|
||||
*/
|
||||
- (void)addApplicationDelegate:(NSObject<FlutterPlugin>*)delegate
|
||||
NS_EXTENSION_UNAVAILABLE_IOS("Disallowed in plugins used in app extensions");
|
||||
|
||||
/**
|
||||
* Returns the file name for the given asset.
|
||||
* The returned file name can be used to access the asset in the application's main bundle.
|
||||
*
|
||||
* @param asset The name of the asset. The name can be hierarchical.
|
||||
* @return the file name to be used for lookup in the main bundle.
|
||||
*/
|
||||
- (NSString*)lookupKeyForAsset:(NSString*)asset;
|
||||
|
||||
/**
|
||||
* Returns the file name for the given asset which originates from the specified package.
|
||||
* The returned file name can be used to access the asset in the application's main bundle.
|
||||
*
|
||||
*
|
||||
* @param asset The name of the asset. The name can be hierarchical.
|
||||
* @param package The name of the package from which the asset originates.
|
||||
* @return the file name to be used for lookup in the main bundle.
|
||||
*/
|
||||
- (NSString*)lookupKeyForAsset:(NSString*)asset fromPackage:(NSString*)package;
|
||||
@end
|
||||
|
||||
#pragma mark -
|
||||
/**
|
||||
* A registry of Flutter iOS plugins.
|
||||
*
|
||||
* Plugins are identified by unique string keys, typically the name of the
|
||||
* plugin's main class. The registry tracks plugins by this key, mapping it to
|
||||
* a value published by the plugin during registration, if any. This provides a
|
||||
* very basic means of cross-plugin coordination with loose coupling between
|
||||
* unrelated plugins.
|
||||
*
|
||||
* 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 FlutterPluginRegistry <NSObject>
|
||||
/**
|
||||
* Returns a registrar for registering a plugin.
|
||||
*
|
||||
* @param pluginKey The unique key identifying the plugin.
|
||||
*/
|
||||
- (nullable NSObject<FlutterPluginRegistrar>*)registrarForPlugin:(NSString*)pluginKey;
|
||||
/**
|
||||
* Returns whether the specified plugin has been registered.
|
||||
*
|
||||
* @param pluginKey The unique key identifying the plugin.
|
||||
* @return `YES` if `registrarForPlugin` has been called with `pluginKey`.
|
||||
*/
|
||||
- (BOOL)hasPlugin:(NSString*)pluginKey;
|
||||
|
||||
/**
|
||||
* Returns a value published by the specified plugin.
|
||||
*
|
||||
* @param pluginKey The unique key identifying the plugin.
|
||||
* @return An object published by the plugin, if any. Will be `NSNull` if
|
||||
* nothing has been published. Will be `nil` if the plugin has not been
|
||||
* registered.
|
||||
*/
|
||||
- (nullable NSObject*)valuePublishedByPlugin:(NSString*)pluginKey;
|
||||
@end
|
||||
|
||||
#pragma mark -
|
||||
/**
|
||||
* Implement this in the `UIAppDelegate` of your app to enable Flutter plugins to register
|
||||
* themselves to the application life cycle events.
|
||||
*
|
||||
* For plugins to receive events from `UNUserNotificationCenter`, register this as the
|
||||
* `UNUserNotificationCenterDelegate`.
|
||||
*/
|
||||
@protocol FlutterAppLifeCycleProvider <UNUserNotificationCenterDelegate>
|
||||
|
||||
/**
|
||||
* Called when registering a new `FlutterApplicaitonLifeCycleDelegate`.
|
||||
*
|
||||
* See also: `-[FlutterAppDelegate addApplicationLifeCycleDelegate:]`
|
||||
*/
|
||||
- (void)addApplicationLifeCycleDelegate:(NSObject<FlutterApplicationLifeCycleDelegate>*)delegate;
|
||||
@end
|
||||
|
||||
NS_ASSUME_NONNULL_END
|
||||
|
||||
#endif // FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERPLUGIN_H_
|
||||
|
|
@ -0,0 +1,148 @@
|
|||
// 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_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERPLUGINAPPLIFECYCLEDELEGATE_H_
|
||||
#define FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERPLUGINAPPLIFECYCLEDELEGATE_H_
|
||||
|
||||
#import "FlutterPlugin.h"
|
||||
|
||||
NS_ASSUME_NONNULL_BEGIN
|
||||
|
||||
/**
|
||||
* Propagates `UIAppDelegate` callbacks to registered plugins.
|
||||
*/
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
@interface FlutterPluginAppLifeCycleDelegate : NSObject <UNUserNotificationCenterDelegate>
|
||||
|
||||
/**
|
||||
* Registers `delegate` to receive life cycle callbacks via this FlutterPluginAppLifeCycleDelegate
|
||||
* as long as it is alive.
|
||||
*
|
||||
* `delegate` will only be referenced weakly.
|
||||
*/
|
||||
- (void)addDelegate:(NSObject<FlutterApplicationLifeCycleDelegate>*)delegate;
|
||||
|
||||
/**
|
||||
* Calls all plugins registered for `UIApplicationDelegate` callbacks.
|
||||
*
|
||||
* @return `NO` if any plugin vetos application launch.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
didFinishLaunchingWithOptions:(NSDictionary*)launchOptions;
|
||||
|
||||
/**
|
||||
* Calls all plugins registered for `UIApplicationDelegate` callbacks.
|
||||
*
|
||||
* @return `NO` if any plugin vetos application launch.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
willFinishLaunchingWithOptions:(NSDictionary*)launchOptions;
|
||||
|
||||
/**
|
||||
* Called if this plugin has been registered for `UIApplicationDelegate` callbacks.
|
||||
*/
|
||||
- (void)application:(UIApplication*)application
|
||||
didRegisterUserNotificationSettings:(UIUserNotificationSettings*)notificationSettings
|
||||
API_DEPRECATED(
|
||||
"See -[UIApplicationDelegate application:didRegisterUserNotificationSettings:] deprecation",
|
||||
ios(8.0, 10.0));
|
||||
|
||||
/**
|
||||
* Calls all plugins registered for `UIApplicationDelegate` callbacks.
|
||||
*/
|
||||
- (void)application:(UIApplication*)application
|
||||
didRegisterForRemoteNotificationsWithDeviceToken:(NSData*)deviceToken;
|
||||
|
||||
/**
|
||||
* Calls all plugins registered for `UIApplicationDelegate` callbacks.
|
||||
*/
|
||||
- (void)application:(UIApplication*)application
|
||||
didFailToRegisterForRemoteNotificationsWithError:(NSError*)error;
|
||||
|
||||
/**
|
||||
* Calls all plugins registered for `UIApplicationDelegate` callbacks.
|
||||
*/
|
||||
- (void)application:(UIApplication*)application
|
||||
didReceiveRemoteNotification:(NSDictionary*)userInfo
|
||||
fetchCompletionHandler:(void (^)(UIBackgroundFetchResult result))completionHandler;
|
||||
|
||||
/**
|
||||
* Calls all plugins registered for `UIApplicationDelegate` callbacks.
|
||||
*/
|
||||
- (void)application:(UIApplication*)application
|
||||
didReceiveLocalNotification:(UILocalNotification*)notification
|
||||
API_DEPRECATED(
|
||||
"See -[UIApplicationDelegate application:didReceiveLocalNotification:] deprecation",
|
||||
ios(4.0, 10.0));
|
||||
|
||||
/**
|
||||
* Calls all plugins registered for `UIApplicationDelegate` callbacks in order of registration until
|
||||
* some plugin handles the request.
|
||||
*
|
||||
* @return `YES` if any plugin handles the request.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
openURL:(NSURL*)url
|
||||
options:(NSDictionary<UIApplicationOpenURLOptionsKey, id>*)options;
|
||||
|
||||
/**
|
||||
* Calls all plugins registered for `UIApplicationDelegate` callbacks in order of registration until
|
||||
* some plugin handles the request.
|
||||
*
|
||||
* @return `YES` if any plugin handles the request.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application handleOpenURL:(NSURL*)url;
|
||||
|
||||
/**
|
||||
* Calls all plugins registered for `UIApplicationDelegate` callbacks in order of registration until
|
||||
* some plugin handles the request.
|
||||
*
|
||||
* @return `YES` if any plugin handles the request.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
openURL:(NSURL*)url
|
||||
sourceApplication:(NSString*)sourceApplication
|
||||
annotation:(id)annotation;
|
||||
|
||||
/**
|
||||
* Calls all plugins registered for `UIApplicationDelegate` callbacks.
|
||||
*/
|
||||
- (void)application:(UIApplication*)application
|
||||
performActionForShortcutItem:(UIApplicationShortcutItem*)shortcutItem
|
||||
completionHandler:(void (^)(BOOL succeeded))completionHandler
|
||||
API_AVAILABLE(ios(9.0));
|
||||
|
||||
/**
|
||||
* Calls all plugins registered for `UIApplicationDelegate` callbacks in order of registration until
|
||||
* some plugin handles the request.
|
||||
*
|
||||
* @return `YES` if any plugin handles the request.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
handleEventsForBackgroundURLSession:(nonnull NSString*)identifier
|
||||
completionHandler:(nonnull void (^)(void))completionHandler;
|
||||
|
||||
/**
|
||||
* Calls all plugins registered for `UIApplicationDelegate` callbacks in order of registration until
|
||||
* some plugin handles the request.
|
||||
*
|
||||
* @returns `YES` if any plugin handles the request.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
performFetchWithCompletionHandler:(void (^)(UIBackgroundFetchResult result))completionHandler;
|
||||
|
||||
/**
|
||||
* Calls all plugins registered for `UIApplicationDelegate` callbacks in order of registration until
|
||||
* some plugin handles the request.
|
||||
*
|
||||
* @return `YES` if any plugin handles the request.
|
||||
*/
|
||||
- (BOOL)application:(UIApplication*)application
|
||||
continueUserActivity:(NSUserActivity*)userActivity
|
||||
restorationHandler:(void (^)(NSArray*))restorationHandler;
|
||||
@end
|
||||
|
||||
NS_ASSUME_NONNULL_END
|
||||
|
||||
#endif // FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERPLUGINAPPLIFECYCLEDELEGATE_H_
|
||||
|
|
@ -0,0 +1,62 @@
|
|||
// 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_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERTEXTURE_H_
|
||||
#define FLUTTER_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERTEXTURE_H_
|
||||
|
||||
#import <CoreMedia/CoreMedia.h>
|
||||
#import <Foundation/Foundation.h>
|
||||
|
||||
#import "FlutterMacros.h"
|
||||
|
||||
NS_ASSUME_NONNULL_BEGIN
|
||||
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
/**
|
||||
* Represents a texture that can be shared with Flutter.
|
||||
*
|
||||
* See also: https://github.com/flutter/plugins/tree/master/packages/camera
|
||||
*/
|
||||
@protocol FlutterTexture <NSObject>
|
||||
/** Copy the contents of the texture into a `CVPixelBuffer`. */
|
||||
- (CVPixelBufferRef _Nullable)copyPixelBuffer;
|
||||
|
||||
/**
|
||||
* Called when the texture is unregistered.
|
||||
*
|
||||
* Called on the raster thread.
|
||||
*/
|
||||
@optional
|
||||
- (void)onTextureUnregistered:(NSObject<FlutterTexture>*)texture;
|
||||
@end
|
||||
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
/**
|
||||
* A collection of registered `FlutterTexture`'s.
|
||||
*/
|
||||
@protocol FlutterTextureRegistry <NSObject>
|
||||
/**
|
||||
* Registers a `FlutterTexture` for usage in Flutter and returns an id that can be used to reference
|
||||
* that texture when calling into Flutter with channels. Textures must be registered on the
|
||||
* platform thread. On success returns the pointer to the registered texture, else returns 0.
|
||||
*/
|
||||
- (int64_t)registerTexture:(NSObject<FlutterTexture>*)texture;
|
||||
/**
|
||||
* Notifies Flutter that the content of the previously registered texture has been updated.
|
||||
*
|
||||
* This will trigger a call to `-[FlutterTexture copyPixelBuffer]` on the raster thread.
|
||||
*/
|
||||
- (void)textureFrameAvailable:(int64_t)textureId;
|
||||
/**
|
||||
* Unregisters a `FlutterTexture` that has previously regeistered with `registerTexture:`. Textures
|
||||
* must be unregistered on the platform thread.
|
||||
*
|
||||
* @param textureId The result that was previously returned from `registerTexture:`.
|
||||
*/
|
||||
- (void)unregisterTexture:(int64_t)textureId;
|
||||
@end
|
||||
|
||||
NS_ASSUME_NONNULL_END
|
||||
|
||||
#endif // FLUTTER_SHELL_PLATFORM_DARWIN_COMMON_FRAMEWORK_HEADERS_FLUTTERTEXTURE_H_
|
||||
|
|
@ -0,0 +1,260 @@
|
|||
// 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_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERVIEWCONTROLLER_H_
|
||||
#define FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERVIEWCONTROLLER_H_
|
||||
|
||||
#import <UIKit/UIKit.h>
|
||||
#include <sys/cdefs.h>
|
||||
|
||||
#import "FlutterBinaryMessenger.h"
|
||||
#import "FlutterDartProject.h"
|
||||
#import "FlutterEngine.h"
|
||||
#import "FlutterMacros.h"
|
||||
#import "FlutterPlugin.h"
|
||||
#import "FlutterTexture.h"
|
||||
|
||||
NS_ASSUME_NONNULL_BEGIN
|
||||
|
||||
@class FlutterEngine;
|
||||
|
||||
/**
|
||||
* The name used for semantic update notifications via `NSNotificationCenter`.
|
||||
*
|
||||
* The object passed as the sender is the `FlutterViewController` associated
|
||||
* with the update.
|
||||
*/
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
// NOLINTNEXTLINE(readability-identifier-naming)
|
||||
extern NSNotificationName const FlutterSemanticsUpdateNotification;
|
||||
|
||||
/**
|
||||
* A `UIViewController` implementation for Flutter views.
|
||||
*
|
||||
* Dart execution, channel communication, texture registration, and plugin registration are all
|
||||
* handled by `FlutterEngine`. Calls on this class to those members all proxy through to the
|
||||
* `FlutterEngine` attached FlutterViewController.
|
||||
*
|
||||
* A FlutterViewController can be initialized either with an already-running `FlutterEngine` via the
|
||||
* `initWithEngine:` initializer, or it can be initialized with a `FlutterDartProject` that will be
|
||||
* used to implicitly spin up a new `FlutterEngine`. Creating a `FlutterEngine` before showing a
|
||||
* FlutterViewController can be used to pre-initialize the Dart VM and to prepare the isolate in
|
||||
* order to reduce the latency to the first rendered frame. See
|
||||
* https://flutter.dev/docs/development/add-to-app/performance for more details on loading
|
||||
* latency.
|
||||
*
|
||||
* Holding a `FlutterEngine` independently of FlutterViewControllers can also be used to not to lose
|
||||
* Dart-related state and asynchronous tasks when navigating back and forth between a
|
||||
* FlutterViewController and other `UIViewController`s.
|
||||
*/
|
||||
FLUTTER_DARWIN_EXPORT
|
||||
#ifdef __IPHONE_13_4
|
||||
@interface FlutterViewController
|
||||
: UIViewController <FlutterTextureRegistry, FlutterPluginRegistry, UIGestureRecognizerDelegate>
|
||||
#else
|
||||
@interface FlutterViewController : UIViewController <FlutterTextureRegistry, FlutterPluginRegistry>
|
||||
#endif
|
||||
|
||||
/**
|
||||
* Initializes this FlutterViewController with the specified `FlutterEngine`.
|
||||
*
|
||||
* The initialized viewcontroller will attach itself to the engine as part of this process.
|
||||
*
|
||||
* @param engine The `FlutterEngine` instance to attach to. Cannot be nil.
|
||||
* @param nibName The NIB name to initialize this UIViewController with.
|
||||
* @param nibBundle The NIB bundle.
|
||||
*/
|
||||
- (instancetype)initWithEngine:(FlutterEngine*)engine
|
||||
nibName:(nullable NSString*)nibName
|
||||
bundle:(nullable NSBundle*)nibBundle NS_DESIGNATED_INITIALIZER;
|
||||
|
||||
/**
|
||||
* Initializes a new FlutterViewController and `FlutterEngine` with the specified
|
||||
* `FlutterDartProject`.
|
||||
*
|
||||
* This will implicitly create a new `FlutterEngine` which is retrievable via the `engine` property
|
||||
* after initialization.
|
||||
*
|
||||
* @param project The `FlutterDartProject` to initialize the `FlutterEngine` with.
|
||||
* @param nibName The NIB name to initialize this UIViewController with.
|
||||
* @param nibBundle The NIB bundle.
|
||||
*/
|
||||
- (instancetype)initWithProject:(nullable FlutterDartProject*)project
|
||||
nibName:(nullable NSString*)nibName
|
||||
bundle:(nullable NSBundle*)nibBundle NS_DESIGNATED_INITIALIZER;
|
||||
|
||||
/**
|
||||
* Initializes a new FlutterViewController and `FlutterEngine` with the specified
|
||||
* `FlutterDartProject` and `initialRoute`.
|
||||
*
|
||||
* This will implicitly create a new `FlutterEngine` which is retrievable via the `engine` property
|
||||
* after initialization.
|
||||
*
|
||||
* @param project The `FlutterDartProject` to initialize the `FlutterEngine` with.
|
||||
* @param initialRoute The initial `Navigator` route to load.
|
||||
* @param nibName The NIB name to initialize this UIViewController with.
|
||||
* @param nibBundle The NIB bundle.
|
||||
*/
|
||||
- (instancetype)initWithProject:(nullable FlutterDartProject*)project
|
||||
initialRoute:(nullable NSString*)initialRoute
|
||||
nibName:(nullable NSString*)nibName
|
||||
bundle:(nullable NSBundle*)nibBundle NS_DESIGNATED_INITIALIZER;
|
||||
|
||||
/**
|
||||
* Initializer that is called from loading a FlutterViewController from a XIB.
|
||||
*
|
||||
* See also:
|
||||
* https://developer.apple.com/documentation/foundation/nscoding/1416145-initwithcoder?language=objc
|
||||
*/
|
||||
- (instancetype)initWithCoder:(NSCoder*)aDecoder NS_DESIGNATED_INITIALIZER;
|
||||
|
||||
/**
|
||||
* Registers a callback that will be invoked when the Flutter view has been rendered.
|
||||
* The callback will be fired only once.
|
||||
*
|
||||
* Replaces an existing callback. Use a `nil` callback to unregister the existing one.
|
||||
*/
|
||||
- (void)setFlutterViewDidRenderCallback:(void (^)(void))callback;
|
||||
|
||||
/**
|
||||
* Returns the file name for the given asset.
|
||||
* The returned file name can be used to access the asset in the application's
|
||||
* main bundle.
|
||||
*
|
||||
* @param asset The name of the asset. The name can be hierarchical.
|
||||
* @return The file name to be used for lookup in the main bundle.
|
||||
*/
|
||||
- (NSString*)lookupKeyForAsset:(NSString*)asset;
|
||||
|
||||
/**
|
||||
* Returns the file name for the given asset which originates from the specified
|
||||
* package.
|
||||
* The returned file name can be used to access the asset in the application's
|
||||
* main bundle.
|
||||
*
|
||||
* @param asset The name of the asset. The name can be hierarchical.
|
||||
* @param package The name of the package from which the asset originates.
|
||||
* @return The file name to be used for lookup in the main bundle.
|
||||
*/
|
||||
- (NSString*)lookupKeyForAsset:(NSString*)asset fromPackage:(NSString*)package;
|
||||
|
||||
/**
|
||||
* Deprecated API to set initial route.
|
||||
*
|
||||
* Attempts to set the first route that the Flutter app shows if the Flutter
|
||||
* runtime hasn't yet started. The default is "/".
|
||||
*
|
||||
* This method must be called immediately after `initWithProject` and has no
|
||||
* effect when using `initWithEngine` if the `FlutterEngine` has already been
|
||||
* run.
|
||||
*
|
||||
* Setting this after the Flutter started running has no effect. See `pushRoute`
|
||||
* and `popRoute` to change the route after Flutter started running.
|
||||
*
|
||||
* This is deprecated because it needs to be called at the time of initialization
|
||||
* and thus should just be in the `initWithProject` initializer. If using
|
||||
* `initWithEngine`, the initial route should be set on the engine's
|
||||
* initializer.
|
||||
*
|
||||
* @param route The name of the first route to show.
|
||||
*/
|
||||
- (void)setInitialRoute:(NSString*)route
|
||||
FLUTTER_DEPRECATED("Use FlutterViewController initializer to specify initial route");
|
||||
|
||||
/**
|
||||
* Instructs the Flutter Navigator (if any) to go back.
|
||||
*/
|
||||
- (void)popRoute;
|
||||
|
||||
/**
|
||||
* Instructs the Flutter Navigator (if any) to push a route on to the navigation
|
||||
* stack.
|
||||
*
|
||||
* @param route The name of the route to push to the navigation stack.
|
||||
*/
|
||||
- (void)pushRoute:(NSString*)route;
|
||||
|
||||
/**
|
||||
* The `FlutterPluginRegistry` used by this FlutterViewController.
|
||||
*/
|
||||
- (id<FlutterPluginRegistry>)pluginRegistry;
|
||||
|
||||
/**
|
||||
* A wrapper around UIAccessibilityIsVoiceOverRunning().
|
||||
*
|
||||
* As a C function, UIAccessibilityIsVoiceOverRunning() cannot be mocked in testing. Mock
|
||||
* this class method to testing features depends on UIAccessibilityIsVoiceOverRunning().
|
||||
*/
|
||||
+ (BOOL)isUIAccessibilityIsVoiceOverRunning;
|
||||
|
||||
/**
|
||||
* True if at least one frame has rendered and the ViewController has appeared.
|
||||
*
|
||||
* This property is reset to false when the ViewController disappears. It is
|
||||
* guaranteed to only alternate between true and false for observers.
|
||||
*/
|
||||
@property(nonatomic, readonly, getter=isDisplayingFlutterUI) BOOL displayingFlutterUI;
|
||||
|
||||
/**
|
||||
* Specifies the view to use as a splash screen. Flutter's rendering is asynchronous, so the first
|
||||
* frame rendered by the Flutter application might not immediately appear when the Flutter view is
|
||||
* initially placed in the view hierarchy. The splash screen view will be used as
|
||||
* a replacement until the first frame is rendered.
|
||||
*
|
||||
* The view used should be appropriate for multiple sizes; an autoresizing mask to
|
||||
* have a flexible width and height will be applied automatically.
|
||||
*
|
||||
* Set to nil to remove the splash screen view.
|
||||
*/
|
||||
@property(strong, nonatomic, nullable) UIView* splashScreenView;
|
||||
|
||||
/**
|
||||
* Attempts to set the `splashScreenView` property from the `UILaunchStoryboardName` from the
|
||||
* main bundle's `Info.plist` file. This method will not change the value of `splashScreenView`
|
||||
* if it cannot find a default one from a storyboard or nib.
|
||||
*
|
||||
* @return `YES` if successful, `NO` otherwise.
|
||||
*/
|
||||
- (BOOL)loadDefaultSplashScreenView;
|
||||
|
||||
/**
|
||||
* Controls whether the created view will be opaque or not.
|
||||
*
|
||||
* Default is `YES`. Note that setting this to `NO` may negatively impact performance
|
||||
* when using hardware acceleration, and toggling this will trigger a re-layout of the
|
||||
* view.
|
||||
*/
|
||||
@property(nonatomic, getter=isViewOpaque) BOOL viewOpaque;
|
||||
|
||||
/**
|
||||
* The `FlutterEngine` instance for this view controller. This could be the engine this
|
||||
* `FlutterViewController` is initialized with or a new `FlutterEngine` implicitly created if
|
||||
* no engine was supplied during initialization.
|
||||
*/
|
||||
@property(weak, nonatomic, readonly) FlutterEngine* engine;
|
||||
|
||||
/**
|
||||
* The `FlutterBinaryMessenger` associated with this FlutterViewController (used for communicating
|
||||
* with channels).
|
||||
*
|
||||
* This is just a convenient way to get the |FlutterEngine|'s binary messenger.
|
||||
*/
|
||||
@property(nonatomic, readonly) NSObject<FlutterBinaryMessenger>* binaryMessenger;
|
||||
|
||||
/**
|
||||
* If the `FlutterViewController` creates a `FlutterEngine`, this property
|
||||
* determines if that `FlutterEngine` has `allowHeadlessExecution` set.
|
||||
*
|
||||
* The intention is that this is used with the XIB. Otherwise, a
|
||||
* `FlutterEngine` can just be sent to the init methods.
|
||||
*
|
||||
* See also: `-[FlutterEngine initWithName:project:allowHeadlessExecution:]`
|
||||
*/
|
||||
@property(nonatomic, readonly) BOOL engineAllowHeadlessExecution;
|
||||
|
||||
@end
|
||||
|
||||
NS_ASSUME_NONNULL_END
|
||||
|
||||
#endif // FLUTTER_SHELL_PLATFORM_DARWIN_IOS_FRAMEWORK_HEADERS_FLUTTERVIEWCONTROLLER_H_
|
||||
|
|
@ -0,0 +1,30 @@
|
|||
<?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>Flutter</string>
|
||||
<key>CFBundleIdentifier</key>
|
||||
<string>io.flutter.flutter</string>
|
||||
<key>CFBundleInfoDictionaryVersion</key>
|
||||
<string>6.0</string>
|
||||
<key>CFBundleName</key>
|
||||
<string>Flutter</string>
|
||||
<key>CFBundlePackageType</key>
|
||||
<string>FMWK</string>
|
||||
<key>CFBundleShortVersionString</key>
|
||||
<string>1.0</string>
|
||||
<key>CFBundleSignature</key>
|
||||
<string>????</string>
|
||||
<key>CFBundleVersion</key>
|
||||
<string>1.0</string>
|
||||
<key>MinimumOSVersion</key>
|
||||
<string>11.0</string>
|
||||
<key>FlutterEngine</key>
|
||||
<string>e76c956498841e1ab458577d3892003e553e4f3c</string>
|
||||
<key>ClangVersion</key>
|
||||
<string>b'Fuchsia clang version 18.0.0 (https://llvm.googlesource.com/llvm-project 725656bdd885483c39f482a01ea25d67acf39c46)'</string>
|
||||
</dict>
|
||||
</plist>
|
||||
|
|
@ -0,0 +1,6 @@
|
|||
framework module Flutter {
|
||||
umbrella header "Flutter.h"
|
||||
|
||||
export *
|
||||
module * { export * }
|
||||
}
|
||||
|
|
@ -0,0 +1,32 @@
|
|||
<?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>NSPrivacyTracking</key>
|
||||
<false/>
|
||||
<key>NSPrivacyTrackingDomains</key>
|
||||
<array/>
|
||||
<key>NSPrivacyCollectedDataTypes</key>
|
||||
<array/>
|
||||
<key>NSPrivacyAccessedAPITypes</key>
|
||||
<array>
|
||||
<dict>
|
||||
<key>NSPrivacyAccessedAPIType</key>
|
||||
<string>NSPrivacyAccessedAPICategoryFileTimestamp</string>
|
||||
<key>NSPrivacyAccessedAPITypeReasons</key>
|
||||
<array>
|
||||
<string>0A2A.1</string>
|
||||
<string>C617.1</string>
|
||||
</array>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>NSPrivacyAccessedAPIType</key>
|
||||
<string>NSPrivacyAccessedAPICategorySystemBootTime</string>
|
||||
<key>NSPrivacyAccessedAPITypeReasons</key>
|
||||
<array>
|
||||
<string>35F9.1</string>
|
||||
</array>
|
||||
</dict>
|
||||
</array>
|
||||
</dict>
|
||||
</plist>
|
||||
|
|
@ -0,0 +1,311 @@
|
|||
<?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>files</key>
|
||||
<dict>
|
||||
<key>Headers/Flutter.h</key>
|
||||
<data>
|
||||
wTPJHICwW6wxY3b87ek7ITN5kJk=
|
||||
</data>
|
||||
<key>Headers/FlutterAppDelegate.h</key>
|
||||
<data>
|
||||
zbvYFr9dywry0lMMrHuNOOaNgkY=
|
||||
</data>
|
||||
<key>Headers/FlutterBinaryMessenger.h</key>
|
||||
<data>
|
||||
ksjIMu5IPw+Q3rw2YkAx0KjxkdM=
|
||||
</data>
|
||||
<key>Headers/FlutterCallbackCache.h</key>
|
||||
<data>
|
||||
V/wkSSsyYdMoexF6wPrC3KgkL4g=
|
||||
</data>
|
||||
<key>Headers/FlutterChannels.h</key>
|
||||
<data>
|
||||
vFsZXNqjflvqKqAzsIptQaTSJho=
|
||||
</data>
|
||||
<key>Headers/FlutterCodecs.h</key>
|
||||
<data>
|
||||
sUgX1PJzkvyinL5i7nS1ro/Kd5o=
|
||||
</data>
|
||||
<key>Headers/FlutterDartProject.h</key>
|
||||
<data>
|
||||
1Ii7W6lYWZUeB6C6rtn269jAxgA=
|
||||
</data>
|
||||
<key>Headers/FlutterEngine.h</key>
|
||||
<data>
|
||||
AqVvCbPmgWMQKrRnib05Okrjbp0=
|
||||
</data>
|
||||
<key>Headers/FlutterEngineGroup.h</key>
|
||||
<data>
|
||||
nZcTgHGDD30QzPLlQfP8gP+S06o=
|
||||
</data>
|
||||
<key>Headers/FlutterHeadlessDartRunner.h</key>
|
||||
<data>
|
||||
UqnnVWwQEYYX56eu7lt6dpR3LIc=
|
||||
</data>
|
||||
<key>Headers/FlutterMacros.h</key>
|
||||
<data>
|
||||
crQ9782ULebLQfIR+MbBkjB7d+k=
|
||||
</data>
|
||||
<key>Headers/FlutterPlatformViews.h</key>
|
||||
<data>
|
||||
ocQVSiAiUMYfVtZIn48LpYTJA5w=
|
||||
</data>
|
||||
<key>Headers/FlutterPlugin.h</key>
|
||||
<data>
|
||||
EARXud6pHb7ZYP8eXPDnluMqcXk=
|
||||
</data>
|
||||
<key>Headers/FlutterPluginAppLifeCycleDelegate.h</key>
|
||||
<data>
|
||||
qWHw5VIWEa0NmJ1PMhD16nlfRKk=
|
||||
</data>
|
||||
<key>Headers/FlutterTexture.h</key>
|
||||
<data>
|
||||
7nFruy6bmD9XHvbzEwfdTXE4Rkk=
|
||||
</data>
|
||||
<key>Headers/FlutterViewController.h</key>
|
||||
<data>
|
||||
n0oqDKaGwBHcAUY4+7F+z78onKc=
|
||||
</data>
|
||||
<key>Info.plist</key>
|
||||
<data>
|
||||
4h4j8sv5dl7Tn/xCcbUeqZHdBTo=
|
||||
</data>
|
||||
<key>Modules/module.modulemap</key>
|
||||
<data>
|
||||
wJV5dCKEGl+FAtDc8wJJh/fvKXs=
|
||||
</data>
|
||||
<key>PrivacyInfo.xcprivacy</key>
|
||||
<data>
|
||||
D+cqXttvC7E/uziGjFdqFabWd7A=
|
||||
</data>
|
||||
<key>icudtl.dat</key>
|
||||
<data>
|
||||
Ubat0LvE4LUgCwHeyl0Anx2vnzk=
|
||||
</data>
|
||||
</dict>
|
||||
<key>files2</key>
|
||||
<dict>
|
||||
<key>Headers/Flutter.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
auaf7wPxiASCYD2ACy1dfbMJvmONwFvSz1BWYAQrrSw=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Headers/FlutterAppDelegate.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
o0iigVsmgwmtZfSv3X7hReDNYP5rXblslDnqq2s6UQc=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Headers/FlutterBinaryMessenger.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
EXDk4t+7qCpyQkar+q9WHqY9bcK8eyohCwGVtBJhMy8=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Headers/FlutterCallbackCache.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
0h9+vK5K+r8moTsiGBfs6+TM9Qog089afHAy3gbcwDU=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Headers/FlutterChannels.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
kg195C3vZLiOn8KeFQUy7DoVuA9VZDpqoBLVn64uGaI=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Headers/FlutterCodecs.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
ZyqlHYuZbpFevVeny9Wdl0rVFgS7szIyssSiCyaaeFM=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Headers/FlutterDartProject.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
Y5PEW7Tws4XpVmn15X/fdaU0d76hSeF803JlgrI20qE=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Headers/FlutterEngine.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
RAOC6nDhZdghbAzsIZgVeq6qPt+MUNTfm/vkUnhmZO4=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Headers/FlutterEngineGroup.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
I+878Ez9ZpVdAR2GOzKJKjaZ5m807AeAF++2pSMQss4=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Headers/FlutterHeadlessDartRunner.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
nmZjZpvFCXrygf4U9aPkNi8VcI7cL5AtA+CY5uUWIL0=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Headers/FlutterMacros.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
ebBVHSZcUnAbN4hRcYq3ttt6++z1Ybc8KVSYhVToD5k=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Headers/FlutterPlatformViews.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
4hl+kRU4PNNKdAHvYrliObXzSjRzow9Z18oOMRZIa0o=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Headers/FlutterPlugin.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
HqbvCHqKWTzs5GjLAwupqEIYVi9yf5CrMdMe31EOwUA=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Headers/FlutterPluginAppLifeCycleDelegate.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
+PMn+5SDj2Vd6RU8CQIt/JYl3T+8Dhp7HImqAzocoNk=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Headers/FlutterTexture.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
4kb25KahvBulQiElAYv/ZSbdkhkb5F/AKRZv4IjLsOw=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Headers/FlutterViewController.h</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
phm49xhui2KkRomlqtmASHuU7lmd/s3qNCQpYxC0IMc=
|
||||
</data>
|
||||
</dict>
|
||||
<key>Modules/module.modulemap</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
0VjriRpZ7AZZaP/0mMAPMJPhi6LoMB4MhXzL5j24tGs=
|
||||
</data>
|
||||
</dict>
|
||||
<key>PrivacyInfo.xcprivacy</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
n5XX54YqS1a2btkmvW1iLSplRagn0ZhHJ4tDjVcdQhI=
|
||||
</data>
|
||||
</dict>
|
||||
<key>icudtl.dat</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
ZepykIMSjfzhwAcmupMrkaqvXkhza1ZE3TdHjl8odaw=
|
||||
</data>
|
||||
</dict>
|
||||
</dict>
|
||||
<key>rules</key>
|
||||
<dict>
|
||||
<key>^.*</key>
|
||||
<true/>
|
||||
<key>^.*\.lproj/</key>
|
||||
<dict>
|
||||
<key>optional</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>1000</real>
|
||||
</dict>
|
||||
<key>^.*\.lproj/locversion.plist$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>1100</real>
|
||||
</dict>
|
||||
<key>^Base\.lproj/</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>1010</real>
|
||||
</dict>
|
||||
<key>^version.plist$</key>
|
||||
<true/>
|
||||
</dict>
|
||||
<key>rules2</key>
|
||||
<dict>
|
||||
<key>.*\.dSYM($|/)</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>11</real>
|
||||
</dict>
|
||||
<key>^(.*/)?\.DS_Store$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>2000</real>
|
||||
</dict>
|
||||
<key>^.*</key>
|
||||
<true/>
|
||||
<key>^.*\.lproj/</key>
|
||||
<dict>
|
||||
<key>optional</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>1000</real>
|
||||
</dict>
|
||||
<key>^.*\.lproj/locversion.plist$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>1100</real>
|
||||
</dict>
|
||||
<key>^Base\.lproj/</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>1010</real>
|
||||
</dict>
|
||||
<key>^Info\.plist$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>20</real>
|
||||
</dict>
|
||||
<key>^PkgInfo$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>20</real>
|
||||
</dict>
|
||||
<key>^embedded\.provisionprofile$</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>20</real>
|
||||
</dict>
|
||||
<key>^version\.plist$</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>20</real>
|
||||
</dict>
|
||||
</dict>
|
||||
</dict>
|
||||
</plist>
|
||||
Binary file not shown.
Binary file not shown.
|
|
@ -0,0 +1,101 @@
|
|||
<?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>files</key>
|
||||
<dict>
|
||||
<key>Info.plist</key>
|
||||
<data>
|
||||
v1M1+LmR8V3iPab3/MTIKVCK9K8=
|
||||
</data>
|
||||
</dict>
|
||||
<key>files2</key>
|
||||
<dict/>
|
||||
<key>rules</key>
|
||||
<dict>
|
||||
<key>^.*</key>
|
||||
<true/>
|
||||
<key>^.*\.lproj/</key>
|
||||
<dict>
|
||||
<key>optional</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>1000</real>
|
||||
</dict>
|
||||
<key>^.*\.lproj/locversion.plist$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>1100</real>
|
||||
</dict>
|
||||
<key>^Base\.lproj/</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>1010</real>
|
||||
</dict>
|
||||
<key>^version.plist$</key>
|
||||
<true/>
|
||||
</dict>
|
||||
<key>rules2</key>
|
||||
<dict>
|
||||
<key>.*\.dSYM($|/)</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>11</real>
|
||||
</dict>
|
||||
<key>^(.*/)?\.DS_Store$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>2000</real>
|
||||
</dict>
|
||||
<key>^.*</key>
|
||||
<true/>
|
||||
<key>^.*\.lproj/</key>
|
||||
<dict>
|
||||
<key>optional</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>1000</real>
|
||||
</dict>
|
||||
<key>^.*\.lproj/locversion.plist$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>1100</real>
|
||||
</dict>
|
||||
<key>^Base\.lproj/</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>1010</real>
|
||||
</dict>
|
||||
<key>^Info\.plist$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>20</real>
|
||||
</dict>
|
||||
<key>^PkgInfo$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>20</real>
|
||||
</dict>
|
||||
<key>^embedded\.provisionprofile$</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>20</real>
|
||||
</dict>
|
||||
<key>^version\.plist$</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>20</real>
|
||||
</dict>
|
||||
</dict>
|
||||
</dict>
|
||||
</plist>
|
||||
Binary file not shown.
Binary file not shown.
|
|
@ -0,0 +1,124 @@
|
|||
<?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>files</key>
|
||||
<dict>
|
||||
<key>Info.plist</key>
|
||||
<data>
|
||||
XmhHhW0qg+jpG7GrZmBfDxrOeCg=
|
||||
</data>
|
||||
<key>path_provider_foundation_privacy.bundle/Info.plist</key>
|
||||
<data>
|
||||
DSLEsxByUPMw7FRBswUujQst/zg=
|
||||
</data>
|
||||
<key>path_provider_foundation_privacy.bundle/PrivacyInfo.xcprivacy</key>
|
||||
<data>
|
||||
/LX0ZlwxwIAIhjZaDB8EiH5KpXA=
|
||||
</data>
|
||||
</dict>
|
||||
<key>files2</key>
|
||||
<dict>
|
||||
<key>path_provider_foundation_privacy.bundle/Info.plist</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
gCczwjUYM1pwEC5P1ufuX7wdMJmW4UlQAG08tMHay3k=
|
||||
</data>
|
||||
</dict>
|
||||
<key>path_provider_foundation_privacy.bundle/PrivacyInfo.xcprivacy</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
bS2g2NkwIn1CjB2TY7CtbjoS4sm2jFzilxWKdBL8jDE=
|
||||
</data>
|
||||
</dict>
|
||||
</dict>
|
||||
<key>rules</key>
|
||||
<dict>
|
||||
<key>^.*</key>
|
||||
<true/>
|
||||
<key>^.*\.lproj/</key>
|
||||
<dict>
|
||||
<key>optional</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>1000</real>
|
||||
</dict>
|
||||
<key>^.*\.lproj/locversion.plist$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>1100</real>
|
||||
</dict>
|
||||
<key>^Base\.lproj/</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>1010</real>
|
||||
</dict>
|
||||
<key>^version.plist$</key>
|
||||
<true/>
|
||||
</dict>
|
||||
<key>rules2</key>
|
||||
<dict>
|
||||
<key>.*\.dSYM($|/)</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>11</real>
|
||||
</dict>
|
||||
<key>^(.*/)?\.DS_Store$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>2000</real>
|
||||
</dict>
|
||||
<key>^.*</key>
|
||||
<true/>
|
||||
<key>^.*\.lproj/</key>
|
||||
<dict>
|
||||
<key>optional</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>1000</real>
|
||||
</dict>
|
||||
<key>^.*\.lproj/locversion.plist$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>1100</real>
|
||||
</dict>
|
||||
<key>^Base\.lproj/</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>1010</real>
|
||||
</dict>
|
||||
<key>^Info\.plist$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>20</real>
|
||||
</dict>
|
||||
<key>^PkgInfo$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>20</real>
|
||||
</dict>
|
||||
<key>^embedded\.provisionprofile$</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>20</real>
|
||||
</dict>
|
||||
<key>^version\.plist$</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>20</real>
|
||||
</dict>
|
||||
</dict>
|
||||
</dict>
|
||||
</plist>
|
||||
Binary file not shown.
Binary file not shown.
|
|
@ -0,0 +1,14 @@
|
|||
<?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>NSPrivacyTrackingDomains</key>
|
||||
<array/>
|
||||
<key>NSPrivacyAccessedAPITypes</key>
|
||||
<array/>
|
||||
<key>NSPrivacyCollectedDataTypes</key>
|
||||
<array/>
|
||||
<key>NSPrivacyTracking</key>
|
||||
<false/>
|
||||
</dict>
|
||||
</plist>
|
||||
Binary file not shown.
|
|
@ -0,0 +1,124 @@
|
|||
<?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>files</key>
|
||||
<dict>
|
||||
<key>Info.plist</key>
|
||||
<data>
|
||||
GTO3hvWAbTYScDBmtBoma33t9Ac=
|
||||
</data>
|
||||
<key>sqflite_darwin_privacy.bundle/Info.plist</key>
|
||||
<data>
|
||||
jpm8MATkKK8msOMpO+8c2o03UpI=
|
||||
</data>
|
||||
<key>sqflite_darwin_privacy.bundle/PrivacyInfo.xcprivacy</key>
|
||||
<data>
|
||||
YIiJ5tHvqBeSpBm2mcfVZdaGz3E=
|
||||
</data>
|
||||
</dict>
|
||||
<key>files2</key>
|
||||
<dict>
|
||||
<key>sqflite_darwin_privacy.bundle/Info.plist</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
tUpO4vn0k7ZIkRQS+R3EOZYBvdCMYDCfUzPJZu5hCno=
|
||||
</data>
|
||||
</dict>
|
||||
<key>sqflite_darwin_privacy.bundle/PrivacyInfo.xcprivacy</key>
|
||||
<dict>
|
||||
<key>hash2</key>
|
||||
<data>
|
||||
RyJqKWCN8gatChEOav61p3/1dawd+cdr/bLW37P6/tE=
|
||||
</data>
|
||||
</dict>
|
||||
</dict>
|
||||
<key>rules</key>
|
||||
<dict>
|
||||
<key>^.*</key>
|
||||
<true/>
|
||||
<key>^.*\.lproj/</key>
|
||||
<dict>
|
||||
<key>optional</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>1000</real>
|
||||
</dict>
|
||||
<key>^.*\.lproj/locversion.plist$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>1100</real>
|
||||
</dict>
|
||||
<key>^Base\.lproj/</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>1010</real>
|
||||
</dict>
|
||||
<key>^version.plist$</key>
|
||||
<true/>
|
||||
</dict>
|
||||
<key>rules2</key>
|
||||
<dict>
|
||||
<key>.*\.dSYM($|/)</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>11</real>
|
||||
</dict>
|
||||
<key>^(.*/)?\.DS_Store$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>2000</real>
|
||||
</dict>
|
||||
<key>^.*</key>
|
||||
<true/>
|
||||
<key>^.*\.lproj/</key>
|
||||
<dict>
|
||||
<key>optional</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>1000</real>
|
||||
</dict>
|
||||
<key>^.*\.lproj/locversion.plist$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>1100</real>
|
||||
</dict>
|
||||
<key>^Base\.lproj/</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>1010</real>
|
||||
</dict>
|
||||
<key>^Info\.plist$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>20</real>
|
||||
</dict>
|
||||
<key>^PkgInfo$</key>
|
||||
<dict>
|
||||
<key>omit</key>
|
||||
<true/>
|
||||
<key>weight</key>
|
||||
<real>20</real>
|
||||
</dict>
|
||||
<key>^embedded\.provisionprofile$</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>20</real>
|
||||
</dict>
|
||||
<key>^version\.plist$</key>
|
||||
<dict>
|
||||
<key>weight</key>
|
||||
<real>20</real>
|
||||
</dict>
|
||||
</dict>
|
||||
</dict>
|
||||
</plist>
|
||||
Binary file not shown.
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue