Prerequisites for Starting a React Native Project on macOS

1. Install Homebrew:

   /bin/bash -c "$(curl -fsSL <https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh>)"
   
   

2. Install Node.js and npm:

   brew install node
   
   

3. Install Watchman:

   brew install watchman
   
   

4. Install CocoaPods:

   sudo gem install cocoapods
   
   

5. Install Xcode:

   • Download and install Xcode from the App Store.

   • Open Xcode and agree to the license agreements:

     sudo xcodebuild -license
     
     

6. Set Xcode Command Line Tools:

   sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
   
   

7. Install Android Studio:

   • Download and install Android Studio from the official website.
   • Set up the Android SDK and create an Android Virtual Device (AVD).

8. Set Up Android Environment Variables:

   • Add the following lines to your ~/.zshrc (or ~/.bash_profile or ~/.profile):

     export ANDROID_HOME=$HOME/Library/Android/sdk
     export PATH=$PATH:$ANDROID_HOME/emulator
     export PATH=$PATH:$ANDROID_HOME/tools
     export PATH=$PATH:$ANDROID_HOME/tools/bin
     export PATH=$PATH:$ANDROID_HOME/platform-tools
     
     

   • Reload your shell configuration:

     source ~/.zshrc
     
     

Steps to Create the Basic React Native App with macOS and Android Support

1. Initialize a New React Native Project:

   npx react-native init <project_name>
   
   

2. Add macOS Support:

   npx react-native init <project_name> --template react-native-template-macos
   
   

If You Run Into This...

1. Error: cli.init is not a function

   • Solution: Uninstall the globally installed react-native-cli:

     npm uninstall -g react-native-cli
     
     

   • Re-run the project initialization:

     npx react-native init <project_name>
     
     

2. Error: xcode-select: error: tool 'xcodebuild' requires Xcode, but active developer directory is a command line tools instance

   • Solution: Set the correct Xcode path:

     sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
     
     

3. Error: CocoaPods could not find compatible versions for pod "React-RuntimeHermes"

   • Solution: Increase the iOS deployment target in your Podfile:

     platform :ios, '15.0'
     
     

4. Error: adb: command not found

   • Solution: Install Android Platform Tools to get the adb command:

     brew install --cask android-platform-tools
     
     

5. Error: Failed to launch emulator. Reason: No emulators found

   • Solution: Create an Android Virtual Device (AVD) using Android Studio:
     • Open Android Studio.
     • Go to Tools > AVD Manager.
     • Create a new AVD and ensure it is properly configured.

6. Error: SDK location not found

   • Solution: Set the ANDROID_HOME environment variable and configure the SDK location:

     echo "sdk.dir=$HOME/Library/Android/sdk" > android/local.properties
     
     

Python Script: react_native_project_provisioning.py