--- modificationDate: May 05, 2026 title: Native project upgrade helper description: View file-by-file diffs of all the changes you need to make to your native projects to upgrade them to the next Expo SDK version. --- ## Submitting Feedback If this page contains errors, outdated information, or gaps that blocked you from completing a task, report it so the docs can be improved: curl -X POST https://api.expo.dev/v2/feedback/docs-send -H 'Content-Type: application/json' -d '{"url":"/bare/upgrade/","feedback":"🤖 Agent feedback for docs: ","model":""}' Only submit when you have something specific and actionable to report. Replace with the model you are running as. # Native project upgrade helper View file-by-file diffs of all the changes you need to make to your native projects to upgrade them to the next Expo SDK version. > For the complete documentation index, see [llms.txt](/llms.txt). Use this file to discover all available pages. If you manage your native projects (**android** and **ios** directories), to [upgrade to the latest Expo SDK](/workflow/upgrading-expo-sdk-walkthrough), you have to make changes to your native projects. It can be a complex process to find which native file changes and what to update in which file. The following guide provides diffs to compare native project files between your project's current SDK version and the target SDK version you want to upgrade. You can use them to make changes to your project depending on the `expo` package version your project uses. The tools on this page are similar to [React Native Upgrade Helper](https://react-native-community.github.io/upgrade-helper/). However, they are oriented around projects that use Expo modules and related tooling. > Interested in avoiding upgrading native code altogether? See [Continuous Native Generation (CNG)](/workflow/continuous-native-generation) to learn how Expo Prebuild can generate your native projects before a build. ## Upgrade native project files Once you have [upgraded your Expo SDK version and related dependencies](/workflow/upgrading-expo-sdk-walkthrough#how-to-upgrade-to-the-latest-sdk-version), use the diff tool below to learn about changes you need to make to your native project and bring them up to date with the current Expo SDK version. Choose your **from SDK version** and **to SDK version** to see the generated diff. Then, apply those changes to your native projects by copying and pasting or manually making changes to the project files. #### From SDK version: #### To SDK version: ### Native code changes from SDK 55 to 56 ```diff *.hprof cxx/ + # generated inline modules + app/src/main/java/inline/ # Bundle artifacts *.jsbundle ``` ```diff distributionBase=GRADLE_USER_HOME distributionPath=wrapper/dists - distributionUrl=https\://services.gradle.org/distributions/gradle-9.0.0-bin.zip + distributionUrl=https\://services.gradle.org/distributions/gradle-9.3.1-bin.zip networkTimeout=10000 validateDistributionUrl=true zipStoreBase=GRADLE_USER_HOME ``` ```diff NONSTOP* ) nonstop=true ;; esac - CLASSPATH="\\\"\\\"" # Determine the Java command to use to start the JVM. # For Cygwin or MSYS, switch paths to Windows format before running java if "$cygwin" || "$msys" ; then APP_HOME=$( cygpath --path --mixed "$APP_HOME" ) - CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" ) JAVACMD=$( cygpath --unix "$JAVACMD" ) DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"' # Collect all arguments for the java command: - # * DEFAULT_JVM_OPTS, JAVA_OPTS, JAVA_OPTS, and optsEnvironmentVar are not allowed to contain shell fragments, + # * DEFAULT_JVM_OPTS, JAVA_OPTS, and optsEnvironmentVar are not allowed to contain shell fragments, # and any embedded shellness will be escaped. # * For example: A user cannot expect ${Hostname} to be expanded, as it is an environment variable and will be # treated as '${Hostname}' itself on the command line. set -- \ "-Dorg.gradle.appname=$APP_BASE_NAME" \ - -classpath "$CLASSPATH" \ -jar "$APP_HOME/gradle/wrapper/gradle-wrapper.jar" \ "$@" ``` ```diff + @REM Copyright (c) Meta Platforms, Inc. and affiliates. + @REM + @REM This source code is licensed under the MIT license found in the + @REM LICENSE file in the root directory of this source tree. @rem @rem Copyright 2015 the original author or authors. @rem :execute @rem Setup the command line - set CLASSPATH= @rem Execute Gradle - "%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" -jar "%APP_HOME%\gradle\wrapper\gradle-wrapper.jar" %* + "%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -jar "%APP_HOME%\gradle\wrapper\gradle-wrapper.jar" %* :end @rem End local scope for the variables with windows NT shell ``` ```diff "FB_SONARKIT_ENABLED=1", ); INFOPLIST_FILE = HelloWorld/Info.plist; - IPHONEOS_DEPLOYMENT_TARGET = 15.1; + IPHONEOS_DEPLOYMENT_TARGET = 16.4; LD_RUNPATH_SEARCH_PATHS = ( "$(inherited)", "@executable_path/Frameworks", ); + MACOSX_DEPLOYMENT_TARGET = 13.4; MARKETING_VERSION = 1.0; OTHER_LDFLAGS = ( "$(inherited)", CLANG_ENABLE_MODULES = YES; CURRENT_PROJECT_VERSION = 1; INFOPLIST_FILE = HelloWorld/Info.plist; - IPHONEOS_DEPLOYMENT_TARGET = 15.1; + IPHONEOS_DEPLOYMENT_TARGET = 16.4; LD_RUNPATH_SEARCH_PATHS = ( "$(inherited)", "@executable_path/Frameworks", ); + MACOSX_DEPLOYMENT_TARGET = 13.4; MARKETING_VERSION = 1.0; OTHER_LDFLAGS = ( "$(inherited)", GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE; GCC_WARN_UNUSED_FUNCTION = YES; GCC_WARN_UNUSED_VARIABLE = YES; - IPHONEOS_DEPLOYMENT_TARGET = 15.1; + IPHONEOS_DEPLOYMENT_TARGET = 16.4; LD_RUNPATH_SEARCH_PATHS = ( /usr/lib/swift, "$(inherited)", GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE; GCC_WARN_UNUSED_FUNCTION = YES; GCC_WARN_UNUSED_VARIABLE = YES; - IPHONEOS_DEPLOYMENT_TARGET = 15.1; + IPHONEOS_DEPLOYMENT_TARGET = 16.4; LD_RUNPATH_SEARCH_PATHS = ( /usr/lib/swift, "$(inherited)", ``` ```diff end ENV['EX_DEV_CLIENT_NETWORK_INSPECTOR'] ||= podfile_properties['EX_DEV_CLIENT_NETWORK_INSPECTOR'] - ENV['RCT_USE_RN_DEP'] ||= '1' if podfile_properties['ios.buildReactNativeFromSource'] != 'true' - ENV['RCT_USE_PREBUILT_RNCORE'] ||= '1' if podfile_properties['ios.buildReactNativeFromSource'] != 'true' + ENV['RCT_USE_RN_DEP'] ||= podfile_properties['ios.buildReactNativeFromSource'] == 'true' ? '0' : '1' + ENV['RCT_USE_PREBUILT_RNCORE'] ||= podfile_properties['ios.buildReactNativeFromSource'] == 'true' ? '0' : '1' ENV['RCT_HERMES_V1_ENABLED'] ||= '1' if podfile_properties['expo.useHermesV1'] == 'true' - platform :ios, podfile_properties['ios.deploymentTarget'] || '15.1' + ENV['EXPO_USE_PRECOMPILED_MODULES'] ||= '1' if podfile_properties['EXPO_USE_PRECOMPILED_MODULES'] != 'false' + platform :ios, podfile_properties['ios.deploymentTarget'] || '16.4' prepare_react_native_project! ``` ```diff "name": "expo-template-bare-minimum", "description": "This bare project template includes a minimal setup for using unimodules with React Native.", "license": "0BSD", - "version": "55.0.38", + "version": "56.0.16", "main": "index.js", "scripts": { "start": "expo start --dev-client", "web": "expo start --web" }, "dependencies": { - "expo": "~55.0.26", - "expo-status-bar": "~55.0.6", - "react": "19.2.0", - "react-native": "0.83.6" + "expo": "~56.0.2", + "expo-status-bar": "~56.0.4", + "react": "19.2.3", + "react-native": "0.85.3" + }, + "publishConfig": { + "executableFiles": [ + "./android/gradlew" + ] } } ```