Files
flipper/docs/getting-started/index.mdx
Steven Conaway 26aef92dc5 Add brew instructions for mac (#2108)
Summary:
Thought I'd add this to the getting started, since so many people end up downloading the release directly.

## Changelog

Added `brew` instructions for mac

Pull Request resolved: https://github.com/facebook/flipper/pull/2108

Test Plan: Just docs, so no testing needed

Reviewed By: mweststrate

Differential Revision: D27398664

Pulled By: passy

fbshipit-source-id: be9cc7007e7c5dc717aad60ec0591d4ca0d100cb
2021-03-29 10:11:51 -07:00

38 lines
2.0 KiB
Plaintext

---
id: index
title: Desktop App
---
import useBaseUrl from '@docusaurus/useBaseUrl';
import FbInstallation from './fb/installation.mdx';
Flipper helps you debug Android and iOS apps running in an emulator/simulator or connected physical development devices. Flipper consists of two parts:
- The desktop app
- The native mobile SDKs for Android and iOS
Once you start Flipper and launch an emulator/simulator or connect a device, you'll start to see the device logs (and any other device-level plugins that work with your device).
To see app specific data, you need to integrate the Flipper SDK into your app. See the relevant section in the sidebar for how to do that.
## Installation
<OssOnly>
The desktop part of Flipper doesn't need any particular setup. Simply download the latest build for [Mac](https://www.facebook.com/fbflipper/public/mac), [Linux](https://www.facebook.com/fbflipper/public/linux) or [Windows](https://www.facebook.com/fbflipper/public/windows) and launch it. If you're on macOS, you can run `brew install --cask flipper` to let `homebrew` manage installation and upgrades (simply run `brew upgrade` to upgrade when a new version is released, although it might take a few hours up to a day for the package to be upgraded on `homebrew`).
In order to work properly, Flipper requires a working installation of the Android and (if where applicable) iOS development tools on your system, as well as the [OpenSSL](https://www.openssl.org) binary on your `$PATH`.
A compatible OpenSSL for Windows can be downloaded [here](https://slproweb.com/products/Win32OpenSSL.html) or from Chocolatey with `choco install openssl`.
</OssOnly>
<FbInternalOnly>
<FbInstallation />
</FbInternalOnly>
## Troubleshooting
If you run into problems, check out the [troubleshooting page](../troubleshooting.mdx), and failing that, check <OssOnly>[GitHub Issues](https://github.com/facebook/flipper/issues).</OssOnly><FbInternalOnly>the [workplace group](https://fb.workplace.com/groups/230455004101832/).</FbInternalOnly>