tl; dr: We’re engaged on enhancing the sources supporting the React Native New Structure. We’ve got already launched a repository to assist migrate your app (RNNewArchitectureApp) and one to your libraries (RNNewArchitectureLibraries). We’re additionally revamping the New Structure information on the Web site and we created a GitHub Working Group to reply questions associated to the New Structure.
Introduction
On this submit we’re sharing an replace on instruments and sources that can assist you migrate your Native Modules and Native Elements to their New Structure equivalents, TurboModule and Material Elements.
React Native customers leverage huge variety of open supply libraries for constructing apps. For a whole and constant ecosystem, it’s essential that these libraries migrate such that everybody can profit from the unlocked capabilities and efficiency enhancements of the New Structure.
Here’s what we’re engaged on to assist library builders in migrating to the New Structure:
- Documentation: We’re increasing the New Structure information on the web site to cowl extra ideas of the New Structure and the way to develop your elements.
- Instance Migrations: We’ve arrange two repositories to reveal the way to migrate a React Native app to the New Structure (RNNewArchitectureApp) and the way to create a Material Element and a TurboModule that work with each architectures (RNNewArchitectureLibraries).
- Help: Earlier this 12 months, we created a GitHub Working Group devoted to dialogue and questions across the New Structure.
On this submit, we are going to dig deeper into these sources and clarify in additional element how you need to use them most effectively. Lastly, we are going to present a snapshot of the present migration state for probably the most used React Native libraries.
Documentation
Prior to now 6 months, we’ve added a information on adopting the New Structure and an structure deep-dive on Material. We plan to increase this to incorporate extra guides and documentation round creating TurboModules, understanding CodeGen, and extra. We plan to have updates to share by the 0.70 launch.
At the moment, the New Structure information covers the way to migrate your app and your libraries to assist the New Structure correctly.
In case you are within the evolution of this information, or have suggestions, you possibly can observe alongside on this pull request.
Instance Migrations
For builders who might need to observe alongside in code, we’ve ready two instance repositories.
RNNewArchitectureApp
This repo was created to reveal the way to migrate an app, the native modules and the native elements from the legacy structure on the React Native model 0.67 to the New Structure and the latest model of React Native. Every commit corresponds to an remoted migration step.
The repo is organized as follows:
- A major department has no code however a README.md which advertises different branches.
- A number of migration branches which present a migration from a selected model of RN to a different.
Among the migration branches even have a RUN.md file which describes in a extra human-readable style the precise steps which have been utilized in each commit.
We plan to maintain this instance updated with the latest steady releases, including migrations to any minor launch of React Native we’re going to launch. If you happen to discover concern with any of the steps, please file a difficulty within the repository. This may maintain till we now have the affordable feeling that a lot of the React Native customers have migrated to the New Structure.
RNNewArchitectureLibraries
Equally, this repo supplies a step-by-step information on the way to create a TurboModule and a Material Element. It has a deal with making certain backward compatibility between the New Structure and the legacy one.
The repository is organized in an analogous solution to the earlier one:
- A major department has no code however a README.md which advertises different branches.
- Different branches to indicate the way to develop TurboModules and Material Elements.
We plan to maintain this instance up to date onto new releases of React Native, particularly releases that have an effect on library improvement, in addition to add extra examples on the way to use superior options (for instance: implementing instructions, occasion emitters, customized state). If you happen to discover errors, please file a difficulty within the instance repository.
Help
We’ve created a devoted working group to present the group house to ask questions and get updates on the New Structure. In case you are a library maintainer, it is a beneficial useful resource to seek out solutions to your questions, and for us to learn about your necessities. To hitch, please observe these directions. Everyone seems to be welcome.
The working group is organized into a number of sections:
- Bulletins: A spot to share milestones and vital updates on the RN New Structure Rollout
- Deep Dive: A spot to speak about deep dives and technical-specific subjects
- Documentation: A spot to speak in regards to the New Structure documentation and migration materials
- Libraries: A spot to speak about third occasion libraries and their migration story to the New Structure
- Q&A: A spot to ask the group for assistance on the New Structure subjects
- Releases: A spot to speak about launch particular bugs & construct issues
To make use of this group successfully:
- Make sure that your library is listed contained in the Libraries part. This may assist us share a standing replace on the migration of your library and can assist us perceive which struggles library authors are dealing with to assist you higher.
- Leverage the Q&A part in the event you face a blocker and want assist. Our crew and group specialists are monitoring and can assist at our greatest effort.
- Keep watch over the opposite sections for subjects that will have an effect on you. A brand new launch might introduce precisely the API that you just had been in search of. You possibly can subscribe to explicit discussions through GitHub.
We plan to assist this group till the New Structure is enabled by default and all the most important libraries have been migrated to it.
Migration Standing of Fashionable Libraries
Libraries maintainers have been sharing with us within the working group the standing of their migration effort, and we wished to give you a fast overview:
Subsequent Steps
We’re invested in supporting the React Native group’s adoption of the New Structure. Concretely, we are going to proceed to:
- Supply best-effort assist within the Working Group.
- Present extra examples about the way to obtain wonderful outcomes with the New Structure within the RNNewArchitecture repositories.
- Present clear and up-to-date documentation on the New Structure.
- Observe the migration standing of important React Native libraries within the Working Group.
- Simplify the migration path for builders
As well as, React Native 0.69 will ship with improved devX for app and library builders for New Structure adoption. Yow will discover extra details about the 0.69.0 launch right here.
We’re enthusiastic about what we are going to construct along with the New Structure!
