Upgrading Expo

Overview

When to Use This Skill

• Upgrading to a new Expo SDK version
• Handling breaking changes between SDK versions
• Updating dependencies for compatibility
• Migrating deprecated APIs to new versions
• Preparing apps for new Expo features

Instructions

1. Pre-Upgrade Planning: Review release notes and breaking changes
2. Dependency Updates: Update packages for SDK compatibility
3. Configuration Migration: Update app.json and configuration files
4. Code Updates: Migrate deprecated APIs to new versions
5. Testing: Verify app functionality after upgrade

Upgrade Process

1. Pre-Upgrade Checklist

• Review Expo SDK release notes
• Identify breaking changes affecting your app
• Check compatibility of third-party packages
• Backup current project state
• Create a feature branch for the upgrade

2. Update Expo SDK

# Update Expo CLI
npm install -g expo-cli@latest

# Upgrade Expo SDK
npx expo install expo@latest

# Update all Expo packages
npx expo install --fix

3. Handle Breaking Changes

• Review migration guides for breaking changes
• Update deprecated API calls
• Modify configuration files as needed
• Update native dependencies if required
• Test affected features thoroughly

4. Update Dependencies

# Check for outdated packages
npx expo-doctor

# Update packages to compatible versions
npx expo install --fix

# Verify compatibility
npx expo-doctor

5. Testing

• Test core app functionality
• Verify native modules work correctly
• Check for runtime errors
• Test on both iOS and Android
• Verify app store builds still work

Common Issues

Dependency Conflicts

• Use

  expo install

  instead of

  npm install

  for Expo packages
• Check package compatibility with new SDK version
• Resolve peer dependency warnings

Configuration Changes

• Update

  app.json

  for new SDK requirements
• Migrate deprecated configuration options
• Update native configuration files if needed

Breaking API Changes

• Review API migration guides
• Update code to use new APIs
• Test affected features after changes

Best Practices

• Always upgrade in a feature branch
• Test thoroughly before merging
• Review release notes carefully
• Update dependencies incrementally
• Keep Expo CLI updated
• Use

  expo-doctor

  to verify setup

Resources