From 63133832fba3b776b74e6e60ec1024c5c1e67dff Mon Sep 17 00:00:00 2001 From: Martin Konicek Date: Mon, 5 Dec 2016 16:38:07 +0000 Subject: [PATCH] Blogpost about react-native-git-upgrade --- .../2016/03/24/introducing-hot-reloading.html | 2 +- .../07/06/toward-better-documentation.html | 2 +- .../12/react-native-meetup-san-francisco.html | 2 +- ...to-left-support-for-react-native-apps.html | 2 +- .../exponent-talks-unraveling-navigation.html | 4 +- ...headless-js-the-keyboard-api-and-more.html | 2 +- ...cing-button-yarn-and-a-public-roadmap.html | 2 +- blog/2016/12/05/easier-upgrades.html | 55 ++++++++++++++++++ blog/feed.xml | 14 ++++- blog/img/git-upgrade-conflict.png | Bin 0 -> 94088 bytes blog/img/git-upgrade-output.png | Bin 0 -> 338859 bytes blog/index.html | 2 +- 12 files changed, 77 insertions(+), 10 deletions(-) create mode 100644 blog/2016/12/05/easier-upgrades.html create mode 100644 blog/img/git-upgrade-conflict.png create mode 100644 blog/img/git-upgrade-output.png diff --git a/blog/2016/03/24/introducing-hot-reloading.html b/blog/2016/03/24/introducing-hot-reloading.html index 961920c757e..b98322680a1 100644 --- a/blog/2016/03/24/introducing-hot-reloading.html +++ b/blog/2016/03/24/introducing-hot-reloading.html @@ -1,4 +1,4 @@ -Introducing Hot Reloading
React Native Blog
Stay up-to-date with the latest React Native news and events.

Introducing Hot Reloading

React Native's goal is to give you the best possible developer experience. A big part of it is the time it takes between you save a file and be able to see the changes. Our goal is to get this feedback loop to be under 1 second, even as your app grows.

We got close to this ideal via three main features:

  • Use JavaScript as the language doesn't have a long compilation cycle time.
  • Implement a tool called Packager that transforms es6/flow/jsx files into normal JavaScript that the VM can understand. It was designed as a server that keeps intermediate state in memory to enable fast incremental changes and uses multiple cores.
  • Build a feature called Live Reload that reloads the app on save.

At this point, the bottleneck for developers is no longer the time it takes to reload the app but losing the state of your app. A common scenario is to work on a feature that is multiple screens away from the launch screen. Every time you reload, you've got to click on the same path again and again to get back to your feature, making the cycle multiple-seconds long.

Hot Reloading #

The idea behind hot reloading is to keep the app running and to inject new versions of the files that you edited at runtime. This way, you don't lose any of your state which is especially useful if you are tweaking the UI.

A video is worth a thousand words. Check out the difference between Live Reload (current) and Hot Reload (new).

+Introducing Hot Reloading
React Native Blog
Stay up-to-date with the latest React Native news and events.

Introducing Hot Reloading

React Native's goal is to give you the best possible developer experience. A big part of it is the time it takes between you save a file and be able to see the changes. Our goal is to get this feedback loop to be under 1 second, even as your app grows.

We got close to this ideal via three main features:

  • Use JavaScript as the language doesn't have a long compilation cycle time.
  • Implement a tool called Packager that transforms es6/flow/jsx files into normal JavaScript that the VM can understand. It was designed as a server that keeps intermediate state in memory to enable fast incremental changes and uses multiple cores.
  • Build a feature called Live Reload that reloads the app on save.

At this point, the bottleneck for developers is no longer the time it takes to reload the app but losing the state of your app. A common scenario is to work on a feature that is multiple screens away from the launch screen. Every time you reload, you've got to click on the same path again and again to get back to your feature, making the cycle multiple-seconds long.

Hot Reloading #

The idea behind hot reloading is to keep the app running and to inject new versions of the files that you edited at runtime. This way, you don't lose any of your state which is especially useful if you are tweaking the UI.

A video is worth a thousand words. Check out the difference between Live Reload (current) and Hot Reload (new).

If you look closely, you can notice that it is possible to recover from a red box and you can also start importing modules that were not previously there without having to do a full reload.

Word of warning: because JavaScript is a very stateful language, hot reloading cannot be perfectly implemented. In practice, we found out that the current setup is working well for a large amount of usual use cases and a full reload is always available in case something gets messed up.

