A framework for building native apps with React. http://facebook.github.io/react-native/
Go to file
Martin Konicek 702f999b05 Consume Android artifacts from npm
Summary:
This lets us say goodbye to Maven Central. This will greatly simplify
and speed up the release process as releasing Android artifacts to
Maven Central adds a lot of [complexity](https://github.com/facebook/react-native/blob/master/Releases-publish.md)
and delays the whole release by several hours when we have to wait
for the artifacts to propagate.

This diff assumes there's a local Maven repo at
`node_modules/react-native/android`.

The second part once this lands is to change our `release.sh` script to
output the artifacts under `react-native/android` before publishing to
npm.

This adds 3.7MB to the size of `node_modules` of any app. However,
we just download eagerly what we'd normally download later via Gradle.

**Test plan**

Released RN including a local Maven repo into Sinopia:

    $ cd react-native
    # Updated version in gradle.properties to 0.21.0
    $ ./gradlew ReactAndroid:installArchives
    # Moved everything in .m2/repository/com/facebook/react to react-native/android
    $ ls react-native/android
    com/facebook/react/react-native/0.21.0/react-native-0.21.0.aar
    com/facebook/react/react-native/0.21.0/react-native-0.21.0.pom
    com/facebook/react/react-native/maven-metadata.xml
    ...

    # Set version in package.json to 0.21.0
    $ npm set registry http://localhost:4873/
    $ npm publish

Created and ran an app:

   $ cd /tmp
   $ react-native init AndroidNpm
   $ cd AndroidNpm
   $ react-native run-android

It worked.

Checked that we're using the artifacts from node_modules/react-native/android:

    $ cd android
    $ ./gradlew app:dependencies
    compile - Classpath for compiling the main sources.
    +--- com.android.support:appcompat-v7:23.0.1
    |    \--- com.android.support:support-v4:23.0.1
    |         \--- com.android.support:support-annotations:23.0.1
    \--- com.facebook.react:react-native:+ -> 0.21.0
         +--- com.google.code.findbugs:jsr305:3.0.0
         +--- com.facebook.stetho:stetho-okhttp:1.2.0
    ...

Checked that Android Studio can find the source jars (you can navigate to RN sources in Android Studio). Opened the new project as described in the [docs](https://facebook.github.io/react-native/docs/android-setup.html#editing-your-app-s-java-code-in-android-studio).

public

Reviewed By: bestander

Differential Revision: D2912557

fb-gh-sync-id: 251c180518a3fb9bb8e80963b236e982d65533be
shipit-source-id: 251c180518a3fb9bb8e80963b236e982d65533be
2016-02-09 06:37:34 -08:00
Examples Navigation Back support and examples for Android 2016-02-08 20:03:31 -08:00
IntegrationTests multiGet breaking test and fix 2016-02-05 16:45:46 -08:00
JSCLegacyProfiler Add suport for JSC profiling on iOS 9 2015-11-16 03:38:11 -08:00
Libraries Add observers for local notifications 2016-02-09 05:46:33 -08:00
React Add observers for local notifications 2016-02-09 05:46:33 -08:00
ReactAndroid Make keyboard detection more robust 2016-02-08 11:46:39 -08:00
babel-preset Adding 'transform-symbol-member' transform to preset. 2016-02-08 15:01:36 -08:00
bots Update bots/README.md 2016-01-12 15:11:24 +00:00
docs Add a note about Android Studio to docs, fix formatting 2016-02-08 15:25:32 -08:00
gradle/wrapper Upgrade gradle to 2.9 2015-12-14 06:37:34 -08:00
jestSupport Enable ES7 async functions in jest 2016-01-21 11:19:32 -08:00
local-cli Consume Android artifacts from npm 2016-02-09 06:37:34 -08:00
packager Clean up Bundler 2016-02-08 11:19:31 -08:00
react-native-cli Revert 5da0e135b6 2016-01-09 15:30:14 +00:00
scripts Update release.sh 2016-01-22 18:53:47 +00:00
website document date and timer picker android 2016-02-08 15:41:34 -08:00
.buckconfig limiting BUCK's memory for CI 2016-02-01 10:49:33 -08:00
.buckjavaargs limiting BUCK's memory for CI 2016-02-01 10:49:33 -08:00
.editorconfig Create .editorconfig 2015-10-09 22:34:00 +01:00
.eslintignore [ReactNative] clean lint in all of Libraries/ 2015-05-19 13:47:04 -08:00
.eslintrc RN: Allow `X == null` in ESLint 2016-02-06 00:40:35 -08:00
.flowconfig Support non-image assets in packager 2016-02-03 17:30:39 -08:00
.gitattributes Added a .gitattributes file, ensuring that Bash script source files (gradlew and 2015-10-13 23:10:39 -04:00
.gitignore Add buck build folders to gitignore 2016-01-30 16:02:32 -05:00
.travis.yml Move tests to iOS9.2 2016-01-06 17:12:02 +00:00
CONTRIBUTING.md Add mention of the license comment in CONTRIBUTING.md 2015-12-24 10:27:29 +01:00
LICENSE Update license 2015-03-23 10:48:39 -07:00
LICENSE-CustomComponents Add CustomComponents license 2015-03-26 11:03:30 -07:00
LICENSE-docs More licenses 2015-03-24 19:59:10 -07:00
LICENSE-examples More licenses 2015-03-24 19:59:10 -07:00
PATENTS Update Patent Grant 2015-04-10 12:14:22 -07:00
README.md Make link more specific 2016-01-20 18:07:12 +01:00
React.podspec Set the versions in package.json and React.podspec to 0.0.0-master 2016-01-13 06:15:01 -08:00
Releases-publish.md Update Releases-publish.md 2016-01-18 20:41:11 +00:00
Releases.md Update Releases.md 2016-01-29 17:22:36 +01:00
breaking-changes.md Update breaking-changes.md 2016-01-16 21:56:57 +00:00
build.gradle Upgrade gradle to 2.9 2015-12-14 06:37:34 -08:00
circle.yml limiting BUCK's memory for CI 2016-02-01 10:49:33 -08:00
cli.js Breaking change: Move `bundle` to `private-cli` 2015-10-13 11:48:30 -07:00
gradlew Upgrade gradle to 2.9 2015-12-14 06:37:34 -08:00
gradlew.bat Release React Native for Android 2015-09-14 18:13:39 +01:00
npm-shrinkwrap.json Use "babel-preset-react-native" 2016-02-03 08:15:32 -08:00
package.json Consume Android artifacts from npm 2016-02-09 06:37:34 -08:00
runXcodeTests.sh tweak build script. 2015-03-26 09:17:17 -07:00
settings.gradle Delete SampleApp 2015-09-29 09:21:33 -07:00

README.md

React Native Build Status Circle CI npm version

React Native enables you to build world-class application experiences on native platforms using a consistent developer experience based on JavaScript and React. 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.

Supported operating systems are >= Android 4.1 (API 16) and >= iOS 7.0.

Introduction

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

Getting Started

Getting Help

Please use these community resources for getting help. We use the GitHub issues for tracking bugs and feature requests and have limited bandwidth to address them.

Documentation

The websites documentation is divided into multiple sections.

Another great way to learn more about the components and APIs included with React Native is to read their source. Look under the Libraries directory for components like ScrollView and Navigator, for example. The UIExplorer example is also here to demonstrate some of the ways to use these components. From the source you can get an accurate understanding of each components behavior and API.

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.

Examples

  • git clone https://github.com/facebook/react-native.git
  • cd react-native && npm install

Running the examples on iOS

Now open any example (the .xcodeproj file in each of the Examples subdirectories) and hit Run in Xcode.

Running the examples on Android

Note that you'll need the Android NDK installed, see prerequisites.

./gradlew :Examples:Movies:android:app:installDebug
# Start the packager in a separate shell (make sure you ran npm install):
./packager/packager.sh
# Open the Movies app in your emulator

Extending React Native

  • Looking for a component? JS.coach
  • Fellow developers write and publish React Native modules to npm and open source them on GitHub.
  • Making modules helps grow the React Native ecosystem and community. We recommend writing modules for your use cases and sharing them on npm.
  • Read the guides on Native Modules (iOS, Android) and Native UI Components (iOS, Android) if you are interested in extending native functionality.

Upgrading

React Native is under active development. See the guide on upgrading React Native to keep your project up-to-date.

Opening Issues

If you encounter a bug with React Native we would like to hear about it. Search the existing issues and try to make sure your problem doesnt already exist before opening a new issue. Its helpful if you include the version of React Native and OS youre using. Please include a stack trace and reduced repro case when appropriate, too.

The GitHub issues are intended for bug reports and feature requests. For help and questions with using React Native please make use of the resources listed in the Getting Help section. Product Pains in particular is a good way to signal your interest in a feature or issue. There are limited resources available for handling issues and by keeping the list of open issues lean we can respond in a timely manner.

Contributing

For more information about contributing PRs and issues, see our Contribution Guidelines.

Good First Task is a great starting point for PRs.

We encourage the community to ask and answer questions on Stack Overflow with the react-native tag. It's a great way to help out and be involved!

License

React is BSD licensed. We also provide an additional patent grant.

React documentation is Creative Commons licensed.

Examples provided in this repository and in the documentation are separately licensed, as are some of the custom components.