Skip to main content

Installing Xcode

This guide provides the installation instructions for Xcode on macOS along with helpful video links.

Prerequisites​

Before installing Xcode, ensure your system meets the requirements:

  • macOS Version: Xcode requires the latest version of macOS. Update your macOS if necessary by navigating to:

    • Apple Menu > System Preferences > Software Update.

  • Apple Developer Account: An Apple ID is required. You can create one at Apple Developer Account.

Step 1: Install Xcode​

Option 1: Install from the Mac App Store​

  1. Open the Mac App Store:

  2. Download & Install:

    • The download size is large (several GB). Ensure you have a stable internet connection.
    • Once the download is complete, Xcode will automatically install.

  3. Launch Xcode:

    • Open the Launchpad and click the Xcode icon to launch the application.

Option 2: Install via Command Line Tools (For Minimal Setup)​

  1. Install Command Line Tools:

    • Open the Terminal and run: 
      xcode-select --install

  2. Accept the Installation:

    • A dialog box will appear. Click Install to download and install the necessary tools.

  3. Verify Installation:

    • Run the following command in the terminal: 
      xcodebuild -version
    • This should display the installed Xcode version.

Step 2: Install Additional Tools (Optional)​

  1. Install Homebrew (Optional):

    • Homebrew is a package manager for macOS. Install it by running: 
      /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    • Once installed, you can use Homebrew to install useful tools and libraries.

  2. Install CocoaPods (Optional for Flutter and iOS Development):

    • CocoaPods is a dependency manager for Swift and Objective-C projects. Install it by running: 
      sudo gem install cocoapods

Step 3: Configure Xcode for Development​

  1. Open Xcode:

    • Launch Xcode from the Applications folder or via Spotlight Search.

  2. Agree to License:

    • The first time you open Xcode, you’ll be prompted to agree to the terms and conditions.

  3. Install Additional Components:

    • Xcode may prompt you to install additional required components. Allow the installation.

  4. Sign in with Apple ID:

    • Go to Xcode > Settings > Accounts.
    • Sign in with your Apple Developer Account.

Step 4: Set Up Xcode for Flutter Development​

  1. Install Flutter SDK:

    • Follow the Flutter installation instructions at Flutter Docs.

  2. Add Flutter to PATH:

    • Ensure Flutter is correctly added to the PATH variable. You can check by running: 
      flutter doctor

  3. Run flutter doctor:

    • Ensure all dependencies, including Xcode, are installed. This will confirm if Xcode is properly set up for iOS development.

  4. Enable Developer Mode:

    • On macOS Ventura or later, enable developer mode by going to System Settings > Privacy & Security > Developer Mode.

Video Guide for Xcode Installation​

Xcode Installation Video:​

TIPS:
  • Refer to the Xcode Documentation for more details.
  • If flutter doctor reports issues with Xcode, make sure Xcode command-line tools are installed: 
    sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer