rns

react-native-swift

Add support for swift static libraries to React Native-built apps

Showing:

Popularity

Downloads/wk

5.6K

GitHub Stars

85

Maintenance

Last Commit

1yr ago

Contributors

0

Package

Dependencies

2

License

MIT

Type Definitions

Tree-Shakeable

No?

Categories

Readme

react-native-swift

Fixes a React Native Xcode project to permit Swift-based native components.

npm version platform GitHub license

Requirements

  • XCode 9.0 or newer.
  • React Native 0.60 or newer (haven't tested it lower than that)

NEW: Add react-native-swift-cli to simplify development!

react-native-swift-cli includes a helper utility for initializing new swift-based components.

yarn global add react-native-swift-cli

To learn how it works:

react-native-swift --help

Adding to your app

Even when not using react-native-swift-cli you can add a Swift-based native module to you app relatively easily.

yarn add myproject
yarn add react-native-swift
react-native swiftify

The react-native-swift package will, via react-native link, take care of compatibility between your react native and the Swift based component. Done!

How it works

Starting in XCode 9.0, you can create static libaries that contain swift code. Just create swift code the way found on the react-native documentation and add it to a static library. For reasons unknown, a couple flags need to get set inside the Xcode project file for the app to work with the library. This package forces that issue by adding a blank swift file to the build phases of the app targets, and setting the swift version flag.

Future versions of Xcode may get less stupid and obviate the need for this package! Hopefully the templates remain a little helpful.

Tips

If you create a swift-based native component on your own (e.g. without react-native-swift init) the best practice is to add "react-native-swift" to the peerDependencies object. Will help others know how to make your module "just work." It will have pretty much no effect if it is buried in the tree.

Time for me to confess that this is my first FOSS project. Let me know how it works for you! @ me: @ray_deck on twitter and rhdeck on Github.

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100