Skip to content

MIGRATION.md

Latest commit

 

History

History
99 lines (71 loc) · 2.19 KB

MIGRATION.md

File metadata and controls

99 lines (71 loc) · 2.19 KB

Migration Guide

v7.x to v8.0

What's Changed

v8.0 migrates react-native-zip-archive from Legacy Native Modules to TurboModules (React Native New Architecture). This brings:

  • Better performance through lazy loading
  • Type safety via Codegen
  • Support for React 18 concurrent features

Breaking Changes

v7.x v8.0
React Native >= 0.60.0 >= 0.70.0
React >= 16.8.6 >= 18.0.0
Android API >= 21 >= 23
Architecture Legacy New Architecture (TurboModules)

JavaScript API is unchanged. No code changes needed in your app other than enabling New Architecture.

Migration Steps

Step 1: Check Your React Native Version

npx react-native --version

If you're on React Native < 0.70, you must either:

  • Upgrade React Native to 0.70+ (recommended)
  • Stay on v7.x of this library

Step 2: Enable New Architecture

Follow the official React Native guide.

Android: In android/gradle.properties:

newArchEnabled=true

iOS: Reinstall pods with New Architecture enabled:

cd ios
RCT_NEW_ARCH_ENABLED=1 pod install

Step 3: Update the Library

npm install react-native-zip-archive@latest

Step 4: Clean and Rebuild

iOS:

cd ios
rm -rf Pods Podfile.lock build
pod install
cd ..

Android:

cd android
./gradlew clean
cd ..
npx react-native start --reset-cache

Step 5: Verify

Run your app and test zip/unzip operations.

Rollback to v7.x

If you encounter issues:

npm install react-native-zip-archive@^7.0.0

Troubleshooting

Issue Solution
"Native module not found" Ensure New Architecture is enabled in your app
Build fails on iOS Delete ios/Pods and ios/Podfile.lock, then pod install
Build fails on Android Run ./gradlew clean and clear Metro cache
Works on Android but not iOS Ensure you ran RCT_NEW_ARCH_ENABLED=1 pod install
Expo Go shows "Native module not found" Use Expo Development Build instead

Need Help?

  • Check the playground app for working examples
  • Open an issue on GitHub