A framework for building native apps with React. http://facebook.github.io/react-native/
Go to file
Valentin Shergin e581977b51 Introducing RCTComponentViewFactory
Summary:
The whole mounting iOS infra now uses `ComponentHandle` instead of `std::string` as a reference to particular `ComponentView` implementation. All changes are pretty straightforward, we use a different thing/type to refer to the particular class; no changes in the logic besides a new `RCTComponentViewFactory` that serves the same role of classes registry as Objective-C runtime served previously.
That has several benefits:
* It should be slightly faster, mostly because we don't need to convert `char *` strings to `std::string` and then to `NSString *`.
* We don't need string-based component-name maps anymore (at least on this layer). We can call classes as we want and it will work because of classes are now explicit about which ShadowNodes they are compatible with.
* Most importantly, it's explicit now! That means that no runtime magic is involved anymore and we can rely on static linting tool now and not be afraid of improper code stripping/overoptimization.

Reviewed By: mdvacca

Differential Revision: D13130760

fbshipit-source-id: aadf70525a1335b96992443abae4da359efdc829
2018-11-25 22:17:30 -08:00
.circleci bump buck to 2018.10.29.01. fixes Android CI (#22049) 2018-10-31 21:42:36 -07:00
.github Make PR template consistent with Changelog (#22117) 2018-11-04 11:29:52 -08:00
ContainerShip Fix linting issues (#22062) 2018-11-01 14:29:16 -07:00
IntegrationTests Fix inline styles in IntegrationTests (#22165) 2018-11-06 13:50:57 -08:00
Libraries Back out "[react-native][PR] [flow-strict] Flow strict StatusBar" 2018-11-23 12:15:28 -08:00
RNTester Flow strict TextInput (#22250) 2018-11-21 14:33:48 -08:00
React Introducing RCTComponentViewFactory 2018-11-25 22:17:30 -08:00
ReactAndroid Redefine hashcode for AttributedString 2018-11-25 17:21:00 -08:00
ReactCommon Redefine hashcode for AttributedString 2018-11-25 17:21:00 -08:00
bots Make PR template consistent with Changelog (#22117) 2018-11-04 11:29:52 -08:00
flow Prettify remaining unprettified files (#21327) 2018-09-25 19:50:08 -07:00
flow-github Use real flow types from metro 2018-11-22 12:27:10 -08:00
gradle/wrapper fix gradle wrapper issue (#19976) 2018-08-08 15:03:01 -07:00
jest Back out "reapply TextInput es6 conversion with fixes, attemps to fix" 2018-11-16 14:50:23 -08:00
keystores Use fb_native_wrapper for all targets 2018-10-31 11:47:42 -07:00
lib Update copyright headers to yearless format 2018-09-11 15:33:07 -07:00
local-cli Fix allocating Buffer in early commit (#22379) 2018-11-22 00:50:03 -08:00
react-native-cli Fix rn-cli linting issues (#22099) 2018-11-04 21:11:58 -08:00
react-native-git-upgrade Update copyright headers to yearless format 2018-09-11 15:33:07 -07:00
scripts Remove unused variables (#22097) 2018-11-04 10:41:46 -08:00
third-party-podspecs RN: Missing Copyright Headers 2018-10-31 01:37:26 -07:00
tools/build_defs RN: Missing Copyright Headers 2018-10-31 01:37:26 -07:00
.buckconfig Use Android SDK 27 in React Native 2018-09-20 07:56:23 -07:00
.buckjavaargs limiting BUCK's memory for CI 2016-02-01 10:49:33 -08:00
.editorconfig editorconfig: Set indent_size for BUCK files to 4 (#21554) 2018-10-08 23:17:38 -07:00
.eslintignore Split out docs to their own repo 2017-12-05 13:02:54 -08:00
.eslintrc Add no-dupe-class-members to RN ESLint fonfig 2018-10-26 12:28:49 -07:00
.flowconfig Use real flow types from metro 2018-11-22 12:27:10 -08:00
.flowconfig.android Use real flow types from metro 2018-11-22 12:27:10 -08:00
.gitattributes Added a .gitattributes file, ensuring that Bash script source files (gradlew and 2015-10-13 23:10:39 -04:00
.gitignore Check Flow and run basic packager tests using open source RN config 2018-08-09 16:17:40 -07:00
.npmignore Update .npmignore to include generated bundle file 2017-02-03 11:43:31 -08:00
.nvmrc Add .nvmrc + fix node version for eslint 5 compat (#20109) 2018-07-31 02:34:16 -07:00
CODE_OF_CONDUCT.md Update repo documentation to match other Facebook projects 2018-09-10 18:02:26 -07:00
CONTRIBUTING.md Update repo documentation to match other Facebook projects 2018-09-10 18:02:26 -07:00
DockerTests.md Fix npm commands in DockerTests.md (#21758) 2018-10-12 14:43:40 -07:00
Jenkinsfile Container Testing Updates 2017-04-12 16:31:35 -07:00
LICENSE Update copyright headers to yearless format 2018-09-11 15:33:07 -07:00
LICENSE-docs More licenses 2015-03-24 19:59:10 -07:00
README.md Update links & Add Code of Conduct (#21296) 2018-09-24 13:53:48 -07:00
React.podspec Upgrade folly to v2018.10.22.00 for iOS (#21976) 2018-10-29 12:13:11 -07:00
Releases.md Fix typo in Releases.md (#20487) 2018-08-01 07:16:56 -07:00
appveyor.yml bump Android NDK to r17c (#21628) 2018-10-11 22:08:37 -07:00
build.gradle gradle repo priority (#22041) 2018-10-31 14:32:38 -07:00
cli.js Update copyright headers to yearless format 2018-09-11 15:33:07 -07:00
gradlew fix gradle wrapper issue (#19976) 2018-08-08 15:03:01 -07:00
gradlew.bat Add missing copyright headers (#21000) 2018-09-07 13:17:38 -07:00
jest-preset.json Fix jest snapshot testing on windows 2018-05-31 12:58:05 -07:00
package.json Bump metro version in React Native 2018-11-22 12:27:10 -08:00
react.gradle Fix incorrect merged asset path with flavor for Android Gradle Plugin 3.2. (#21782) 2018-10-31 05:29:13 -07:00
rn-cli.config.js Update copyright headers to yearless format 2018-09-11 15:33:07 -07:00
rn-get-polyfills.js Remove global babelHelpers and regenerator (#21283) 2018-09-26 10:03:05 -07:00
runXcodeTests.sh Update copyright headers to yearless format 2018-09-11 15:33:07 -07:00
settings.gradle Fix jsc regression.Fixes #22274 (#22293) 2018-11-21 14:36:33 -08:00
setupBabel.js Update copyright headers to yearless format 2018-09-11 15:33:07 -07:00
yarn.lock Bump metro version in React Native 2018-11-22 12:27:10 -08:00

README.md

React Native · Circle CI Status Build status npm version PRs Welcome

Learn once, write anywhere: Build mobile apps with React.

See the official React Native website for an introduction to React Native.


Requirements

Supported target operating systems are >= Android 4.1 (API 16) and >= iOS 9.0. You may use Windows, macOS, or Linux as your development operating system, though building and running iOS apps is limited to macOS by default (tools like Expo can be used to get around this).

Building your first React Native app

Follow the Getting Started guide. The recommended way to install React Native depends on your project. Here you can find short guides for the most common scenarios:

How React Native works

React Native lets you build mobile apps using JavaScript. It uses the same design as React, letting you compose a rich mobile UI from declarative components.

With React Native, you don't build a "mobile web app", an "HTML5 app", or a "hybrid app". You build a real mobile app that's indistinguishable from an app built using Objective-C, Java, Kotlin, or Swift. React Native uses the same fundamental UI building blocks as regular iOS and Android apps. You just put those building blocks together using JavaScript and React.

React Native lets you build your app faster. Instead of recompiling, you can reload your app instantly. With hot reloading, you can even run new code while retaining your application state.

React Native combines smoothly with components written in Objective-C, Java, Kotlin, or Swift. It's simple to drop down to native code if you need to optimize a few aspects of your application. It's also easy to build part of your app in React Native, and part of your app using native code directly - that's how the Facebook app works.

The focus of React Native is on developer efficiency across all the platforms you care about - learn once, write anywhere. Facebook uses React Native in multiple production apps and will continue investing in React Native.

Full documentation

The full documentation for React Native can be found on our website. The source for the React Native documentation and website is hosted on a separate repo, https://github.com/facebook/react-native-website.

The React Native documentation only discusses the components, APIs, and topics specific to React Native (React on iOS and Android). For further documentation on the React API that is shared between React Native and React DOM, refer to the React documentation.

Join the React Native community

See the CONTRIBUTING file for how to help out.

License

React Native is MIT licensed, as found in the LICENSE file.

React Native documentation is Creative Commons licensed, as found in the LICENSE-docs file.