b0d2983bd4
Summary: adding code tabs for Android, iOS and C++ to improve readability of pages. Reviewed By: jknoxville Differential Revision: D15167691 fbshipit-source-id: e7f602a3a1cbe39ef5da0a15bb0bbfc8f79e8ccc
50 lines
1.7 KiB
Markdown
50 lines
1.7 KiB
Markdown
---
|
|
id: send-data
|
|
title: Sending Data to Plugins
|
|
---
|
|
|
|
It is often useful to get an instance of a Flipper plugin to send data to it. Flipper makes this simple with built-in support.
|
|
|
|
Plugins should be treated as singleton instances as there can only be one `FlipperClient` and each `FlipperClient` can only have one instance of a certain plugin. The Flipper API makes this simple by offering a way to get the current client and query it for plugins.
|
|
|
|
Plugins are identified by the string that their identifier method returns, in this example, "MyFlipperPlugin":
|
|
|
|
|
|
<!--DOCUSAURUS_CODE_TABS-->
|
|
<!--Android-->
|
|
```java
|
|
final FlipperClient client = AndroidFlipperClient.getInstance(context);
|
|
// Client may be null if AndroidFlipperClient.createInstance() was never called
|
|
// which is the case in production builds.
|
|
if (client != null) {
|
|
final MyFlipperPlugin plugin = client.getPluginByClass(MyFlipperPlugin.class);
|
|
plugin.sendData(myData);
|
|
}
|
|
```
|
|
<!--iOS-->
|
|
```objective-c
|
|
FlipperClient *client = [FlipperClient sharedClient];
|
|
MyFlipperPlugin *myPlugin = [client pluginWithIdentifier:@"MyFlipperPlugin"];
|
|
[myPlugin sendData:myData];
|
|
```
|
|
<!--C++-->
|
|
```c++
|
|
auto &client = FlipperClient::instance();
|
|
|
|
// "MyFlipperPlugin is the return value of MyFlipperPlugin::identifier()
|
|
auto aPlugin = client.getPlugin("MyFlipperPlugin");
|
|
|
|
// aPlugin is a std::shared_ptr<FlipperPlugin>. Downcast to expected type.
|
|
auto myPlugin = std::static_pointer_cast<MyFlipperPlugin>(aPlugin);
|
|
|
|
// Alternatively, use the templated version
|
|
myPlugin = client.getPlugin<MyFlipperPlugin>("MyFlipperPlugin");
|
|
|
|
myPlugin->sendData(myData);
|
|
```
|
|
```
|
|
<!--END_DOCUSAURUS_CODE_TABS-->
|
|
|
|
|
|
Here, `sendData` is an example of a method that might be implemented by the Flipper plugin.
|