Hot reloading is available as of 0.22, you can enable it:

  • Open the developer menu
  • Tap on "Enable Hot Reloading"

Implementation in a nutshell #

Now that we've seen why we want it and how to use it, the fun part begins: how it actually works.

Hot Reloading is built on top of a feature Hot Module Replacement, or HMR. It was first introduced by Webpack and we implemented it inside of React Native Packager. HMR makes the Packager watch for file changes and send HMR updates to a thin HMR runtime included on the app.

In a nutshell, the HMR update contains the new code of the JS modules that changed. When the runtime receives them, it replaces the old modules' code with the new one:

The HMR update contains a bit more than just the module's code we want to change because replacing it, it's not enough for the runtime to pick up the changes. The problem is that the module system may have already cached the exports of the module we want to update. For instance, say you have an app composed of these two modules:

// log.js function log(message) { diff --git a/blog/2016/07/06/toward-better-documentation.html b/blog/2016/07/06/toward-better-documentation.html index bdffacea2dc..98cbbba3831 100644 --- a/blog/2016/07/06/toward-better-documentation.html +++ b/blog/2016/07/06/toward-better-documentation.html @@ -1,4 +1,4 @@ -Toward Better Documentation
React Native Blog
Stay up-to-date with the latest React Native news and events.

Toward Better Documentation

Part of having a great developer experience is having great documentation. A lot goes into creating good docs - the ideal documentation is concise, helpful, accurate, complete, and delightful. Recently we've been working hard to make the docs better based on your feedback, and we wanted to share some of the improvements we've made.

Inline Examples #

When you learn a new library, a new programming language, or a new framework, there's a beautiful moment when you first write a bit of code, try it out, see if it works... and it does work. You created something real. We wanted to put that visceral experience right into our docs. Like this:

import React, { Component } from 'react'; +Toward Better Documentation
React Native Blog
Stay up-to-date with the latest React Native news and events.

Toward Better Documentation

Part of having a great developer experience is having great documentation. A lot goes into creating good docs - the ideal documentation is concise, helpful, accurate, complete, and delightful. Recently we've been working hard to make the docs better based on your feedback, and we wanted to share some of the improvements we've made.

Inline Examples #

When you learn a new library, a new programming language, or a new framework, there's a beautiful moment when you first write a bit of code, try it out, see if it works... and it does work. You created something real. We wanted to put that visceral experience right into our docs. Like this:

