You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Nov 22, 2024. It is now read-only.
Summary:
I really hope I hit everything and didn't break anything that wasn't
referring to branch names.
Pull Request resolved: #2689
Test Plan:
_eyes
CI
|[Site Preview: flipper](https://our.intern.facebook.com/intern/staticdocs/eph/D30305789/V2/flipper/)
Reviewed By: timur-valiev
Differential Revision: D30305789
Pulled By: passy
fbshipit-source-id: 5daaa09250bb96bb50be679fc01dae86c666eb73
Copy file name to clipboardExpand all lines: desktop/pkg/schemas/plugin-package-v2.json
+1-1
Original file line number
Diff line number
Diff line change
@@ -26,7 +26,7 @@
26
26
},
27
27
"icon": {
28
28
"type": "string",
29
-
"description": "Determines the plugin icon which is displayed in the main sidebar. The list of available icons is static for now and can be found in https://github.com/facebook/flipper/blob/master/desktop/static/icons.json."
29
+
"description": "Determines the plugin icon which is displayed in the main sidebar. The list of available icons is static for now and can be found in https://github.com/facebook/flipper/blob/main/desktop/static/icons.json."
30
30
},
31
31
"keywords": {
32
32
"description": "This helps people discover your package as it's listed in 'npm search'. To make the plugin discoverable in Flipper, the property must contain \"flipper-plugin\" keyword.",
Copy file name to clipboardExpand all lines: docs/extending/desktop-plugin-structure.mdx
+1-1
Original file line number
Diff line number
Diff line change
@@ -91,7 +91,7 @@ Important attributes of `package.json`:
91
91
92
92
-`title` Shown in the main sidebar as the human-readable name of the plugin.
93
93
94
-
-`icon` Determines the plugin icon which is displayed in the main sidebar. The list of available icons is static for now: https://github.com/facebook/flipper/blob/master/desktop/static/icons.json.
94
+
-`icon` Determines the plugin icon which is displayed in the main sidebar. The list of available icons is static for now: https://github.com/facebook/flipper/blob/main/desktop/static/icons.json.
95
95
96
96
-`bugs` Specify an email and/or url, where plugin bugs should be reported.
Copy file name to clipboardExpand all lines: docs/extending/establishing-a-connection.mdx
+1-1
Original file line number
Diff line number
Diff line change
@@ -72,4 +72,4 @@ For Flipper desktop to work with a given Client type, it needs to be modified to
72
72
73
73
`destination` field may not be relevant if your `medium` value is more than 1. `medium=1`(default) means Flipper should do certificate exchange by directly putting certificates at `destination` in the sandbox of the app. `medium=2` means Flipper will use Certificate Uploader and Provider to upload certificates and download it on the client side respectively.
74
74
75
-
You can see the current implementations in [CertificateProvider.tsx](https://github.com/facebook/flipper/blob/master/desktop/app/src/utils/CertificateProvider.tsx).
75
+
You can see the current implementations in [CertificateProvider.tsx](https://github.com/facebook/flipper/blob/main/desktop/app/src/utils/CertificateProvider.tsx).
Copy file name to clipboardExpand all lines: docs/extending/new-clients.mdx
+2-2
Original file line number
Diff line number
Diff line change
@@ -7,7 +7,7 @@ In the GitHub repo, you'll find Flipper clients for Android, iOS and C++ code, b
7
7
8
8
Flipper clients communicate with the Flipper desktop app using JSON RPC messages over an [RSocket](http://rsocket.io/) connection.
9
9
10
-
This page documents the API, and you can use [FlipperConnectionManagerImpl.cpp](https://github.com/facebook/flipper/blob/master/xplat/Flipper/FlipperConnectionManagerImpl.cpp) for reference.
10
+
This page documents the API, and you can use [FlipperConnectionManagerImpl.cpp](https://github.com/facebook/flipper/blob/main/xplat/Flipper/FlipperConnectionManagerImpl.cpp) for reference.
11
11
12
12
## Establishing a connection
13
13
Start by connecting to the Flipper server running within the desktop app. Connecting to the server registers your application with Flipper and enables plugins to interact with it. As the Flipper desktop has a different lifecycle than your app and may connect and disconnect at any time it is important that you attempt to reconnect to the Flipper server until it accepts your connection.
@@ -37,7 +37,7 @@ localhost:8088/sonar?os={OS}
37
37
38
38
**FOREGROUND**: A boolean indicating whether this connection was established with a foreground process. This is a hint to the Flipper desktop app of whether to re-focus on this connection or not. For example `foreground=true`. This parameter is recommended but optional.
39
39
40
-
**SDK_VERSION**: A number indicating the latest protocol version this client is compatible with. You can find the current version in our [C++ connection implementation](https://github.com/facebook/flipper/blob/master/xplat/Flipper/FlipperConnectionManagerImpl.cpp#L37). Usually stored as a constant in the client code, this allows protocol changes to be made whilst still preserving connectivity with old clients. When Flipper desktop encounters an old SDK version, it may attempt to communicate using a matching protocol. However, backwards compatibility is not guaranteed and you should strive to update clients on the rare occasion that the protocol version advances.
40
+
**SDK_VERSION**: A number indicating the latest protocol version this client is compatible with. You can find the current version in our [C++ connection implementation](https://github.com/facebook/flipper/blob/main/xplat/Flipper/FlipperConnectionManagerImpl.cpp#L37). Usually stored as a constant in the client code, this allows protocol changes to be made whilst still preserving connectivity with old clients. When Flipper desktop encounters an old SDK version, it may attempt to communicate using a matching protocol. However, backwards compatibility is not guaranteed and you should strive to update clients on the rare occasion that the protocol version advances.
Copy file name to clipboardExpand all lines: docs/extending/public-releases.mdx
+11-11
Original file line number
Diff line number
Diff line change
@@ -11,9 +11,9 @@ This document outlines how Flipper releases work on GitHub.
11
11
A release is kicked off by a special commit that has a subject with the format
12
12
`Flipper Release vX.Y.Z`, e.g. [4fa2c9761](https://github.com/facebook/flipper/commit/4fa2c9761a8359c65ccc62fee76490572616f0c1).
13
13
14
-
This is triggered from a bot within Facebook that runs [prepare-release.sh](https://github.com/facebook/flipper/blob/master/scripts/prepare-release.sh)
14
+
This is triggered from a bot within Facebook that runs [prepare-release.sh](https://github.com/facebook/flipper/blob/main/scripts/prepare-release.sh)
15
15
but the only thing special about the commit is its subject line. Anyone could run the
16
-
script and would kick off the remaining jobs once the commit lands in master.
16
+
script and would kick off the remaining jobs once the commit lands in main.
17
17
18
18
The commit bumps the version of Flipper Desktop as well as various SDK components
19
19
and libraries that are to be published to npm and other package repositories.
@@ -27,7 +27,7 @@ releases from the main branch.
27
27
## Desktop Release
28
28
29
29
The release process for the desktop app is entirely driven by [GitHub Actions](https://github.com/features/actions).
30
-
The entry point is the [release.yml](https://github.com/facebook/flipper/blob/master/.github/workflows/release.yml) workflow
30
+
The entry point is the [release.yml](https://github.com/facebook/flipper/blob/main/.github/workflows/release.yml) workflow
31
31
which is triggered by changes to the `desktop/package.json` file on the main branch.
32
32
33
33
GitHub Actions has a limitation we need to work around here: It allows push events to as triggers for
@@ -55,7 +55,7 @@ iOS releases are run in GitHub Actions but exist as a separate workflow. They ca
55
55
56
56
<imgalt="Manually triggering a workflow"src={useBaseUrl("img/trigger-publish-pod-workflow.png")} />
57
57
58
-
[The workflow](https://github.com/facebook/flipper/blob/master/.github/workflows/publish-pods.yml) follows the default Cocoapods update procedure, bumps and published both the Flipper and FlipperKit pod
58
+
[The workflow](https://github.com/facebook/flipper/blob/main/.github/workflows/publish-pods.yml) follows the default Cocoapods update procedure, bumps and published both the Flipper and FlipperKit pod
59
59
and finally creates a [pull request](https://github.com/facebook/flipper/pull/1754) containing the updated references. This PR must be manually merged.
60
60
61
61
**Authentication** is managed through the secret environment variable `COCOAPODS_TRUNK_TOKEN`.
@@ -64,9 +64,9 @@ and finally creates a [pull request](https://github.com/facebook/flipper/pull/17
64
64
65
65
The JavaScript libraries published as part of a Flipper release closely follow the iOS release procedure.
66
66
Same as before, it is a workflow that is triggered by one of the three events, which should in all but
67
-
exceptional circumstances be a dispatch event. The workflow is defined in [publish-npm.yml](https://github.com/facebook/flipper/blob/master/.github/workflows/publish-npm.yml).
67
+
exceptional circumstances be a dispatch event. The workflow is defined in [publish-npm.yml](https://github.com/facebook/flipper/blob/main/.github/workflows/publish-npm.yml).
68
68
69
-
From there, we use a [script](https://github.com/facebook/flipper/blob/master/desktop/scripts/bump-versions.ts) to
69
+
From there, we use a [script](https://github.com/facebook/flipper/blob/main/desktop/scripts/bump-versions.ts) to
70
70
bump the versions of our Yarn workspaces, and publish all public packages (`flipper`, `flipper-babel-transformer`, ...)
71
71
and our React Native bindings.
72
72
@@ -81,16 +81,16 @@ due to timeouts or network errors isn't a dealbreaker.
81
81
82
82
The three jobs are:
83
83
84
-
1. The [`snapshot`](https://github.com/facebook/flipper/blob/master/.github/workflows/android-sample.yml) job runs on every commit on the main branch and publishes "SNAPSHOT" releases to Maven Central. It runs on CircleCI.
85
-
2. The [`publish-android`](https://github.com/facebook/flipper/blob/master/.github/workflows/publish-android.yml) job is usually triggered by a `dispatch_workflow` event. It uploads our Java artifacts to Maven Central and attaches the Android sample app to the release page on GitHub. It runs on GitHub Actions.
86
-
3. The [`android-sample`](https://github.com/facebook/flipper/blob/master/.github/workflows/android-sample.yml) job runs on every push and open pull request. It builds the sample and tutorial apps and uploads the sample APK as artifact for easy debugging and testing.
84
+
1. The [`snapshot`](https://github.com/facebook/flipper/blob/main/.github/workflows/android-sample.yml) job runs on every commit on the main branch and publishes "SNAPSHOT" releases to Maven Central. It runs on CircleCI.
85
+
2. The [`publish-android`](https://github.com/facebook/flipper/blob/main/.github/workflows/publish-android.yml) job is usually triggered by a `dispatch_workflow` event. It uploads our Java artifacts to Maven Central and attaches the Android sample app to the release page on GitHub. It runs on GitHub Actions.
86
+
3. The [`android-sample`](https://github.com/facebook/flipper/blob/main/.github/workflows/android-sample.yml) job runs on every push and open pull request. It builds the sample and tutorial apps and uploads the sample APK as artifact for easy debugging and testing.
Copy file name to clipboardExpand all lines: docs/features/react-native.mdx
+1-1
Original file line number
Diff line number
Diff line change
@@ -60,4 +60,4 @@ The React Native community has also started to build plugins for Flipper.
60
60
61
61
*[Reactotron's](https://infinite.red/reactotron)[Flipper plugin](https://github.com/infinitered/flipper-plugin-reactotron) is an example of a standalone React Native desktop app, [ported to work as a Flipper plugin](https://shift.infinite.red/better-react-native-debugging-with-reactotron-in-flipper-6b823af29220).
62
62
63
-
*Got your own Flipper plugin for React Native you want to plug here? Please sent us a [Pull Request](https://github.com/facebook/flipper/blob/master/docs/features/react-native.mdx)!*
63
+
*Got your own Flipper plugin for React Native you want to plug here? Please sent us a [Pull Request](https://github.com/facebook/flipper/blob/main/docs/features/react-native.mdx)!*
0 commit comments