Not every app uses all the native capabilities, and including the code to support all those features would impact the binary size... But we still want to support adding these features whenever you need them.
With that in mind we exposed many of these features as independent static libraries.
For most of the libs it will be as quick as dragging two files, sometimes a third step will be necessary, but no more than that.
All the libraries we ship with React Native live on the
require it. Other libraries also rely on some native code, in that case you'll have to add these files to your app, otherwise the app will throw an error as soon as you try to use the library.
Install a library with native dependencies:
$ npm install <library-with-native-dependencies> --save
--save-devflag is very important for this step. React Native will link your libs based on
Link your native dependencies:
$ npx react-native link
Done! All libraries with native dependencies should be successfully linked to your iOS/Android project.
Note: If your iOS project is using CocoaPods (contains
Podfile) and linked library has
npx react-native linkwill link library using Podfile. To support non-trivial Podfiles add
# Add new pods below this linecomment to places where you expect pods to be added.
If the library has native code, there must be an
.xcodeproj file inside its folder. Drag this file to your project on Xcode (usually under the
Libraries group on Xcode);
Click on your main project file (the one that represents the
Build Phases and drag the static library from the
Products folder inside the Library you are importing to
Link Binary With Libraries
Not every library will need this step, what you need to consider is:
Do I need to know the contents of the library at compile time?
If you do need to call it from native, then we need to know the library's headers. To achieve that you have to go to your project's file, select
Build Settings and search for
Header Search Paths. There you should include the path to your library. (This documentation used to recommend using
recursive, but this is no longer recommended, as it can cause subtle build failures, especially with CocoaPods.)