this repo has no description
at main 67 kB view raw
1<!doctype html><html lang=en dir=ltr class="docs-wrapper plugin-docs plugin-id-default docs-version-0.79 docs-doc-page docs-doc-id-the-new-architecture/using-codegen" data-has-hydrated=false><meta charset=UTF-8><meta name=generator content="Docusaurus v3.8.0"><title data-rh=true>Using Codegen · React Native</title><meta data-rh=true name=viewport content="width=device-width, initial-scale=1.0"><meta data-rh=true property=og:url content=https://reactnative.dev/docs/the-new-architecture/using-codegen><meta data-rh=true property=og:locale content=en><meta data-rh=true name=docusaurus_locale content=en><meta data-rh=true name=docsearch:language content=en><meta data-rh=true property=og:image content=https://reactnative.dev/img/logo-share.png><meta data-rh=true name=twitter:card content=summary_large_image><meta data-rh=true name=twitter:image content=https://reactnative.dev/img/logo-share.png><meta data-rh=true name=twitter:site content=@reactnative><meta data-rh=true name=docusaurus_version content=0.79><meta data-rh=true name=docusaurus_tag content=docs-default-0.79><meta data-rh=true name=docsearch:version content=0.79><meta data-rh=true name=docsearch:docusaurus_tag content=docs-default-0.79><meta data-rh=true property=og:title content="Using Codegen · React Native"><meta data-rh=true name=description content="This guide teaches how to:"><meta data-rh=true property=og:description content="This guide teaches how to:"><link data-rh=true rel=icon href=/img/favicon.ico><link data-rh=true rel=canonical href=https://reactnative.dev/docs/the-new-architecture/using-codegen><link data-rh=true rel=alternate href=https://reactnative.dev/docs/the-new-architecture/using-codegen hreflang=en><link data-rh=true rel=alternate href=https://reactnative.dev/docs/the-new-architecture/using-codegen hreflang=x-default><link data-rh=true rel=preconnect href=https://8TDSE0OHGQ-dsn.algolia.net crossorigin=anonymous><link rel=alternate type=application/rss+xml href=/blog/rss.xml title="React Native RSS Feed"><link rel=alternate type=application/atom+xml href=/blog/atom.xml title="React Native Atom Feed"><link rel=alternate type=application/json href=/blog/feed.json title="React Native JSON Feed"><link rel=preconnect href=https://www.google-analytics.com><script>window.ga=window.ga||function(){(ga.q=ga.q||[]).push(arguments)},ga.l=+new Date,ga("create","UA-41298772-2","auto"),ga("send","pageview")</script><script async src=https://www.google-analytics.com/analytics.js></script><link rel=preconnect href=https://www.google-analytics.com><link rel=preconnect href=https://www.googletagmanager.com><script async src="https://www.googletagmanager.com/gtag/js?id=G-58L13S6BDP"></script><script>function gtag(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],gtag("js",new Date),gtag("config","G-58L13S6BDP",{})</script><link rel=search type=application/opensearchdescription+xml title="React Native" href=/opensearch.xml><link rel=icon href=/img/pwa/manifest-icon-512.png><link rel=manifest href=/manifest.json><meta name=theme-color content=#20232a><meta name=apple-mobile-web-app-capable content=yes><meta name=apple-mobile-web-app-status-bar-style content=#20232a><link rel=apple-touch-icon href=/img/pwa/manifest-icon-512.png><link rel=mask-icon href=/img/pwa/manifest-icon-512.png color=#06bcee><meta name=msapplication-TileImage href=/img/pwa/manifest-icon-512.png><meta name=msapplication-TileColor content=#20232a><script src=https://cdn.jsdelivr.net/npm/focus-visible@5.2.0/dist/focus-visible.min.js defer></script><script src=https://widget.surveymonkey.com/collect/website/js/tRaiETqnLgj758hTBazgd8ryO5qrZo8Exadq9qmt1wtm4_2FdZGEAKHDFEt_2BBlwwM4.js defer></script><script src=https://snack.expo.dev/embed.js defer></script><script src=https://platform.twitter.com/widgets.js async></script><link rel=stylesheet href=/assets/css/styles.883cb042.css><script src=/assets/js/runtime~main.8ac1e6f0.js defer></script><script src=/assets/js/main.341783f5.js defer></script><body class=navigation-with-keyboard><svg xmlns=http://www.w3.org/2000/svg style="display: none;"><defs> 2<symbol id=theme-svg-external-link viewBox="0 0 24 24"><path fill=currentColor d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"/></symbol> 3</defs></svg> 4<script>!function(){var t=function(){try{return new URLSearchParams(window.location.search).get("docusaurus-theme")}catch(t){}}()||function(){try{return window.localStorage.getItem("theme")}catch(t){}}();document.documentElement.setAttribute("data-theme",t||(window.matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light")),document.documentElement.setAttribute("data-theme-choice",t||"system")}(),function(){try{for(var[t,e]of new URLSearchParams(window.location.search).entries())if(t.startsWith("docusaurus-data-")){var a=t.replace("docusaurus-data-","data-");document.documentElement.setAttribute(a,e)}}catch(t){}}(),document.documentElement.setAttribute("data-announcement-bar-initially-dismissed",function(){try{return"true"===localStorage.getItem("docusaurus.announcement.dismiss")}catch(t){}return!1}())</script><div id=__docusaurus><div role=region aria-label="Skip to main content"><a class=skipToContent_oPtH href=#__docusaurus_skipToContent_fallback>Skip to main content</a></div><div class="theme-announcement-bar announcementBar_zJRd" style=background-color:#20232a;color:#fff role=banner><div class="content_bSb_ announcementBarContent_t7IR">Join us for React Conf on Oct 7-8. <a target=_blank rel="noopener noreferrer" href=https://conf.react.dev>Learn more</a>.</div></div><nav aria-label=Main class="theme-layout-navbar navbar navbar--fixed-top navbar--dark"><div class=navbar__inner><div class="theme-layout-navbar-left navbar__items"><button aria-label="Toggle navigation bar" aria-expanded=false class="navbar__toggle clean-btn" type=button><svg width=30 height=30 viewBox="0 0 30 30" aria-hidden=true><path stroke=currentColor stroke-linecap=round stroke-miterlimit=10 stroke-width=2 d="M4 7h22M4 15h22M4 23h22"/></svg></button><a class=navbar__brand href=/><div class=navbar__logo><img src=/img/header_logo.svg alt="React Native" class="themedComponent_siVc themedComponent--light_hHel"><img src=/img/header_logo.svg alt="React Native" class="themedComponent_siVc themedComponent--dark_yETr"></div><b class="navbar__title text--truncate">React Native</b></a><div class="navbar__item dropdown dropdown--hoverable"><a class=navbar__link aria-haspopup=true aria-expanded=false role=button href=/docs/the-new-architecture/using-codegen>0.79</a><ul class=dropdown__menu><li><a class=dropdown__link href=/docs/next/the-new-architecture/using-codegen>Next</a><li><a aria-current=page class="dropdown__link dropdown__link--active" href=/docs/the-new-architecture/using-codegen>0.79</a><li><a class=dropdown__link href=/docs/0.78/the-new-architecture/using-codegen>0.78</a><li><a class=dropdown__link href=/docs/0.77/the-new-architecture/using-codegen>0.77</a><li><a class=dropdown__link href=/docs/0.76/the-new-architecture/using-codegen>0.76</a><li><a class=dropdown__link href=/docs/0.75/getting-started>0.75</a><li><a class=dropdown__link href=/docs/0.74/getting-started>0.74</a><li><a class=dropdown__link href=/docs/0.73/getting-started>0.73</a><li><a class=dropdown__link href=/docs/0.72/getting-started>0.72</a><li><a class=dropdown__link href=/docs/0.71/getting-started>0.71</a><li><a class=dropdown__link href=/docs/0.70/getting-started>0.70</a><li><a class=dropdown__link href=/versions>All versions</a></ul></div></div><div class="theme-layout-navbar-right navbar__items navbar__items--right"><div class="navbar__item dropdown dropdown--hoverable dropdown--right"><a href=# aria-haspopup=true aria-expanded=false role=button class=navbar__link>Development</a><ul class=dropdown__menu><li><a aria-current=page class="dropdown__link dropdown__link--active" href=/docs/getting-started>Guides</a><li><a class=dropdown__link href=/docs/components-and-apis>Components</a><li><a class=dropdown__link href=/docs/accessibilityinfo>APIs</a><li><a class=dropdown__link href=/architecture/overview>Architecture</a></ul></div><a class="navbar__item navbar__link" href=/contributing/overview>Contributing</a><a class="navbar__item navbar__link" href=/community/overview>Community</a><a class="navbar__item navbar__link" href=/showcase>Showcase</a><a class="navbar__item navbar__link" href=/blog>Blog</a><a href=https://github.com/facebook/react-native target=_blank rel="noopener noreferrer" class="navbar__item navbar__link navbar-github-link" aria-label="GitHub repository"></a><div class="toggle_ki11 colorModeToggle_Hewu"><button class="clean-btn toggleButton_MMFG toggleButtonDisabled_Uw7m darkNavbarColorModeToggle_m8pZ" type=button disabled title="system mode" aria-label="Switch between dark and light mode (currently system mode)"><svg viewBox="0 0 24 24" width=24 height=24 aria-hidden=true class="toggleIcon_k9hJ lightToggleIcon_lgto"><path fill=currentColor d="M12,9c1.65,0,3,1.35,3,3s-1.35,3-3,3s-3-1.35-3-3S10.35,9,12,9 M12,7c-2.76,0-5,2.24-5,5s2.24,5,5,5s5-2.24,5-5 S14.76,7,12,7L12,7z M2,13l2,0c0.55,0,1-0.45,1-1s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S1.45,13,2,13z M20,13l2,0c0.55,0,1-0.45,1-1 s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S19.45,13,20,13z M11,2v2c0,0.55,0.45,1,1,1s1-0.45,1-1V2c0-0.55-0.45-1-1-1S11,1.45,11,2z M11,20v2c0,0.55,0.45,1,1,1s1-0.45,1-1v-2c0-0.55-0.45-1-1-1C11.45,19,11,19.45,11,20z M5.99,4.58c-0.39-0.39-1.03-0.39-1.41,0 c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0s0.39-1.03,0-1.41L5.99,4.58z M18.36,16.95 c-0.39-0.39-1.03-0.39-1.41,0c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0c0.39-0.39,0.39-1.03,0-1.41 L18.36,16.95z M19.42,5.99c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06c-0.39,0.39-0.39,1.03,0,1.41 s1.03,0.39,1.41,0L19.42,5.99z M7.05,18.36c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06 c-0.39,0.39-0.39,1.03,0,1.41s1.03,0.39,1.41,0L7.05,18.36z"/></svg><svg viewBox="0 0 24 24" width=24 height=24 aria-hidden=true class="toggleIcon_k9hJ darkToggleIcon_U96C"><path fill=currentColor d="M9.37,5.51C9.19,6.15,9.1,6.82,9.1,7.5c0,4.08,3.32,7.4,7.4,7.4c0.68,0,1.35-0.09,1.99-0.27C17.45,17.19,14.93,19,12,19 c-3.86,0-7-3.14-7-7C5,9.07,6.81,6.55,9.37,5.51z M12,3c-4.97,0-9,4.03-9,9s4.03,9,9,9s9-4.03,9-9c0-0.46-0.04-0.92-0.1-1.36 c-0.98,1.37-2.58,2.26-4.4,2.26c-2.98,0-5.4-2.42-5.4-5.4c0-1.81,0.89-3.42,2.26-4.4C12.92,3.04,12.46,3,12,3L12,3z"/></svg><svg viewBox="0 0 24 24" width=24 height=24 aria-hidden=true class="toggleIcon_k9hJ systemToggleIcon_E5c0"><path fill=currentColor d="m12 21c4.971 0 9-4.029 9-9s-4.029-9-9-9-9 4.029-9 9 4.029 9 9 9zm4.95-13.95c1.313 1.313 2.05 3.093 2.05 4.95s-0.738 3.637-2.05 4.95c-1.313 1.313-3.093 2.05-4.95 2.05v-14c1.857 0 3.637 0.737 4.95 2.05z"/></svg></button></div><div class=navbarSearchContainer_bzqh><button type=button class="DocSearch DocSearch-Button" aria-label="Search (Command+K)"><span class=DocSearch-Button-Container><svg width=20 height=20 class=DocSearch-Search-Icon viewBox="0 0 20 20" aria-hidden=true><path d="M14.386 14.386l4.0877 4.0877-4.0877-4.0877c-2.9418 2.9419-7.7115 2.9419-10.6533 0-2.9419-2.9418-2.9419-7.7115 0-10.6533 2.9418-2.9419 7.7115-2.9419 10.6533 0 2.9419 2.9418 2.9419 7.7115 0 10.6533z" stroke=currentColor fill=none fill-rule=evenodd stroke-linecap=round stroke-linejoin=round /></svg><span class=DocSearch-Button-Placeholder>Search</span></span><span class=DocSearch-Button-Keys></span></button></div></div></div><div role=presentation class=navbar-sidebar__backdrop></div></nav><div id=__docusaurus_skipToContent_fallback class="theme-layout-main main-wrapper mainWrapper_MB5r"><div class=docsWrapper__sE8><button aria-label="Scroll back to top" class="clean-btn theme-back-to-top-button backToTopButton_iEvu" type=button></button><div class=docRoot_DfVB><aside class="theme-doc-sidebar-container docSidebarContainer_c7NB"><div class=sidebarViewport_KYo0><div class=sidebar_CUen><nav aria-label="Docs sidebar" class="menu thin-scrollbar menu_jmj1 menuWithAnnouncementBar_YufC"><ul class="theme-doc-sidebar-menu menu__list"><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class=menu__list-item-collapsible><a class="menu__link menu__link--sublist menu__link--sublist-caret" role=button aria-expanded=false href=/docs/getting-started>The Basics</a></div><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class=menu__list-item-collapsible><a class="menu__link menu__link--sublist menu__link--sublist-caret" role=button aria-expanded=false href=/docs/environment-setup>Environment setup</a></div><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class=menu__list-item-collapsible><a class="menu__link menu__link--sublist menu__link--sublist-caret" role=button aria-expanded=false href=/docs/running-on-device>Workflow</a></div><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class=menu__list-item-collapsible><a class="menu__link menu__link--sublist menu__link--sublist-caret" role=button aria-expanded=false href=/docs/style>UI & Interaction</a></div><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class=menu__list-item-collapsible><a class="menu__link menu__link--sublist menu__link--sublist-caret" role=button aria-expanded=false href=/docs/debugging>Debugging</a></div><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class=menu__list-item-collapsible><a class="menu__link menu__link--sublist menu__link--sublist-caret" role=button aria-expanded=false href=/docs/testing-overview>Testing</a></div><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class=menu__list-item-collapsible><a class="menu__link menu__link--sublist menu__link--sublist-caret" role=button aria-expanded=false href=/docs/performance>Performance</a></div><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class=menu__list-item-collapsible><a class="menu__link menu__link--sublist menu__link--sublist-caret" role=button aria-expanded=false href=/docs/javascript-environment>JavaScript Runtime</a></div><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item"><div class=menu__list-item-collapsible><a class="menu__link menu__link--sublist menu__link--sublist-caret menu__link--active" role=button aria-expanded=true href=/docs/the-new-architecture/what-is-codegen>Codegen</a></div><ul class=menu__list><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/docs/the-new-architecture/what-is-codegen>What is Codegen?</a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link menu__link--active" aria-current=page tabindex=0 href=/docs/the-new-architecture/using-codegen>Using Codegen</a><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class=menu__link tabindex=0 href=/docs/the-new-architecture/codegen-cli>The Codegen CLI</a></ul><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class=menu__list-item-collapsible><a class="menu__link menu__link--sublist menu__link--sublist-caret" role=button aria-expanded=false href=/docs/native-platform>Native Development</a></div><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class=menu__list-item-collapsible><a class="menu__link menu__link--sublist menu__link--sublist-caret" role=button aria-expanded=false href=/docs/headless-js-android>Android and iOS guides</a></div><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class=menu__list-item-collapsible><a class="menu__link menu__link--sublist menu__link--sublist-caret" role=button aria-expanded=false href=/docs/legacy/native-modules-intro>Legacy Architecture</a></div></ul></nav></div></div></aside><main class=docMainContainer_a9sJ><div class="container padding-top--md padding-bottom--lg"><div class=row><div class="col docItemCol_Qr34"><div class=docItemContainer_tjFy><article><div class="tocCollapsible_wXna theme-doc-toc-mobile tocMobile_Ojys"><button type=button class="clean-btn tocCollapsibleButton_iI2p">On this page</button></div><div class="theme-doc-markdown markdown"><header><h1>Using Codegen</h1></header> 5<p>This guide teaches how to:</p> 6<ul> 7<li>Configure <strong>Codegen</strong>.</li> 8<li>Invoke it manually for each platform.</li> 9</ul> 10<p>It also describes the generated code.</p> 11<h2 class="anchor anchorWithStickyNavbar_JmGV" id=prerequisites>Prerequisites<a href=#prerequisites class=hash-link aria-label="Direct link to Prerequisites" title="Direct link to Prerequisites"></a></h2> 12<p>You always need a React Native app to generate the code properly, even when invoking the <strong>Codegen</strong> manually.</p> 13<p>The <strong>Codegen</strong> process is tightly coupled with the build of the app, and the scripts are located in the <code>react-native</code> NPM package.</p> 14<p>For the sake of this guide, create a project using the React Native CLI as follows:</p> 15<div class="language-bash codeBlockContainer_mQmQ theme-code-block" style=--prism-color:#FFFFFF;--prism-background-color:#282C34><div class=codeBlockTitle_kY6l>bash</div><div class=codeBlockContent_t_Hd><pre tabindex=0 class="prism-code language-bash codeBlock_RMoD thin-scrollbar" style=color:#FFFFFF;background-color:#282C34><code class=codeBlockLines_AclH><span class=token-line style=color:#FFFFFF><span class="token plain">npx @react-native-community/cli@latest init SampleApp </span><span class="token parameter variable" style=color:#cb4b16>--version</span><span class="token plain"> </span><span class="token number" style=color:#5a9bcf>0.76</span><span class="token plain">.0</span><br></span></code></pre></div></div> 16<p><strong>Codegen</strong> is used to generate the glue-code for your custom modules or components. See the guides for Turbo Native Modules and Fabric Native Components for more details on how to create them.</p> 17<h2 class="anchor anchorWithStickyNavbar_JmGV" id=configuring-codegen>Configuring <strong>Codegen</strong><a href=#configuring-codegen class=hash-link aria-label="Direct link to configuring-codegen" title="Direct link to configuring-codegen"></a></h2> 18<p><strong>Codegen</strong> can be configured in your app by modifying the <code>package.json</code> file. <strong>Codegen</strong> is controlled by a custom field called <code>codegenConfig</code>.</p> 19<div class="language-json codeBlockContainer_mQmQ theme-code-block" style=--prism-color:#FFFFFF;--prism-background-color:#282C34><div class=codeBlockTitle_kY6l>package.json</div><div class=codeBlockContent_t_Hd><pre tabindex=0 class="prism-code language-json codeBlock_RMoD thin-scrollbar" style=color:#FFFFFF;background-color:#282C34><code class=codeBlockLines_AclH><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token property" style=color:#2aa198>"codegenConfig"</span><span class="token operator" style=color:#fc929e>:</span><span class="token plain"> </span><span class="token punctuation" style=color:#657b83>{</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token property" style=color:#2aa198>"name"</span><span class="token operator" style=color:#fc929e>:</span><span class="token plain"> </span><span class="token string" style=color:#8dc891>"&lt;SpecName>"</span><span class="token punctuation" style=color:#657b83>,</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token property" style=color:#2aa198>"type"</span><span class="token operator" style=color:#fc929e>:</span><span class="token plain"> </span><span class="token string" style=color:#8dc891>"&lt;types>"</span><span class="token punctuation" style=color:#657b83>,</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token property" style=color:#2aa198>"jsSrcsDir"</span><span class="token operator" style=color:#fc929e>:</span><span class="token plain"> </span><span class="token string" style=color:#8dc891>"&lt;source_dir>"</span><span class="token punctuation" style=color:#657b83>,</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token property" style=color:#2aa198>"android"</span><span class="token operator" style=color:#fc929e>:</span><span class="token plain"> </span><span class="token punctuation" style=color:#657b83>{</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token property" style=color:#2aa198>"javaPackageName"</span><span class="token operator" style=color:#fc929e>:</span><span class="token plain"> </span><span class="token string" style=color:#8dc891>"&lt;java.package.name>"</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token punctuation" style=color:#657b83>}</span><span class="token punctuation" style=color:#657b83>,</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token property" style=color:#2aa198>"ios"</span><span class="token operator" style=color:#fc929e>:</span><span class="token plain"> </span><span class="token punctuation" style=color:#657b83>{</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token property" style=color:#2aa198>"modulesConformingToProtocol"</span><span class="token operator" style=color:#fc929e>:</span><span class="token plain"> </span><span class="token punctuation" style=color:#657b83>{</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token property" style=color:#2aa198>"RCTImageURLLoader"</span><span class="token operator" style=color:#fc929e>:</span><span class="token plain"> </span><span class="token punctuation" style=color:#657b83>[</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token string" style=color:#8dc891>"&lt;iOS-class-conforming-to-RCTImageURLLoader>"</span><span class="token punctuation" style=color:#657b83>,</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token comment" style=color:#93a1a1>// example from react-native-camera-roll: https://github.com/react-native-cameraroll/react-native-cameraroll/blob/8a6d1b4279c76e5682a4b443e7a4e111e774ec0a/package.json#L118-L127</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token comment" style=color:#93a1a1>// "RNCPHAssetLoader",</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token punctuation" style=color:#657b83>]</span><span class="token punctuation" style=color:#657b83>,</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token property" style=color:#2aa198>"RCTURLRequestHandler"</span><span class="token operator" style=color:#fc929e>:</span><span class="token plain"> </span><span class="token punctuation" style=color:#657b83>[</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token string" style=color:#8dc891>"&lt;iOS-class-conforming-to-RCTURLRequestHandler>"</span><span class="token punctuation" style=color:#657b83>,</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token comment" style=color:#93a1a1>// example from react-native-camera-roll: https://github.com/react-native-cameraroll/react-native-cameraroll/blob/8a6d1b4279c76e5682a4b443e7a4e111e774ec0a/package.json#L118-L127</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token comment" style=color:#93a1a1>// "RNCPHAssetUploader",</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token punctuation" style=color:#657b83>]</span><span class="token punctuation" style=color:#657b83>,</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token property" style=color:#2aa198>"RCTImageDataDecoder"</span><span class="token operator" style=color:#fc929e>:</span><span class="token plain"> </span><span class="token punctuation" style=color:#657b83>[</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token string" style=color:#8dc891>"&lt;iOS-class-conforming-to-RCTImageDataDecoder>"</span><span class="token punctuation" style=color:#657b83>,</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token comment" style=color:#93a1a1>// we don't have a good example for this, but it works in the same way. Pass the name of the class that implements the RCTImageDataDecoder. It must be a Native Module.</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token punctuation" style=color:#657b83>]</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token punctuation" style=color:#657b83>}</span><span class="token punctuation" style=color:#657b83>,</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token property" style=color:#2aa198>"componentProvider"</span><span class="token operator" style=color:#fc929e>:</span><span class="token plain"> </span><span class="token punctuation" style=color:#657b83>{</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token property" style=color:#2aa198>"&lt;componentName>"</span><span class="token operator" style=color:#fc929e>:</span><span class="token plain"> </span><span class="token string" style=color:#8dc891>"&lt;iOS-class-implementing-the-component>"</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token punctuation" style=color:#657b83>}</span><span class="token punctuation" style=color:#657b83>,</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token property" style=color:#2aa198>"modulesProvider"</span><span class="token operator" style=color:#fc929e>:</span><span class="token plain"> </span><span class="token punctuation" style=color:#657b83>{</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token property" style=color:#2aa198>"&lt;moduleName>"</span><span class="token operator" style=color:#fc929e>:</span><span class="token plain"> </span><span class="token string" style=color:#8dc891>"&lt;iOS-class-implementing-the-RCTModuleProvider-protocol>"</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token punctuation" style=color:#657b83>}</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token punctuation" style=color:#657b83>}</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token punctuation" style=color:#657b83>}</span><span class="token punctuation" style=color:#657b83>,</span><br></span></code></pre></div></div> 20<p>You can add this snippet to your app and customize the various fields:</p> 21<ul> 22<li><code>name:</code> This is the name that will be used to create files containing your specs. As a convention, It should have the suffix <code>Spec</code>, but this is not mandatory.</li> 23<li><code>type</code>: the type of code we need to generate. Allowed values are <code>modules</code>, <code>components</code>, <code>all</code>.<!-- --> 24<ul> 25<li><code>modules:</code> use this value if you only need to generate code for Turbo Native Modules.</li> 26<li><code>components:</code> use this value if you only need to generate code for Native Fabric Components.</li> 27<li><code>all</code>: use this value if you have a mixture of components and modules.</li> 28</ul> 29</li> 30<li><code>jsSrcsDir</code>: this is the root folder where all your specs live.</li> 31<li><code>android.javaPackageName</code>: this is an Android specific setting to let <strong>Codegen</strong> generate the files in a custom package.</li> 32<li><code>ios</code>: the <code>ios</code> field is an object that can be used by app developers and library maintainers to provide some advanced functionalities. All the following fields are <strong>optional</strong>.<!-- --> 33<ul> 34<li><code>ios.modulesConformingToProtocol</code>: React Native offers some protocols that native modules can implement to customize some behaviors. These fields allow you to define the list of module that conforms to those protocols. These modules will be injected in the React Native runtime when the app starts.<!-- --> 35<ul> 36<li><code>ios.modulesConformingToProtocol.RCTImageURLLoader</code>: list of iOS native module that implements the <a href=https://github.com/facebook/react-native/blob/00d5caee9921b6c10be8f7d5b3903c6afe8dbefa/packages/react-native/Libraries/Image/RCTImageURLLoader.h#L26-L81 target=_blank rel="noopener noreferrer"><code>RCTImageURLLoader</code> protocol</a>. You need to pass the class names of iOS classes that implements the <code>RCTImageURLLoader</code>. They must be Native Modules.</li> 37<li><code>ios.modulesConformingToProtocol.RCTURLRequestHandler</code>: list of iOS native module that implements the <a href=https://github.com/facebook/react-native/blob/00d5caee9921b6c10be8f7d5b3903c6afe8dbefa/packages/react-native/React/Base/RCTURLRequestHandler.h#L11-L52 target=_blank rel="noopener noreferrer"><code>RCTURLRequestHandler</code> protocol</a>. You need to pass the class names of iOS classes that implements the <code>RCTURLRequestHandler</code>. They must be Native Modules.</li> 38<li><code>ios.modulesConformingToProtocol.RCTImageDataDecoder</code>: list of iOS native module that implements the <a href=https://github.com/facebook/react-native/blob/00d5caee9921b6c10be8f7d5b3903c6afe8dbefa/packages/react-native/Libraries/Image/RCTImageDataDecoder.h#L15-L53 target=_blank rel="noopener noreferrer"><code>RCTImageDataDecoder</code> protocol</a>. You need to pass the class names of iOS classes that implements the <code>RCTImageDataDecoder</code>. They must be Native Modules.</li> 39</ul> 40</li> 41<li><code>ios.componentProvider</code>: this field is a map used to generate the association between a custom JS React component and the native class that implements it. The key of the map is the JS name of the component (for example <code>TextInput</code>), and the value is the iOS class that implements the component (for example <code>RCTTextInput</code>).</li> 42<li><code>ios.modulesProvider</code>: this field is a map used to generate the association between a custom JS Native Module and the native class that can provide it. The key of the map is the JS name of the module (for example <code>NativeLocalStorage</code>), and the value is the iOS class that implements the <a href=https://github.com/facebook/react-native/blob/0.79-stable/packages/react-native/ReactCommon/react/nativemodule/core/platform/ios/ReactCommon/RCTTurboModule.h#L179-L190 target=_blank rel="noopener noreferrer"><code>RCTModuleProvider</code> protocol</a>. For Objective-C modules, the class implementing the <a href=https://github.com/facebook/react-native/blob/0.79-stable/packages/react-native/ReactCommon/react/nativemodule/core/platform/ios/ReactCommon/RCTTurboModule.h#L192-L200 target=_blank rel="noopener noreferrer"><code>RCTTurboModule</code> protocol</a> is also implementing the <code>RCTModuleProvider</code> protocol. For more information, looks at the <a href=/docs/next/the-new-architecture/pure-cxx-modules>Cross-Platform Native Modules (C++) guide</a>.</li> 43</ul> 44</li> 45</ul> 46<p>When <strong>Codegen</strong> runs, it searches among all the dependencies of the app, looking for JS files that respects some specific conventions, and it generates the required code:</p> 47<ul> 48<li>Turbo Native Modules require that the spec files are prefixed with <code>Native</code>. For example, <code>NativeLocalStorage.ts</code> is a valid name for a spec file.</li> 49<li>Native Fabric Components require that the spec files are suffixed with <code>NativeComponent</code>. For example, <code>WebViewNativeComponent.ts</code> is a valid name for a spec file.</li> 50</ul> 51<h2 class="anchor anchorWithStickyNavbar_JmGV" id=running-codegen>Running <strong>Codegen</strong><a href=#running-codegen class=hash-link aria-label="Direct link to running-codegen" title="Direct link to running-codegen"></a></h2> 52<p>The rest of this guide assumes that you have a Native Turbo Module, a Native Fabric Component or both already set up in your project. We also assume that you have valid specification files in the <code>jsSrcsDir</code> specified in the <code>package.json</code>.</p> 53<h3 class="anchor anchorWithStickyNavbar_JmGV" id=android>Android<a href=#android class=hash-link aria-label="Direct link to Android" title="Direct link to Android"></a></h3> 54<p><strong>Codegen</strong> for Android is integrated with the React Native Gradle Plugin (RNGP). The RNGP contains a task that can be invoked that reads the configurations defined in the <code>package.json</code> file and execute <strong>Codegen</strong>. To run the gradle task, first navigate inside the <code>android</code> folder of your project. Then run:</p> 55<div class="language-bash codeBlockContainer_mQmQ theme-code-block" style=--prism-color:#FFFFFF;--prism-background-color:#282C34><div class=codeBlockTitle_kY6l>bash</div><div class=codeBlockContent_t_Hd><pre tabindex=0 class="prism-code language-bash codeBlock_RMoD thin-scrollbar" style=color:#FFFFFF;background-color:#282C34><code class=codeBlockLines_AclH><span class=token-line style=color:#FFFFFF><span class="token plain">./gradlew generateCodegenArtifactsFromSchema</span><br></span></code></pre></div></div> 56<p>This task invokes the <code>generateCodegenArtifactsFromSchema</code> command on all the imported projects of the app (the app and all the node modules which are linked to it). It generates the code in the corresponding <code>node_modules/&lt;dependency></code> folder. For example, if you have a Fabric Native Component whose Node module is called <code>my-fabric-component</code>, the generated code is located in the <code>SampleApp/node_modules/my-fabric-component/android/build/generated/source/codegen</code> path. For the app, the code is generated in the <code>android/app/build/generated/source/codegen</code> folder.</p> 57<h4 class="anchor anchorWithStickyNavbar_JmGV" id=the-generated-code>The Generated Code<a href=#the-generated-code class=hash-link aria-label="Direct link to The Generated Code" title="Direct link to The Generated Code"></a></h4> 58<p>After running the gradle command above, you will find the codegen code in the <code>SampleApp/android/app/build</code> folder. The structure will look like this:</p> 59<div class="language-tsx codeBlockContainer_mQmQ theme-code-block" style=--prism-color:#FFFFFF;--prism-background-color:#282C34><div class=codeBlockContent_t_Hd><pre tabindex=0 class="prism-code language-tsx codeBlock_RMoD thin-scrollbar" style=color:#FFFFFF;background-color:#282C34><code class=codeBlockLines_AclH><span class=token-line style=color:#FFFFFF><span class="token plain">build</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain">└── generated</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> └── source</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> └── codegen</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> ├── java</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> │ └── com</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> │ ├── facebook</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> │ │ └── react</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> │ │ └── viewmanagers</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> │ │ ├── </span><span class="token tag punctuation" style=color:#657b83>&lt;</span><span class="token tag" style=color:#fc929e>nativeComponent</span><span class="token tag punctuation" style=color:#657b83>></span><span class="token plain-text">ManagerDelegate.java</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> │ │ └── </span><span class="token tag punctuation" style=color:#657b83>&lt;</span><span class="token tag" style=color:#fc929e>nativeComponent</span><span class="token tag punctuation" style=color:#657b83>></span><span class="token plain-text">ManagerInterface.java</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> │ └── sampleapp</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> │ └── NativeLocalStorageSpec.java</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> ├── jni</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> │ ├── </span><span class="token tag punctuation" style=color:#657b83>&lt;</span><span class="token tag" style=color:#fc929e>codegenConfig.name</span><span class="token tag punctuation" style=color:#657b83>></span><span class="token plain-text">-generated.cpp</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> │ ├── </span><span class="token tag punctuation" style=color:#657b83>&lt;</span><span class="token tag" style=color:#fc929e>codegenConfig.name</span><span class="token tag punctuation" style=color:#657b83>></span><span class="token plain-text">.h</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> │ ├── CMakeLists.txt</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> │ └── react</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> │ └── renderer</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> │ └── components</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> │ └── </span><span class="token tag punctuation" style=color:#657b83>&lt;</span><span class="token tag" style=color:#fc929e>codegenConfig.name</span><span class="token tag punctuation" style=color:#657b83>></span><span class="token plain-text"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> │ ├── </span><span class="token tag punctuation" style=color:#657b83>&lt;</span><span class="token tag" style=color:#fc929e>codegenConfig.name</span><span class="token tag punctuation" style=color:#657b83>></span><span class="token plain-text">JSI-generated.cpp</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> │ ├── </span><span class="token tag punctuation" style=color:#657b83>&lt;</span><span class="token tag" style=color:#fc929e>codegenConfig.name</span><span class="token tag punctuation" style=color:#657b83>></span><span class="token plain-text">.h</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> │ ├── ComponentDescriptors.cpp</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> │ ├── ComponentDescriptors.h</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> │ ├── EventEmitters.cpp</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> │ ├── EventEmitters.h</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> │ ├── Props.cpp</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> │ ├── Props.h</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> │ ├── ShadowNodes.cpp</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> │ ├── ShadowNodes.h</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> │ ├── States.cpp</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> │ └── States.h</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> └── schema.json</span><br></span></code></pre></div></div> 60<p>The generated code is split in two folders:</p> 61<ul> 62<li><code>java</code> which contains the platform specific code</li> 63<li><code>jni</code> which contains the C++ code required to let JS and Java interact correctly.</li> 64</ul> 65<p>In the <code>java</code> folder, you can find the Fabric Native component generated code in the <code>com/facebook/viewmanagers</code> subfolder.</p> 66<ul> 67<li>the <code>&lt;nativeComponent>ManagerDelegate.java</code> contains the methods that the <code>ViewManager</code> can call on the custom Native Component</li> 68<li>the <code>&lt;nativeComponent>ManagerInterface.java</code> contains the interface of the <code>ViewManager</code>.</li> 69</ul> 70<p>In the folder whose name was set up in the <code>codegenConfig.android.javaPackageName</code>, instead, you can find the abstract class that a Turbo Native Module has to implement to carry out its tasks.</p> 71<p>In the <code>jni</code> folder, finally, there is all the boilerplate code to connect JS to Android.</p> 72<ul> 73<li><code>&lt;codegenConfig.name>.h</code> this contains the interface of your custom C++ Turbo Native Modules.</li> 74<li><code>&lt;codegenConfig.name>-generated.cpp</code> this contains the glue code of your custom C++ Turbo Native Modules.</li> 75<li><code>react/renderer/components/&lt;codegenConfig.name></code>: this folder contains all the glue-code required by your custom component.</li> 76</ul> 77<p>This structure has been generated by using the value <code>all</code> for the <code>codegenConfig.type</code> field. If you use the value <code>modules</code>, expect to see no <code>react/renderer/components/</code> folder. If you use the value <code>components</code>, expect not to see any of the other files.</p> 78<h3 class="anchor anchorWithStickyNavbar_JmGV" id=ios>iOS<a href=#ios class=hash-link aria-label="Direct link to iOS" title="Direct link to iOS"></a></h3> 79<p><strong>Codegen</strong> for iOS relies on some Node scripts that are invoked during the build process. The scripts are located in the <code>SampleApp/node_modules/react-native/scripts/</code> folder.</p> 80<p>The main script is the <code>generate-codegen-artifacts.js</code> script. To invoke the script, you can run this command from the root folder of your app:</p> 81<div class="language-bash codeBlockContainer_mQmQ theme-code-block" style=--prism-color:#FFFFFF;--prism-background-color:#282C34><div class=codeBlockTitle_kY6l>bash</div><div class=codeBlockContent_t_Hd><pre tabindex=0 class="prism-code language-bash codeBlock_RMoD thin-scrollbar" style=color:#FFFFFF;background-color:#282C34><code class=codeBlockLines_AclH><span class=token-line style=color:#FFFFFF><span class="token function" style=color:#79b6f2>node</span><span class="token plain"> node_modules/react-native/scripts/generate-codegen-artifacts.js</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain" style=display:inline-block></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain">Usage: generate-codegen-artifacts.js </span><span class="token parameter variable" style=color:#cb4b16>-p</span><span class="token plain"> </span><span class="token punctuation" style=color:#657b83>[</span><span class="token plain">path to app</span><span class="token punctuation" style=color:#657b83>]</span><span class="token plain"> </span><span class="token parameter variable" style=color:#cb4b16>-t</span><span class="token plain"> </span><span class="token punctuation" style=color:#657b83>[</span><span class="token plain">target platform</span><span class="token punctuation" style=color:#657b83>]</span><span class="token plain"> </span><span class="token parameter variable" style=color:#cb4b16>-o</span><span class="token plain"> </span><span class="token punctuation" style=color:#657b83>[</span><span class="token plain">output path</span><span class="token punctuation" style=color:#657b83>]</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain" style=display:inline-block></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain">Options:</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token parameter variable" style=color:#cb4b16>--help</span><span class="token plain"> Show </span><span class="token builtin class-name" style=color:#fac863>help</span><span class="token plain"> </span><span class="token punctuation" style=color:#657b83>[</span><span class="token plain">boolean</span><span class="token punctuation" style=color:#657b83>]</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token parameter variable" style=color:#cb4b16>--version</span><span class="token plain"> Show version number </span><span class="token punctuation" style=color:#657b83>[</span><span class="token plain">boolean</span><span class="token punctuation" style=color:#657b83>]</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> -p, </span><span class="token parameter variable" style=color:#cb4b16>--path</span><span class="token plain"> Path to the React Native project root. </span><span class="token punctuation" style=color:#657b83>[</span><span class="token plain">required</span><span class="token punctuation" style=color:#657b83>]</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> -t, </span><span class="token parameter variable" style=color:#cb4b16>--targetPlatform</span><span class="token plain"> Target platform. Supported values: </span><span class="token string" style=color:#8dc891>"android"</span><span class="token plain">, </span><span class="token string" style=color:#8dc891>"ios"</span><span class="token plain">,</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token string" style=color:#8dc891>"all"</span><span class="token builtin class-name" style=color:#fac863>.</span><span class="token plain"> </span><span class="token punctuation" style=color:#657b83>[</span><span class="token plain">required</span><span class="token punctuation" style=color:#657b83>]</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> -o, </span><span class="token parameter variable" style=color:#cb4b16>--outputPath</span><span class="token plain"> Path where generated artifacts will be output to.</span><br></span></code></pre></div></div> 82<p>where:</p> 83<ul> 84<li><code>--path</code> is the path to the root folder of your app.</li> 85<li><code>--outputPath</code> is the destination where <strong>Codegen</strong> will write the generated files.</li> 86<li><code>--targetPlatform</code> is the platform you'd like to generate the code for.</li> 87</ul> 88<h4 class="anchor anchorWithStickyNavbar_JmGV" id=the-generated-code-1>The Generated Code<a href=#the-generated-code-1 class=hash-link aria-label="Direct link to The Generated Code" title="Direct link to The Generated Code"></a></h4> 89<p>Running the script with these arguments:</p> 90<div class="language-shell codeBlockContainer_mQmQ theme-code-block" style=--prism-color:#FFFFFF;--prism-background-color:#282C34><div class=codeBlockTitle_kY6l>shell</div><div class=codeBlockContent_t_Hd><pre tabindex=0 class="prism-code language-shell codeBlock_RMoD thin-scrollbar" style=color:#FFFFFF;background-color:#282C34><code class=codeBlockLines_AclH><span class=token-line style=color:#FFFFFF><span class="token function" style=color:#79b6f2>node</span><span class="token plain"> node_modules/react-native/scripts/generate-codegen-artifacts.js </span><span class="token punctuation" style=color:#657b83>\</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token parameter variable" style=color:#cb4b16>--path</span><span class="token plain"> </span><span class="token builtin class-name" style=color:#fac863>.</span><span class="token plain"> </span><span class="token punctuation" style=color:#657b83>\</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token parameter variable" style=color:#cb4b16>--outputPath</span><span class="token plain"> ios/ </span><span class="token punctuation" style=color:#657b83>\</span><span class="token plain"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> </span><span class="token parameter variable" style=color:#cb4b16>--targetPlatform</span><span class="token plain"> ios</span><br></span></code></pre></div></div> 91<p>Will generate these files in the <code>ios/build</code> folder:</p> 92<div class="language-tsx codeBlockContainer_mQmQ theme-code-block" style=--prism-color:#FFFFFF;--prism-background-color:#282C34><div class=codeBlockContent_t_Hd><pre tabindex=0 class="prism-code language-tsx codeBlock_RMoD thin-scrollbar" style=color:#FFFFFF;background-color:#282C34><code class=codeBlockLines_AclH><span class=token-line style=color:#FFFFFF><span class="token plain">build</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain">└── generated</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> └── ios</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain"> ├── </span><span class="token tag punctuation" style=color:#657b83>&lt;</span><span class="token tag" style=color:#fc929e>codegenConfig.name</span><span class="token tag punctuation" style=color:#657b83>></span><span class="token plain-text"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> │ ├── </span><span class="token tag punctuation" style=color:#657b83>&lt;</span><span class="token tag" style=color:#fc929e>codegenConfig.name</span><span class="token tag punctuation" style=color:#657b83>></span><span class="token plain-text">-generated.mm</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> │ └── </span><span class="token tag punctuation" style=color:#657b83>&lt;</span><span class="token tag" style=color:#fc929e>codegenConfig.name</span><span class="token tag punctuation" style=color:#657b83>></span><span class="token plain-text">.h</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> ├── </span><span class="token tag punctuation" style=color:#657b83>&lt;</span><span class="token tag" style=color:#fc929e>codegenConfig.name</span><span class="token tag punctuation" style=color:#657b83>></span><span class="token plain-text">JSI-generated.cpp</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> ├── </span><span class="token tag punctuation" style=color:#657b83>&lt;</span><span class="token tag" style=color:#fc929e>codegenConfig.name</span><span class="token tag punctuation" style=color:#657b83>></span><span class="token plain-text">JSI.h</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> ├── FBReactNativeSpec</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> │ ├── FBReactNativeSpec-generated.mm</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> │ └── FBReactNativeSpec.h</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> ├── FBReactNativeSpecJSI-generated.cpp</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> ├── FBReactNativeSpecJSI.h</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> ├── RCTModulesConformingToProtocolsProvider.h</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> ├── RCTModulesConformingToProtocolsProvider.mm</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> └── react</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> └── renderer</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> └── components</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> └── </span><span class="token tag punctuation" style=color:#657b83>&lt;</span><span class="token tag" style=color:#fc929e>codegenConfig.name</span><span class="token tag punctuation" style=color:#657b83>></span><span class="token plain-text"></span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> ├── ComponentDescriptors.cpp</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> ├── ComponentDescriptors.h</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> ├── EventEmitters.cpp</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> ├── EventEmitters.h</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> ├── Props.cpp</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> ├── Props.h</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> ├── RCTComponentViewHelpers.h</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> ├── ShadowNodes.cpp</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> ├── ShadowNodes.h</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> ├── States.cpp</span><br></span><span class=token-line style=color:#FFFFFF><span class="token plain-text"> └── States.h</span><br></span></code></pre></div></div> 93<p>Part of these generated files are used by React Native in the Core. Then there is a set of files which contains the same name you specified in the package.json <code>codegenConfig.name</code> field.</p> 94<ul> 95<li><code>&lt;codegenConfig.name>/&lt;codegenConfig.name>.h</code>: this contains the interface of your custom iOS Turbo Native Modules.</li> 96<li><code>&lt;codegenConfig.name>/&lt;codegenConfig.name>-generated.mm</code>: this contains the glue code of your custom iOS Turbo Native Modules.</li> 97<li><code>&lt;codegenConfig.name>JSI.h</code>: this contains the interface of your custom C++ Turbo Native Modules.</li> 98<li><code>&lt;codegenConfig.name>JSI-generated.h</code>: this contains the glue code of your custom C++ Turbo Native Modules.</li> 99<li><code>react/renderer/components/&lt;codegenConfig.name></code>: this folder contains all the glue-code required by your custom component.</li> 100</ul> 101<p>This structure has been generated by using the value <code>all</code> for the <code>codegenConfig.type</code> field. If you use the value <code>modules</code>, expect to see no <code>react/renderer/components/</code> folder. If you use the value <code>components</code>, expect not to see any of the other files.</div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="theme-doc-footer-edit-meta-row row"><div class=editButtons_t0bR><a href=https://github.com/facebook/react-native-website/edit/main/docs/the-new-architecture/using-codegen.md target=_blank rel="noopener noreferrer" class=theme-edit-this-page><svg fill=currentColor height=20 width=20 viewBox="0 0 40 40" class=iconEdit_bHB7 aria-hidden=true><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"/></g></svg>Edit page for next release</a><a href=https://github.com/facebook/react-native-website/edit/main/website/versioned_docs/version-0.79/the-new-architecture/using-codegen.md target=_blank rel="noopener noreferrer" class=theme-edit-this-page><svg fill=currentColor height=20 width=20 viewBox="0 0 40 40" class=iconEdit_bHB7 aria-hidden=true><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"/></g></svg>Edit page for current release</a></div><div class=lastUpdated_VsjB><span class=theme-last-updated>Last updated<!-- --> on <b><time datetime=2025-04-14T14:14:17.000Z itemprop=dateModified>Apr 14, 2025</time></b></span></div></div></footer></article><nav class="docusaurus-mt-lg pagination-nav" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href=/docs/the-new-architecture/what-is-codegen><div class=pagination-nav__sublabel>Previous</div><div class=pagination-nav__label>What is Codegen?</div></a><a class="pagination-nav__link pagination-nav__link--next" href=/docs/the-new-architecture/codegen-cli><div class=pagination-nav__sublabel>Next</div><div class=pagination-nav__label>The Codegen CLI</div></a></nav></div></div><div class="col col--3"><div class="tableOfContents_XG6w thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href=#prerequisites class="table-of-contents__link toc-highlight">Prerequisites</a><li><a href=#configuring-codegen class="table-of-contents__link toc-highlight">Configuring <strong>Codegen</strong></a><li><a href=#running-codegen class="table-of-contents__link toc-highlight">Running <strong>Codegen</strong></a><ul><li><a href=#android class="table-of-contents__link toc-highlight">Android</a><li><a href=#ios class="table-of-contents__link toc-highlight">iOS</a></ul></ul></div></div></div></div></main></div></div></div><footer class="theme-layout-footer footer footer--dark"><div class="container container-fluid"><div class="row footer__links"><div class="theme-layout-footer-column col footer__col"><div class=footer__title>Develop</div><ul class="footer__items clean-list"><li class=footer__item><a class=footer__link-item href=/docs/getting-started>Guides</a><li class=footer__item><a class=footer__link-item href=/docs/components-and-apis>Components</a><li class=footer__item><a class=footer__link-item href=/docs/accessibilityinfo>APIs</a><li class=footer__item><a class=footer__link-item href=/architecture/overview>Architecture</a></ul></div><div class="theme-layout-footer-column col footer__col"><div class=footer__title>Participate</div><ul class="footer__items clean-list"><li class=footer__item><a class=footer__link-item href=/showcase>Showcase</a><li class=footer__item><a class=footer__link-item href=/contributing/overview>Contributing</a><li class=footer__item><a class=footer__link-item href=/community/overview>Community</a><li class=footer__item><a href=https://reactnative.directory/ target=_blank rel="noopener noreferrer" class=footer__link-item>Directory<svg width=13.5 height=13.5 aria-hidden=true viewBox="0 0 24 24" class=iconExternalLink_2l9O><path fill=currentColor d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"/></svg></a><li class=footer__item><a href=https://stackoverflow.com/questions/tagged/react-native target=_blank rel="noopener noreferrer" class=footer__link-item>Stack Overflow<svg width=13.5 height=13.5 aria-hidden=true viewBox="0 0 24 24" class=iconExternalLink_2l9O><path fill=currentColor d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"/></svg></a></ul></div><div class="theme-layout-footer-column col footer__col"><div class=footer__title>Find us</div><ul class="footer__items clean-list"><li class=footer__item><a class=footer__link-item href=/blog>Blog</a><li class=footer__item><a href=https://x.com/reactnative target=_blank rel="noopener noreferrer" class=footer__link-item>X<svg width=13.5 height=13.5 aria-hidden=true viewBox="0 0 24 24" class=iconExternalLink_2l9O><path fill=currentColor d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"/></svg></a><li class=footer__item><a href=https://bsky.app/profile/reactnative.dev target=_blank rel="noopener noreferrer" class=footer__link-item>Bluesky<svg width=13.5 height=13.5 aria-hidden=true viewBox="0 0 24 24" class=iconExternalLink_2l9O><path fill=currentColor d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"/></svg></a><li class=footer__item><a href=https://github.com/facebook/react-native target=_blank rel="noopener noreferrer" class=footer__link-item>GitHub<svg width=13.5 height=13.5 aria-hidden=true viewBox="0 0 24 24" class=iconExternalLink_2l9O><path fill=currentColor d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"/></svg></a></ul></div><div class="theme-layout-footer-column col footer__col"><div class=footer__title>Explore More</div><ul class="footer__items clean-list"><li class=footer__item><a href=https://react.dev/ target=_blank rel="noopener noreferrer" class=footer__link-item>ReactJS<svg width=13.5 height=13.5 aria-hidden=true viewBox="0 0 24 24" class=iconExternalLink_2l9O><path fill=currentColor d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"/></svg></a><li class=footer__item><a href=https://opensource.fb.com/legal/privacy/ target=_blank rel="noopener noreferrer" class=footer__link-item>Privacy Policy<svg width=13.5 height=13.5 aria-hidden=true viewBox="0 0 24 24" class=iconExternalLink_2l9O><path fill=currentColor d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"/></svg></a><li class=footer__item><a href=https://opensource.fb.com/legal/terms/ target=_blank rel="noopener noreferrer" class=footer__link-item>Terms of Service<svg width=13.5 height=13.5 aria-hidden=true viewBox="0 0 24 24" class=iconExternalLink_2l9O><path fill=currentColor d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"/></svg></a></ul></div></div><div class="footer__bottom text--center"><div class=margin-bottom--sm><a href=https://opensource.fb.com/ rel="noopener noreferrer" class=footerLogoLink_tutC><img src=/img/oss_logo.svg alt="Meta Open Source Logo" class="footer__logo themedComponent_siVc themedComponent--light_hHel"><img src=/img/oss_logo.svg alt="Meta Open Source Logo" class="footer__logo themedComponent_siVc themedComponent--dark_yETr"></a></div><div class=footer__copyright>Copyright © 2025 Meta Platforms, Inc.</div></div></div></footer></div>