Skip to content

Commit

Permalink
docs(app, ios): update info on Podfile use_frameworks / compatibility
Browse files Browse the repository at this point in the history
  • Loading branch information
mikehardy committed Feb 22, 2024
1 parent 6952656 commit 3c0dc54
Showing 1 changed file with 4 additions and 6 deletions.
10 changes: 4 additions & 6 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -131,7 +131,7 @@ Within your existing `didFinishLaunchingWithOptions` method, add the following t

Beginning with firebase-ios-sdk v9+ (react-native-firebase v15+) you must tell CocoaPods to use frameworks.

Open the file `./ios/Podfile` and add this line inside your targets (right after the line calling the react native Podfile function to get the native modules config):
Open the file `./ios/Podfile` and add this line inside your targets (right before the `use_react_native` line in current react-native releases that calls the react native Podfile function to get the native modules config):

```ruby
use_frameworks! :linkage => :static
Expand All @@ -144,13 +144,11 @@ To use Static Frameworks on iOS, you also need to manually enable this for the p
$RNFirebaseAsStaticFramework = true
```

> Notes: React-Native-Firebase uses `use_frameworks`, which has compatibility issues with Flipper, Hermes & Fabric.
> Notes: React-Native-Firebase uses `use_frameworks`, which has compatibility issues with Flipper & Fabric.
>
> **Flipper:** `use_frameworks` [is _not_ compatible with Flipper](https://github.com/reactwg/react-native-releases/discussions/21#discussioncomment-2924919). You need to disable Flipper by commenting out the `:flipper_configuration` line in your Podfile.
> **Flipper:** `use_frameworks` [is _not_ compatible with Flipper](https://github.com/reactwg/react-native-releases/discussions/21#discussioncomment-2924919). You must disable Flipper by commenting out the `:flipper_configuration` line in your Podfile. Flipper is deprecated in the react-native community and this will not be fixed - Flipper and react-native-firebase will never work together on iOS.

This comment has been minimized.

Copy link
@artyorsh

artyorsh Apr 16, 2024

Hey @mikehardy I was reading through website docs and this exact line caught me. Can you please explain why is it deprecated?

This comment has been minimized.

Copy link
@mikehardy

mikehardy May 2, 2024

Author Collaborator

Hey @artyorsh I cannot, Flipper is not something we have ever supported so I have not tracked it's development or abandonment. You'll have to ask in the react-native or Flipper repositories why Flipper is being deprecated in the react-native ecosystem.

>
> **Hermes:** a fix was put in place in [react-native release 0.69.1](https://github.com/facebook/react-native/releases/tag/v0.69.1) that allows Hermes to work with `use_frameworks!`. To use `use_frameworks` with Hermes, make sure you have set static linkage with `use_frameworks! :linkage => :static`.
>
> **New Architecture:** Fabric is not compatible with `use_frameworks!`. Community support to help fix `use_frameworks` support for New Architecture is welcome!
> **New Architecture:** Fabric is partially compatible with `use_frameworks!`. If you enable the bridged / compatibility mode, react-native-firebase will compile correctly and be usable.
### 4. Autolinking & rebuilding

Expand Down

0 comments on commit 3c0dc54

Please sign in to comment.