Files
flipper/iOS/SonarKit/FlipperClient.h
Pritesh Nandgaonkar f970e60edd Rename iOS SonarPlugin to FlipperPlugin
Summary: Rename iOS SonarPlugin to FlipperPlugin

Reviewed By: jknoxville

Differential Revision: D9915094

fbshipit-source-id: ea2ca60ab578aca8c8f028e3deea4a3b9a48a63b
2018-09-18 09:58:08 -07:00

72 lines
1.6 KiB
Objective-C

/*
* Copyright (c) 2018-present, Facebook, Inc.
*
* This source code is licensed under the MIT license found in the LICENSE
* file in the root directory of this source tree.
*
*/
#ifdef FB_SONARKIT_ENABLED
#import <Foundation/Foundation.h>
#import "FlipperPlugin.h"
#import "FlipperStateUpdateListener.h"
/**
Represents a connection between the Sonar desktop och client side. Manages the lifecycle of attached
plugin instances.
*/
@interface FlipperClient : NSObject
/**
The shared singleton FlipperClient instance. It is an error to call this on non-debug builds to avoid leaking data.
*/
+ (instancetype)sharedClient;
/**
Register a plugin with the client.
*/
- (void)addPlugin:(NSObject<FlipperPlugin> *)plugin;
/**
Unregister a plugin with the client.
*/
- (void)removePlugin:(NSObject<FlipperPlugin> *)plugin;
/**
Retrieve the plugin with a given identifier which was previously registered with this client.
*/
- (NSObject<FlipperPlugin> *)pluginWithIdentifier:(NSString *)identifier;
/**
Establish a connection to the Sonar desktop.
*/
- (void)start;
/**
Stop the connection to the Sonar desktop.
*/
- (void)stop;
/**
Get the log of state changes from the sonar client
*/
- (NSString *)getState;
/**
Get the current summarized state of the sonar client
*/
- (NSArray<NSDictionary *> *)getStateElements;
/**
Subscribe a ViewController to state update change notifications
*/
- (void)subscribeForUpdates:(id<FlipperStateUpdateListener>)controller;
// initializers are disabled. You must use `+[FlipperClient sharedClient]` instance.
- (instancetype)init NS_UNAVAILABLE;
+ (instancetype)new NS_UNAVAILABLE;
@end
#endif