import React, { Component } from 'react'; import { AppRegistry, Text, View } from 'react-native'; class ScratchPad extends Component { diff --git a/blog/2016/08/12/react-native-meetup-san-francisco.html b/blog/2016/08/12/react-native-meetup-san-francisco.html index 5ef4c924d84..ff75bc82843 100644 --- a/blog/2016/08/12/react-native-meetup-san-francisco.html +++ b/blog/2016/08/12/react-native-meetup-san-francisco.html @@ -1,4 +1,4 @@ -San Francisco Meetup Recap
React Native Blog
Stay up-to-date with the latest React Native news and events.

San Francisco Meetup Recap

Last week I had the opportunity to attend the React Native Meetup at Zynga’s San Francisco office. With around 200 people in attendance, it served as a great place to meet other developers near me that are also interested in React Native.

I was particularly interested in learning more about how React and React Native are used at companies like Zynga, Netflix, and Airbnb. The agenda for the night would be as follows:

  • Rapid Prototyping in React
  • Designing APIs for React Native
  • Bridging the Gap: Using React Native in Existing Codebases

But first, the event started off with a quick introduction and a brief recap of recent news:

If one of these meetups is held near you, I highly recommend attending!

Rapid Prototyping in React at Zynga #

The first round of news was followed by a quick introduction by Zynga, our hosts for the evening. Abhishek Chadha talked about how they use React to quickly prototype new experiences on mobile, demoing a quick prototype of a Draw Something-like app. They use a similar approach as React Native, providing access to native APIs via a bridge. This was demonstrated when Abhishek used the device's camera to snap a photo of the audience and then drew a hat on someone's head.

Designing APIs for React Native at Netflix #

Up next, the first featured talk of the evening. Clarence Leung, Senior Software Engineer at Netflix, presented his talk on Designing APIs for React Native. First he noted the two main types of libraries one may work on: components such as tab bars and date pickers, and libraries that provide access to native services such as the camera roll or in-app payments. There are two ways one may approach when building a library for use in React Native:

  • Provide platform-specific components
  • A cross-platform library with a similar API for both iOS and Android

Each approach has its own considerations, and it’s up to you to determine what works best for your needs.

Approach #1

As an example of platform-specific components, Clarence talked about the DatePickerIOS and DatePickerAndroid from core React Native. On iOS, date pickers are rendered as part of the UI and can be easily embedded in an existing view, while date pickers on Android are presented modally. It makes sense to provide separate components in this case.

Approach #2

Photo pickers, on the other hand, are treated similarly on iOS and Android. There are some slight differences — Android does not group photos into folders like iOS does with Selfies, for example — but those are easily handled using if statements and the Platform component.

Regardless of which approach you settle on, it’s a good idea to minimize the API surface and build app-specific libraries. For example, iOS’s In-App Purchase framework supports one-time, consumable purchases, as well as renewable subscriptions. If your app will only need to support consumable purchases, you may get away with dropping support for subscriptions in your cross-platform library.

There was a brief Q&A session at the end of Clarence’s talk. One of the interesting tid bits that came out of it was that around 80% of the React Native code written for these libraries at Netflix is shared across both iOS and Android.

Bridging the Gap, Using React Native in Existing Codebases #

The final talk of the night was by Leland Richardson from Airbnb. The talk was focused on the use of React Native in existing codebases. I already know how easy it is to write a new app from scratch using React Native, so I was very interested to hear about Airbnb’s experience adopting React Native in their existing native apps.

Leland started off by talking about greenfield apps versus brownfield apps. Greenfield means to start a project without the need to consider any prior work. This is in contrast to brownfield projects where you need to take into account the existing project’s requirements, development processes, and all of the teams various needs.

When you’re working on a greenfield app, the React Native CLI sets up a single repository for both iOS and Android and everything just works. The first challenge against using React Native at Airbnb was the fact that the iOS and Android app each had their own repository. Multi-repo companies have some hurdles to get past before they can adopt React Native.

To get around this, Airbnb first set up a new repo for the React Native codebase. They used their continuous integration servers to mirror the iOS and Android repos into this new repo. After tests are run and the bundle is built, the build artifacts are synced back to the iOS and Android repos. This allows the mobile engineers to work on native code without altering their development enviroment. Mobile engineers don't need to install npm, run the packager, or remember to build the JavaScript bundle. The engineers writing actual React Native code do not have to worry about syncing their code across iOS and Android, as they work on the React Native repository directly.

This does come with some drawbacks, mainly they could not ship atomic updates. Changes that require a combination of native and JavaScript code would require three separate pull requests, all of which had to be carefully landed. In order to avoid conflicts, CI will fail to land changes back to the iOS and Android repos if master has changed since the build started. This would cause long delays during high commit frequency days (such as when new releases are cut).

Airbnb has since moved to a mono repo approach. Fortunately this was already under consideration, and once the iOS and Android teams became comfortable with using React Native they were happy to accelerate the move towards the mono repo.

This has solved most of the issues they had with the split repo approach. Leland did note that this does cause a higher strain on the version control servers, which may be an issue for smaller companies.

The Navigation Problem #

The second half of Leland's talk focused on a topic that is dear to me: the Navigation problem in React Native. He talked about the abundance of navigation libraries in React Native, both first party and third party. NavigationExperimental was mentioned as something that seemed promising, but ended up not being well suited for their use case.

In fact, none of the existing navigation libraries seem to work well for brownfield apps. A brownfield app requires that the navigation state be fully owned by the native app. For example, if a user’s session expires while a React Native view is being presented, the native app should be able to take over and present a login screen as needed.

Airbnb also wanted to avoid replacing native navigation bars with JavaScript versions as part of a transition, as the effect could be jarring. Initially they limited themselves to modally presented views, but this obviously presented a problem when it came to adopting React Native more widely within their apps.

They decided that they needed their own library. The library is called airbnb-navigation. The library has not yet being open sourced as it is strongly tied to Airbnb’s codebase, but it is something they’d like to release by the end of the year.

I won’t go into much detail into the library’s API, but here are some of the key takeaways:

  • One must preregister scenes ahead of time
  • Each scene is displayed within its own RCTRootView. They are presented natively on each platform (e.g. UINavigationControllers are used on iOS).
  • The main ScrollView in a scene should be wrapped in a ScrollScene component. Doing so allows you to take advantage of native behaviors such as tapping on the status bar to scroll to the top on iOS.
  • Transitions between scenes are handled natively, no need to worry about performance.
  • The Android back button is automatically supported.
  • They can take advantage of View Controller based navigation bar styling via a Navigator.Config UI-less component.

There’s also some considerations to keep in mind:

  • The navigation bar is not easily customized in JavaScript, as it is a native component. This is intentional, as using native navigation bars is a hard requirement for this type of library.
  • ScreenProps must be serialized/de-serialized whenever they're sent through the bridge, so care must be taken if sending too much data here.
  • Navigation state is owned by the native app (also a hard requirement for the library), so things like Redux cannot manipulate navigation state.

Leland's talk was also followed by a Q&A session. Overall, Airbnb is satisfied with React Native. They’re interested in using Code Push to fix any issues without going through the App Store, and their engineers love Live Reload, as they don't have to wait for the native app to be rebuilt after every minor change.

Closing Remarks #

The event ended with some additional React Native news:

Meetups provide a good opportunity to meet and learn from other developers in the community. I'm looking forward to attending more React Native meetups in the future. If you make it up to one of these, please look out for me and let me know how we can make React Native work better for you!

React Native Blog
Stay up-to-date with the latest React Native news and events.

San Francisco Meetup Recap

Last week I had the opportunity to attend the React Native Meetup at Zynga’s San Francisco office. With around 200 people in attendance, it served as a great place to meet other developers near me that are also interested in React Native.

I was particularly interested in learning more about how React and React Native are used at companies like Zynga, Netflix, and Airbnb. The agenda for the night would be as follows:

  • Rapid Prototyping in React
  • Designing APIs for React Native
  • Bridging the Gap: Using React Native in Existing Codebases

But first, the event started off with a quick introduction and a brief recap of recent news:

If one of these meetups is held near you, I highly recommend attending!

Rapid Prototyping in React at Zynga #

The first round of news was followed by a quick introduction by Zynga, our hosts for the evening. Abhishek Chadha talked about how they use React to quickly prototype new experiences on mobile, demoing a quick prototype of a Draw Something-like app. They use a similar approach as React Native, providing access to native APIs via a bridge. This was demonstrated when Abhishek used the device's camera to snap a photo of the audience and then drew a hat on someone's head.

Designing APIs for React Native at Netflix #

Up next, the first featured talk of the evening. Clarence Leung, Senior Software Engineer at Netflix, presented his talk on Designing APIs for React Native. First he noted the two main types of libraries one may work on: components such as tab bars and date pickers, and libraries that provide access to native services such as the camera roll or in-app payments. There are two ways one may approach when building a library for use in React Native:

  • Provide platform-specific components
  • A cross-platform library with a similar API for both iOS and Android

Each approach has its own considerations, and it’s up to you to determine what works best for your needs.

Approach #1

As an example of platform-specific components, Clarence talked about the DatePickerIOS and DatePickerAndroid from core React Native. On iOS, date pickers are rendered as part of the UI and can be easily embedded in an existing view, while date pickers on Android are presented modally. It makes sense to provide separate components in this case.

Approach #2

Photo pickers, on the other hand, are treated similarly on iOS and Android. There are some slight differences — Android does not group photos into folders like iOS does with Selfies, for example — but those are easily handled using if statements and the Platform component.

Regardless of which approach you settle on, it’s a good idea to minimize the API surface and build app-specific libraries. For example, iOS’s In-App Purchase framework supports one-time, consumable purchases, as well as renewable subscriptions. If your app will only need to support consumable purchases, you may get away with dropping support for subscriptions in your cross-platform library.

There was a brief Q&A session at the end of Clarence’s talk. One of the interesting tid bits that came out of it was that around 80% of the React Native code written for these libraries at Netflix is shared across both iOS and Android.

Bridging the Gap, Using React Native in Existing Codebases #

The final talk of the night was by Leland Richardson from Airbnb. The talk was focused on the use of React Native in existing codebases. I already know how easy it is to write a new app from scratch using React Native, so I was very interested to hear about Airbnb’s experience adopting React Native in their existing native apps.

Leland started off by talking about greenfield apps versus brownfield apps. Greenfield means to start a project without the need to consider any prior work. This is in contrast to brownfield projects where you need to take into account the existing project’s requirements, development processes, and all of the teams various needs.

When you’re working on a greenfield app, the React Native CLI sets up a single repository for both iOS and Android and everything just works. The first challenge against using React Native at Airbnb was the fact that the iOS and Android app each had their own repository. Multi-repo companies have some hurdles to get past before they can adopt React Native.

To get around this, Airbnb first set up a new repo for the React Native codebase. They used their continuous integration servers to mirror the iOS and Android repos into this new repo. After tests are run and the bundle is built, the build artifacts are synced back to the iOS and Android repos. This allows the mobile engineers to work on native code without altering their development enviroment. Mobile engineers don't need to install npm, run the packager, or remember to build the JavaScript bundle. The engineers writing actual React Native code do not have to worry about syncing their code across iOS and Android, as they work on the React Native repository directly.

This does come with some drawbacks, mainly they could not ship atomic updates. Changes that require a combination of native and JavaScript code would require three separate pull requests, all of which had to be carefully landed. In order to avoid conflicts, CI will fail to land changes back to the iOS and Android repos if master has changed since the build started. This would cause long delays during high commit frequency days (such as when new releases are cut).

Airbnb has since moved to a mono repo approach. Fortunately this was already under consideration, and once the iOS and Android teams became comfortable with using React Native they were happy to accelerate the move towards the mono repo.

This has solved most of the issues they had with the split repo approach. Leland did note that this does cause a higher strain on the version control servers, which may be an issue for smaller companies.

The Navigation Problem #

The second half of Leland's talk focused on a topic that is dear to me: the Navigation problem in React Native. He talked about the abundance of navigation libraries in React Native, both first party and third party. NavigationExperimental was mentioned as something that seemed promising, but ended up not being well suited for their use case.

In fact, none of the existing navigation libraries seem to work well for brownfield apps. A brownfield app requires that the navigation state be fully owned by the native app. For example, if a user’s session expires while a React Native view is being presented, the native app should be able to take over and present a login screen as needed.

Airbnb also wanted to avoid replacing native navigation bars with JavaScript versions as part of a transition, as the effect could be jarring. Initially they limited themselves to modally presented views, but this obviously presented a problem when it came to adopting React Native more widely within their apps.

They decided that they needed their own library. The library is called airbnb-navigation. The library has not yet being open sourced as it is strongly tied to Airbnb’s codebase, but it is something they’d like to release by the end of the year.

I won’t go into much detail into the library’s API, but here are some of the key takeaways:

  • One must preregister scenes ahead of time
  • Each scene is displayed within its own RCTRootView. They are presented natively on each platform (e.g. UINavigationControllers are used on iOS).
  • The main ScrollView in a scene should be wrapped in a ScrollScene component. Doing so allows you to take advantage of native behaviors such as tapping on the status bar to scroll to the top on iOS.
  • Transitions between scenes are handled natively, no need to worry about performance.
  • The Android back button is automatically supported.
  • They can take advantage of View Controller based navigation bar styling via a Navigator.Config UI-less component.

There’s also some considerations to keep in mind:

  • The navigation bar is not easily customized in JavaScript, as it is a native component. This is intentional, as using native navigation bars is a hard requirement for this type of library.
  • ScreenProps must be serialized/de-serialized whenever they're sent through the bridge, so care must be taken if sending too much data here.
  • Navigation state is owned by the native app (also a hard requirement for the library), so things like Redux cannot manipulate navigation state.

Leland's talk was also followed by a Q&A session. Overall, Airbnb is satisfied with React Native. They’re interested in using Code Push to fix any issues without going through the App Store, and their engineers love Live Reload, as they don't have to wait for the native app to be rebuilt after every minor change.

Closing Remarks #

The event ended with some additional React Native news:

Meetups provide a good opportunity to meet and learn from other developers in the community. I'm looking forward to attending more React Native meetups in the future. If you make it up to one of these, please look out for me and let me know how we can make React Native work better for you!

React Native Blog
Stay up-to-date with the latest React Native news and events.

Right-to-Left Layout Support For React Native Apps

After launching an app to the app stores, internationalization is the next step to further your audience reach. Over 20 countries and numerous people around the world use Right-to-Left (RTL) languages. Thus, making your app support RTL for them is necessary.

We're glad to announce that React Native has been improved to support RTL layouts. This is now available in the react-native master branch today, and will be available in the next RC: v0.33.0-rc.

This involved changing css-layout, the core layout engine used by RN, and RN core implementation, as well as specific OSS JS components to support RTL.

To battle test the RTL support in production, the latest version of the Facebook Ads Manager app (the first cross-platform 100% RN app) is now available in Arabic and Hebrew with RTL layouts for both iOS and Android. Here is how it looks like in those RTL languages:

+Right-to-Left Layout Support For React Native Apps

React Native Blog
Stay up-to-date with the latest React Native news and events.

Right-to-Left Layout Support For React Native Apps

After launching an app to the app stores, internationalization is the next step to further your audience reach. Over 20 countries and numerous people around the world use Right-to-Left (RTL) languages. Thus, making your app support RTL for them is necessary.

We're glad to announce that React Native has been improved to support RTL layouts. This is now available in the react-native master branch today, and will be available in the next RC: v0.33.0-rc.

This involved changing css-layout, the core layout engine used by RN, and RN core implementation, as well as specific OSS JS components to support RTL.

To battle test the RTL support in production, the latest version of the Facebook Ads Manager app (the first cross-platform 100% RN app) is now available in Arabic and Hebrew with RTL layouts for both iOS and Android. Here is how it looks like in those RTL languages:

diff --git a/blog/2016/09/08/exponent-talks-unraveling-navigation.html b/blog/2016/09/08/exponent-talks-unraveling-navigation.html index 80ecfdf6f9e..fe25e98305f 100644 --- a/blog/2016/09/08/exponent-talks-unraveling-navigation.html +++ b/blog/2016/09/08/exponent-talks-unraveling-navigation.html @@ -1,4 +1,4 @@ -Exponent Talks: Adam on Unraveling Navigation
React Native Blog
Stay up-to-date with the latest React Native news and events.
React Native Blog
Stay up-to-date with the latest React Native news and events.
\ No newline at end of file diff --git a/blog/2016/10/25/0-36-headless-js-the-keyboard-api-and-more.html b/blog/2016/10/25/0-36-headless-js-the-keyboard-api-and-more.html index 39c44bf53af..96cb6345972 100644 --- a/blog/2016/10/25/0-36-headless-js-the-keyboard-api-and-more.html +++ b/blog/2016/10/25/0-36-headless-js-the-keyboard-api-and-more.html @@ -1,4 +1,4 @@ -0.36: Headless JS, the Keyboard API, & more
React Native Blog
Stay up-to-date with the latest React Native news and events.

0.36: Headless JS, the Keyboard API, & more

Today we are releasing React Native 0.36. Read on to learn more about what's new.

Headless JS #

Headless JS is a way to run tasks in JavaScript while your app is in the background. It can be used, for example, to sync fresh data, handle push notifications, or play music. It is only available on Android, for now.

To get started, define your async task in a dedicated file (e.g. SomeTaskName.js):

module.exports = async (taskData) => { +0.36: Headless JS, the Keyboard API, & more
React Native Blog
Stay up-to-date with the latest React Native news and events.

0.36: Headless JS, the Keyboard API, & more

Today we are releasing React Native 0.36. Read on to learn more about what's new.

Headless JS #

Headless JS is a way to run tasks in JavaScript while your app is in the background. It can be used, for example, to sync fresh data, handle push notifications, or play music. It is only available on Android, for now.

To get started, define your async task in a dedicated file (e.g. SomeTaskName.js):

module.exports = async (taskData) => { // Perform your task here. }

Next, register your task in on AppRegistry:

AppRegistry.registerHeadlessTask('SomeTaskName', () => require('SomeTaskName'));

Using Headless JS does require some native Java code to be written in order to allow you to start up the service when needed. Take a look at our new Headless JS docs to learn more!

The Keyboard API #

Working with the on-screen keyboard is now easier with Keyboard. You can now listen for native keyboard events and react to them. For example, to dismiss the active keyboard, simply call Keyboard.dismiss():

import { Keyboard } from 'react-native' diff --git a/blog/2016/11/08/introducing-button-yarn-and-a-public-roadmap.html b/blog/2016/11/08/introducing-button-yarn-and-a-public-roadmap.html index a41f4d6e05b..a59f7a3336c 100644 --- a/blog/2016/11/08/introducing-button-yarn-and-a-public-roadmap.html +++ b/blog/2016/11/08/introducing-button-yarn-and-a-public-roadmap.html @@ -1,4 +1,4 @@ -Introducing Button, Faster Installs with Yarn, and a Public Roadmap
React Native Blog
Stay up-to-date with the latest React Native news and events.

Introducing Button, Faster Installs with Yarn, and a Public Roadmap

We have heard from many people that there is so much work happening with React Native, it can be tough to keep track of what's going on. To help communicate what work is in progress, we are now publishing a roadmap for React Native. At a high level, this work can be broken down into three priorities:

  • Core Libraries. Adding more functionality to the most useful components and APIs.
  • Stability. Improve the underlying infrastructure to reduce bugs and improve code quality.
  • Developer Experience. Help React Native developers move faster

If you have suggestions for features that you think would be valuable on the roadmap, check out Product Pains, where you can suggest new features and discuss existing proposals.

What's new in React Native #

Version 0.37 of React Native, released today, introduces a new core component to make it really easy to add a touchable Button to any app. We're also introducing support for the new Yarn package manager, which should speed up the whole process of updating your app's dependencies.

Introducing Button #

Today we're introducing a basic <Button /> component that looks great on every platform. This addresses one of the most common pieces of feedback we get: React Native is one of the only mobile development toolkits without a button ready to use out of the box.

Simple Button on Android, iOS

<Button +Introducing Button, Faster Installs with Yarn, and a Public Roadmap
React Native Blog
Stay up-to-date with the latest React Native news and events.

Introducing Button, Faster Installs with Yarn, and a Public Roadmap

We have heard from many people that there is so much work happening with React Native, it can be tough to keep track of what's going on. To help communicate what work is in progress, we are now publishing a roadmap for React Native. At a high level, this work can be broken down into three priorities:

  • Core Libraries. Adding more functionality to the most useful components and APIs.
  • Stability. Improve the underlying infrastructure to reduce bugs and improve code quality.
  • Developer Experience. Help React Native developers move faster

If you have suggestions for features that you think would be valuable on the roadmap, check out Product Pains, where you can suggest new features and discuss existing proposals.

What's new in React Native #

Version 0.37 of React Native, released today, introduces a new core component to make it really easy to add a touchable Button to any app. We're also introducing support for the new Yarn package manager, which should speed up the whole process of updating your app's dependencies.

Introducing Button #

Today we're introducing a basic <Button /> component that looks great on every platform. This addresses one of the most common pieces of feedback we get: React Native is one of the only mobile development toolkits without a button ready to use out of the box.

Simple Button on Android, iOS

<Button onPress={onPressMe} title="Press Me" accessibilityLabel="Learn more about this Simple Button" diff --git a/blog/2016/12/05/easier-upgrades.html b/blog/2016/12/05/easier-upgrades.html new file mode 100644 index 00000000000..96cafc6118d --- /dev/null +++ b/blog/2016/12/05/easier-upgrades.html @@ -0,0 +1,55 @@ +Easier Upgrades Thanks to Git
React Native Blog
Stay up-to-date with the latest React Native news and events.

Easier Upgrades Thanks to Git

Upgrading to new versions of React Native has been difficult. You might have seen something like this before:

None of those options is ideal. By overwriting the file we lose our local changes. By not overwriting we don't get the latest updates.

Today I am proud to introduce a new tool that helps solve this problem. The tool is called react-native-git-upgrade and uses Git behind the scenes to resolve conflicts automatically whenever possible.

Usage #

Requirement: Git has to be available in the PATH. Your project doesn't have to be managed by Git.

Install react-native-git-upgrade globally and run it inside your project directory:

$ npm install -g react-native-git-upgrade +$ cd MyProject +$ react-native-git-upgrade 0.38.0

Note: Do not run 'npm install' to install a new version of react-native. The tool needs to be able to compare the old and new project template to work correctly. Simply run it inside your app folder as shown above, while still on the old version.

Example output:

You can also run react-native-git-upgrade with no arguments to upgrade to the latest version of React Native.

We try to preserve your changes in iOS and Android build files, so you don't need to run react-native link after an upgrade.

We have designed the implementation to be as little intrusive as possible. It is entirely based on a local Git repository created on-the-fly in a temporary directory. It won't interfere with your project repository (no matter what VCS you use: Git, SVN, Mercurial, ... or none). Your sources are restored in case of unexpected errors.

How does it work? #

The key step is generating a Git patch. The patch contains all the changes made in the React Native templates between the version your app is using and the new version.

To obtain this patch, we need to generate an app from the templates embedded in the react-native package inside your node_modules directory (these are the same templates the react-native init commands uses). Then, after the native apps have been generated from the templates in both the current version and the new version, Git is able to produce a patch that is adapted to your project (i.e. containing your app name):

[...] + +diff --git a/ios/MyAwesomeApp/Info.plist b/ios/MyAwesomeApp/Info.plist +index e98ebb0..2fb6a11 100644 +--- a/ios/MyAwesomeApp/Info.plist ++++ b/ios/MyAwesomeApp/Info.plist +@@ -45,7 +45,7 @@ + <dict> + <key>localhost</key> + <dict> +- <key>NSTemporaryExceptionAllowsInsecureHTTPLoads</key> ++ <key>NSExceptionAllowsInsecureHTTPLoads</key> + <true/> + </dict> + </dict> +[...]

All we need now is to apply this patch to your source files. While the old react-native upgrade process would have prompted you for any small difference, Git is able to merge most of the changes automatically using its 3-way merge algorithm and eventually leave us with familiar conflict delimiters:

13B07F951A680F5B00A75B9A /* Release */ = { + isa = XCBuildConfiguration; + buildSettings = { + ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon; +<<<<<<< ours + CODE_SIGN_IDENTITY = "iPhone Developer"; + FRAMEWORK_SEARCH_PATHS = ( + "$(inherited)", + "$(PROJECT_DIR)/HockeySDK.embeddedframework", + "$(PROJECT_DIR)/HockeySDK-iOS/HockeySDK.embeddedframework", + ); +======= + CURRENT_PROJECT_VERSION = 1; +>>>>>>> theirs + HEADER_SEARCH_PATHS = ( + "$(inherited)", + /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/include, + "$(SRCROOT)/../node_modules/react-native/React/**", + "$(SRCROOT)/../node_modules/react-native-code-push/ios/CodePush/**", + );

These conflicts are generally easy to reason about. The delimiter ours stands for "your team" whereas theirs could be seen as "the React Native team".

Why introduce a new global package? #

React Native comes with a global CLI (the react-native-cli package) which delegates commands to the local CLI embedded in the node_modules/react-native/local-cli directory.

As we mentioned above, the process has to be started from your current React Native version. If we had embedded the implementation in the local-cli, you wouldn't be able to enjoy this feature when using old versions of React Native. For example, you wouldn't be able to upgrade from 0.29.2 to 0.38.0 if this new upgrade code was only released in 0.38.0.

Upgrading based on Git is a big improvement in developer experience and it is important to make it available to everyone. By using a separate package react-native-git-upgrade installed globally you can use this new code today no matter what version of React Native your project is using.

One more reason is the recent Yeoman wipeout by Martin Konicek. We didn't want to get these Yeoman dependencies back into the react-native package to be able to evaluate the old template in order to create the patch.

Looking ahead #

The logic behind react-native-git-upgrade described above is going to power the standard react-native upgrade starting with React Native version 0.40.0.

This means that if you are upgrading from version 0.40.0 or higher, you will be able to simply run react-native upgrade in your project without having to install anything globally. The react-native-git-upgrade is provided so anyone can enjoy this improved experience today while using older versions of React Native.

Try it out and provide feedback #

As a conclusion, I would say, enjoy the feature and feel free to suggest improvements, report issues and especially send pull requests. Each environment is a bit different and each React Native project is different, and we need your feedback to make this work well for everyone.

Thank you! #

I would like to thank the awesome companies Zenika and M6 Web without whom none of this would have been possible!

\ No newline at end of file diff --git a/blog/feed.xml b/blog/feed.xml index 8716e43d755..204e968abb3 100644 --- a/blog/feed.xml +++ b/blog/feed.xml @@ -2,12 +2,24 @@ https://facebook.github.io/react-native/blog/ React Native Blog - 2016-11-08T00:00:00Z + 2016-12-05T00:00:00Z The best place to stay up-to-date with the latest React Native news and events. https://facebook.github.io/react-native/img/header_logo.png Copyright © 2016 Facebook Inc. Feed for Node.js + + <![CDATA[Easier Upgrades Thanks to Git]]> + https://facebook.github.io/react-native/blog/2016/12/05/easier-upgrades.html + + + 2016-12-05T00:00:00Z + + + Nicolas Cuillery + https://twitter.com/ncuillery + + <![CDATA[Introducing Button, Faster Installs with Yarn, and a Public Roadmap]]> https://facebook.github.io/react-native/blog/2016/11/08/introducing-button-yarn-and-a-public-roadmap.html diff --git a/blog/img/git-upgrade-conflict.png b/blog/img/git-upgrade-conflict.png new file mode 100644 index 0000000000000000000000000000000000000000..ac8a0447310e9f36e333231e8e37a3df1caae790 GIT binary patch literal 94088 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