FlipperLite is a new Swift package that exposes a Flipper client to your iOS | MacOS applications that allow you to easily develop new or reuse existing Flipper plugins.
It gives you all that the official Flipper SDK provides and also has lesser and lightweight dependencies as compared to the official SDK. This SDK doesn’t depend on boost, glog, folly etc and so it's quite light weight relatively.
This repository has a bunch of example applications that you can play with to understand how to write a Flipper plugin, how to send/listen to events, and how the end-to-end integration works. (UserDefaults Plugin, Network Plugin, Custom Logger Plugin, Notifications plugin, Tic-Tac-Toe to demonstrate bi-directional communication etc.)
swift-flipper basically has most of the core changes in Swift, as required by the official Flipper documentation. The idea was to extend the swift-flipper SDK to get secure device connectivity in the same way as the official Flipper SDK does, so that all the limitations of swift-flipper are addressed and that too with a significantly reduced dependency set as compared to the official SDK. Hence, FlipperLite was created.
We get full support of device specific functionality. (screenshot, video recording from the Flipper IDE, Logs Plugin etc.) Connection via simulator or via USB connected device is totally transparent to the developers.
General: https://fbflipper.com/docs/getting-started/troubleshooting/general/
Source: https://fbflipper.com/docs/getting-started/troubleshooting/ios/
Make sure idb is installed and configured in the Flipper settings.
Ensure that your simulator is on the same version as selected in xcode-select. You can do that by checking that commands ps aux | grep CoreSimulator and xcode-select -p shows the same Xcode version. If not, update the xcode version by sudo xcode-select --switch
If during connecting the iOS app to Flipper you see an error message "Connection failed. Failed to find device <device_id> while trying to connect app" - try executing idb kill on a terminal and restarting Flipper as a workaround to reset idb state.
Please note: this package is only covering the client SDK pieces so all IDE related issues should be reported in the official flipper github forums.
-
Apple Silicon Flipper IDE is not a universal binary and is translated via Rosetta. This is being tracked in facebook/flipper#3553.
-
NSLog from a Swift application are not shown in the Logs plugin. This is being tracked in facebook/flipper#3823.
- https://fbflipper.com/
- https://engineering.fb.com/2018/06/11/android/flipper/
- https://fbflipper.com/blog/2022/02/21/js-flipper-announcement/
- Mobile@Scale Tel Aviv – Flipper: An extensible mobile app debugger - https://www.facebook.com/atscaleevents/videos/mobilescale-tel-aviv-flipper-an-extensible-mobile-app-debugger/2210661825632394/
- Flipper and JS: why we added JavaScript support to a mobile debugging platform
- https://www.youtube.com/watch?v=WCs09c1B1Lk
- Flipper: The Extensible DevTool Platform for React Native - Michel Weststrate aka @mweststrate - https://www.youtube.com/watch?v=WltZTn3ODW4