fix(Android): add custom fragment factory & modify library installation steps to prevent on-restoration crashes

[Skalakid]

Description

This PR replaces the current workaround for crashes connected to the configuration changes on Android. The previous fix required disabling passing saved instance state in Activity onCreate - onCreate(null). Such a solution generates a problem with state persistence on the native side of brownfield applications. Because of that, we decided to replace it with a custom fragment factory that will limit the scope of the solution and fix the problem directly only on the React Native side. All fragments connected to the RN Screens package will be replaced with self-destructing ones, which will prevent Android from recreating the Fragment after the configuration change. We will leave this responsibility for React Native. Thanks to that, there won't be any conflict between the Android system and React Native, and we will prevent the app from crashing or any other app appearance-related issues.

Credits to @bojanlozanovski77 for bringing up the idea in #2917

Fixes: #17

Changes

• Created a custom fragment factory (RNScreensFragmentFactory.kt) that won't instantiate RN Screens fragments
• Created self-destructing fragments (NoOpFragment.kt) that will be instanciated by the RNScreensFragmentFactory, to prevent the conflict that crashes the app
• Updated installation steps in library README
• Applied the fix in MainActivity files of FabricExample and Example apps

Test code and steps to reproduce

1. Remove ignoring config changes in AndroidManifest.xml file

<activity
    android:name=".MainActivity"
    android:label="@string/app_name"
-   android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|screenSize|smallestScreenSize|uiMode"
    android:launchMode="singleTask"
    ...

2. Launch the example app
3. Verify if the app isn't crashing when causing different types of configuration changes on Android. For example:
   • Orientation change on devices ≥600dp with portrait lock
   • Opening/closing foldables or flip phones
   • Split/Multi-Window mode
   • Desktop windowing on tablets
   • Launching external activities (e.g. system Photo Picker)
   • Changing accessibility settings, permissions, system fonts, wallpapers, or language

Checklist

• Included code example that can be used to test this change
• Updated TS types
• Updated documentation:
  • https://github.com/software-mansion/react-native-screens/blob/main/guides/GUIDE_FOR_LIBRARY_AUTHORS.md
  • https://github.com/software-mansion/react-native-screens/blob/main/native-stack/README.md
  • https://github.com/software-mansion/react-native-screens/blob/main/src/types.tsx
  • https://github.com/software-mansion/react-native-screens/blob/main/src/native-stack/types.tsx
• Ensured that CI passes

[kkafar]

This looks really good overall. I have only few cosmetic changes requests.

I haven't tested the runtime though, will do when I tackle upgrade to 0.81.

Let's also give a credit to @bojanlozanovski77, who suggested this idea to us in the PR description. I see that you added him as co-author of commits - and that's awesome!

[kkafar]

I like this!

[kkafar]

Seems that runtime works fine.

I've done some small refactors & will land this once the CI passes.

Thanks!