Issue with running "pod install" when setting up the SDK for iOS simulation in Xcode

As a first-time user trying to set up the SDK for testing and running the official sample demo on iOS simulation in Xcode, I encountered an issue with the "pod install" command. It seems that the official documentation assumes that users have already prepared the necessary environments, which led to continuous failure when running the command.

Here are the specific steps I followed:

1. I input ruby -v to check if Ruby is installed. If it is installed, it should return the current version information, for example:

   MEDevel.com: Open-source for Healthcare and Education

   Collecting and validating open-source software for healthcare, education, enterprise, development, medical imaging, medical records, and digital pathology.

   Visit Medevel

   ruby 3.1.2p20 (2022-04-12 revision 4491bb740a) [arm64-darwin23]
   

   I also checked if the architecture in the brackets at the end of the returned information matches the current chip architecture.

   If Ruby is not installed, I understand that I need to follow additional steps to install it.

However, even after ensuring that Ruby is installed with the correct version and architecture, I still encounter issues when running pod install.

I suspect that there might be other prerequisites or environment setup steps that are not clearly mentioned in the documentation, leading to the failure of the pod install command.

Could someone please provide a detailed guide on the complete setup process, including all the necessary prerequisites and environment configurations, to successfully run pod install and set up the SDK for iOS simulation in Xcode? It would be greatly appreciated if the guide could assume minimal prior knowledge and provide step-by-step instructions.

>Solution :

Here’s a detailed step-by-step guide to help you set up the SDK for iOS simulation in Xcode:

1. Install Xcode:

   • Download and install the latest version of Xcode from the Mac App Store or the official Apple developer website.
   • Make sure to install the necessary components, including the iOS Simulator, during the Xcode installation process.

2. Install Homebrew (if not already installed):

   • Open Terminal.
   • Run the following command to install Homebrew:

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

   • Follow the on-screen instructions to complete the installation.

3. Install Ruby (if not already installed):

   • In Terminal, run the following command to install Ruby using Homebrew:

     brew install ruby
     

   • Once the installation is complete, verify the Ruby version by running:

     ruby -v
     

   • Ensure that the Ruby version matches the required version for the SDK.

4. Install CocoaPods:

   • In Terminal, run the following command to install CocoaPods:

     sudo gem install cocoapods
     

   • Wait for the installation to complete.

5. Set up the SDK:

   • Download or clone the SDK repository to your local machine.
   • Open Terminal and navigate to the SDK’s root directory.
   • Run the following command to install the required dependencies:

     pod install
     

   • Wait for the installation process to finish. It may take some time to download and install all the necessary pods.

6. Open the Xcode workspace:

   • In the SDK’s root directory, locate the .xcworkspace file.
   • Double-click on the .xcworkspace file to open it in Xcode.

7. Run the sample demo:

   • In Xcode, select the desired iOS Simulator device from the dropdown menu in the top-left corner.
   • Click the "Run" button or press Cmd + R to build and run the sample demo on the selected simulator.

By following these steps, you should be able to set up the necessary environment and run the pod install command successfully. If you encounter any issues along the way, please let me know, and I’ll be happy to assist you further.

Remember to refer to the SDK’s official documentation for any specific requirements or additional steps that may be needed for your particular SDK version.