a3f7e6aa59
Summary: Update the docs to include Windows and Linux. Pull Request resolved: https://github.com/facebook/flipper/pull/572 Test Plan: eyes Reviewed By: jknoxville Differential Revision: D17738803 Pulled By: passy fbshipit-source-id: 8e556fb6b3e57de6f3334286e83a59a48dbdd982
89 lines
4.0 KiB
Markdown
89 lines
4.0 KiB
Markdown
---
|
|
id: troubleshooting
|
|
title: Troubleshooting Issues
|
|
sidebar_label: Troubleshooting Issues
|
|
---
|
|
|
|
We hope that flipper works well out of the box, but the software is a work in progress and problems will occur. Below are some known issues and steps you can take to try to resolve them.
|
|
|
|
## Mac Desktop app
|
|
|
|
### Flipper won't launch on Mac
|
|
|
|
* If the window is appearing, try opening the Chrome DevTools within Flipper. To do so, from the View menu select Toggle Developer Tools or press CMD+Option+I and check if there are any errors on the console.
|
|
* Launch Flipper from the command line using `/Applications/Flipper.app/Contents/MacOS/Flipper`. This should give you some logs, that might be helpful when debugging.
|
|
* Delete `~/.flipper` and try relaunching Flipper.
|
|
* Delete Flipper from your applications folder and redownload [Flipper](https://www.facebook.com/fbflipper/public/mac).
|
|
* If you're using `yarn start` to run from source, make sure all dependencies are installed correctly by running yarn install.
|
|
|
|
### iOS Simulator missing from devices dropdown
|
|
|
|
* Check that `xcode-select -p` shows the same XCode version that you're using. If not, see xcode-select for how to select the correct version.
|
|
|
|
### No plugins showing up for your device
|
|
|
|
* Check your device isn't on the list of [known incompatibilities](#known-incompatibilities).
|
|
* Make sure your version of Flipper is up to date.
|
|
* Make sure the mobile SDK you are using is relatively recent (<1 month old).
|
|
* Open Chrome dev tools within Flipper. To do so, from the View menu select Toggle Developer Tools or press CMD+Option+I and check if there are any errors on the console.
|
|
* Delete `~/.flipper`.
|
|
* **Uninstall** and reinstall the mobile app.
|
|
* Make sure the time and date are set correctly on your mobile device and desktop computer.
|
|
* If no app plugins are showing up, there may be a connectivity issue between Flipper and your app. Check [connection issues](#connection-issues) to see if anything is failing.
|
|
|
|
### Connection Issues
|
|
The Flipper SDK includes an in-app connection diagnostics screen to help you diagnose problems.
|
|
|
|
#### Android
|
|
Replace `<APP_PACKAGE>` below with the package name of your app, e.g. `com.facebook.flipper.sample`.
|
|
On a terminal, run the following:
|
|
```bash
|
|
adb shell am start -n <APP_PACKAGE>/com.facebook.flipper.android.diagnostics.FlipperDiagnosticActivity
|
|
```
|
|
This will only work if you added `FlipperDiagnosticActivity` to your `AndroidManifest.xml`. See [getting started](getting-started.html) for help.
|
|
|
|
#### iOS
|
|
You'll need to manually add this [ViewController](https://github.com/facebook/flipper/blob/master/iOS/FlipperKit/FlipperDiagnosticsViewController.m) to your app to see the in-app diagnostics.
|
|
|
|
### Known Incompatibilities
|
|
The following devices are known to be incompatible or face issues with flipper:
|
|
* Physical iOS devices. Currently on iOS, only simulators are supported ([Tracking Issue](https://github.com/facebook/flipper/issues/262)).
|
|
* Some Samsung devices ([Tracking Issue](https://github.com/facebook/flipper/issues/92)).
|
|
* Genymotion emulators on Android 8+ are reported to have issues.
|
|
|
|
### File an Issue
|
|
Still not working? File an issue on [GitHub](https://github.com/facebook/flipper/issues) with the chrome DevTools logs and the output from the diagnostics screen, if relevant.
|
|
|
|
## Android
|
|
|
|
Build error after including the Flipper dependency:
|
|
|
|
```
|
|
Exception from call site #4 bootstrap method
|
|
```
|
|
|
|
This can happen because we include [OkHttp3](https://github.com/square/okhttp/issues/4597#issuecomment-461204144) as dependency which makes use of Java 8 features. There are two ways of dealing with this:
|
|
|
|
**Enable Java 8 support**
|
|
|
|
Add this to your Gradle config:
|
|
|
|
```groovy
|
|
android {
|
|
compileOptions {
|
|
targetCompatibility = "8"
|
|
sourceCompatibility = "8"
|
|
}
|
|
}
|
|
```
|
|
|
|
**Exclude the OkHttp3 dependency**
|
|
|
|
Alternatively, if you don't plan on making use of OkHttp, you can exclude the dependency from the build entirely:
|
|
|
|
```
|
|
debugImplementation('com.facebook.flipper:flipper:*') {
|
|
exclude group: 'com.squareup.okhttp3'
|
|
}
|
|
```
|