aa649ff48f
Summary: `/*` is the standard throughout open source code. For example, Firefox uses single /*: https://hg.mozilla.org/mozilla-central/file/21d22b2f541258d3d1cf96c7ba5ad73e96e616b5/gfx/ipc/CompositorWidgetVsyncObserver.cpp#l3 In addition, Rust considers `/**` to be a doc comment (similar to Javadoc) and having such a comment at the beginning of the file causes `rustc` to barf. Note that some JavaScript tooling requires `/**`. This is OK since JavaScript files were not covered by the linter in the first place, but it would be good to have that tooling fixed too. Reviewed By: zertosh Differential Revision: D15640366 fbshipit-source-id: b4ed4599071516364d6109720750d6a43304c089
71 lines
1.6 KiB
Objective-C
71 lines
1.6 KiB
Objective-C
/*
|
|
* Copyright (c) Facebook, Inc. and its affiliates.
|
|
*
|
|
* 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
|