{"id":51810,"date":"2025-08-26T02:27:09","date_gmt":"2025-08-26T02:27:09","guid":{"rendered":"https:\/\/www.devopsschool.com\/blog\/?p=51810"},"modified":"2025-08-26T02:27:09","modified_gmt":"2025-08-26T02:27:09","slug":"ultimate-macos-guide-flutter-android-sdk","status":"publish","type":"post","link":"https:\/\/www.devopsschool.com\/blog\/ultimate-macos-guide-flutter-android-sdk\/","title":{"rendered":"Ultimate macOS Guide: Flutter + Android SDK"},"content":{"rendered":"\n

It covers Android SDK<\/strong>, Java (JDK)<\/strong>, Flutter<\/strong>, Path wiring<\/strong>, Plugin setup<\/strong>, Validation<\/strong>, AVD\/emulator<\/strong>, and creating a project<\/strong>\u2014plus quick fixes.<\/p>\n\n\n\n

\n

Assumptions: default shell = zsh<\/code>, Apple Silicon path (\/opt\/homebrew<\/code>). If you\u2019re on Intel, replace \/opt\/homebrew<\/code> with \/usr\/local<\/code>.<\/p>\n<\/blockquote>\n\n\n\n

\n\n\n\n

1) Install Java (JDK)<\/h2>\n\n\n\n

Most Android\/Gradle stacks are happy with JDK 17+<\/strong>.<\/p>\n\n\n

# Install (latest LTS). If you specifically want 17, use: brew install --cask temurin17<\/span>\nbrew install --cask temurin\n\n# Ensure JAVA_HOME is set automatically<\/span>\necho<\/span> 'export JAVA_HOME=\"$(\/usr\/libexec\/java_home)\"'<\/span> >> ~\/.zshrc\nsource ~\/.zshrc\n\n# Verify<\/span>\njava -version\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
\n\n\n\n
2) Install the Android SDK (CLI-only path, no GUI required)<\/h2>\n\n\n\n
\n
If you prefer Android Studio GUI, install it via brew install --cask android-studio<\/code> and use Preferences \u2192 Android SDK<\/strong> to install Command-line Tools<\/strong>, Platform-Tools<\/strong>, Build-Tools<\/strong>. Then skip to step 3.<\/p>\n<\/blockquote>\n\n\n\n
2.1 Create SDK home and install command-line tools<\/h3>\n\n\n
# Set SDK root (mac default location)<\/span>\necho<\/span> 'export ANDROID_SDK_ROOT=\"$HOME\/Library\/Android\/sdk\"'<\/span> >> ~\/.zshrc\necho<\/span> 'export ANDROID_HOME=\"$ANDROID_SDK_ROOT\"'<\/span> >> ~\/.zshrc\nsource ~\/.zshrc\n\n# Create the folder<\/span>\nmkdir -p \"$ANDROID_SDK_ROOT\"<\/span>\n\n# Install Android command-line tools<\/span>\nbrew install --cask android-commandlinetools\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
2.2 Put tools where Flutter expects them<\/h3>\n\n\n\n
Flutter looks for sdkmanager<\/code> at:
$ANDROID_SDK_ROOT\/cmdline-tools\/latest\/bin\/sdkmanager<\/code><\/p>\n\n\n
mkdir -p \"$ANDROID_SDK_ROOT\/cmdline-tools\"<\/span>\n\n# Try the \"latest\" symlink first (preferred; auto-updates with brew)<\/span>\nrm -rf \"$ANDROID_SDK_ROOT\/cmdline-tools\/latest\"<\/span>\nln -s \"\/opt\/homebrew\/Caskroom\/android-commandlinetools\/latest\/cmdline-tools\"<\/span> \\\n      \"$ANDROID_SDK_ROOT\/cmdline-tools\/latest\"<\/span> 2<\/span>>\/dev\/null<\/span> || true<\/span>\n\n# If your Caskroom doesn't have \"latest\", symlink the version you saw (example: 13114758)<\/span>\nif<\/span> [ ! -x \"$ANDROID_SDK_ROOT\/cmdline-tools\/latest\/bin\/sdkmanager\"<\/span> ]; then\n  ln -s \"\/opt\/homebrew\/Caskroom\/android-commandlinetools\/13114758\/cmdline-tools\"<\/span> \\\n        \"$ANDROID_SDK_ROOT\/cmdline-tools\/latest\"<\/span>\nfi\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
2.3 Add Android tools to PATH<\/h3>\n\n\n
# Add PATHs (platform-tools, emulator, cmdline-tools)<\/span>\n{\n  echo<\/span> 'export PATH=\"$PATH:$ANDROID_SDK_ROOT\/platform-tools\"'<\/span>\n  echo<\/span> 'export PATH=\"$PATH:$ANDROID_SDK_ROOT\/emulator\"'<\/span>\n  echo<\/span> 'export PATH=\"$PATH:$ANDROID_SDK_ROOT\/cmdline-tools\/latest\/bin\"'<\/span>\n} >> ~\/.zshrc\nsource ~\/.zshrc\n\n# Sanity checks<\/span>\nwhich sdkmanager\nwhich adb\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
2.4 Install core SDK components<\/h3>\n\n\n
# Avoid \"repositories.cfg could not be loaded\" warning<\/span>\nmkdir -p ~\/.android && touch ~\/.android\/repositories.cfg\n\n# Accept licenses (press y for each)<\/span>\nsdkmanager --licenses\n\n# Core packages<\/span>\nsdkmanager \"platform-tools\"<\/span> \"emulator\"<\/span> \"cmdline-tools;latest\"<\/span>\n\n# Choose a modern Android platform + build-tools (adjust if needed)<\/span>\nsdkmanager \"platforms;android-35\"<\/span> \"build-tools;35.0.0\"<\/span>\n\n# Optional: system image for an ARM64 emulator<\/span>\nsdkmanager \"system-images;android-35;google_apis;arm64-v8a\"<\/span>\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
\n\n\n\n
3) Install Flutter (CLI)<\/h2>\n\n\n
brew install --cask flutter\n\n# Put Flutter on PATH using the SDK\u2019s own path (future-proof)<\/span>\necho<\/span> 'export PATH=\"$PATH:$(flutter sdk-path)\/bin\"'<\/span> >> ~\/.zshrc\nsource ~\/.zshrc\n\n# Verify<\/span>\nflutter --version\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
\n\n\n\n
4) Wire Flutter \u2194 Android SDK & Validate<\/h2>\n\n\n
# (Only needed if Flutter doesn\u2019t auto-detect your SDK)<\/span>\nflutter config --android-sdk \"$ANDROID_SDK_ROOT\"<\/span>\n\n# Accept Android licenses via Flutter<\/span>\nflutter doctor --android-licenses\n\n# Full diagnostic<\/span>\nflutter doctor -v\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
You should see green checks<\/strong> for:<\/p>\n\n\n\n
    \n
  • Flutter<\/li>\n\n\n\n
  • Android toolchain<\/li>\n\n\n\n
  • Xcode (if installed)<\/li>\n\n\n\n
  • IDEs (if detected)<\/li>\n<\/ul>\n\n\n\n
    \n\n\n\n
    5) Install Flutter plugins (IDEs)<\/h2>\n\n\n\n
    Android Studio<\/h3>\n\n\n\n
      \n
    1. Preferences \u2192 Plugins \u2192 Marketplace<\/strong><\/li>\n\n\n\n
    2. Install Flutter<\/strong> (it auto-installs Dart<\/strong>)<\/li>\n\n\n\n
    3. Restart<\/strong> Android Studio<\/li>\n\n\n\n
    4. Preferences \u2192 Languages & Frameworks \u2192 Flutter<\/strong> \u2192 set Flutter SDK path<\/strong> (yours was: \/opt\/homebrew\/share\/flutter<\/code> or use flutter sdk-path<\/code>)<\/li>\n<\/ol>\n\n\n\n
      VS Code (optional)<\/h3>\n\n\n\n
        \n
      • Install Flutter<\/strong> and Dart<\/strong> extensions from the Marketplace.<\/li>\n<\/ul>\n\n\n\n
        \n\n\n\n
        6) Locate SDK paths quickly (for future prompts)<\/h2>\n\n\n
        # Flutter SDK root<\/span>\nflutter sdk-path\n\n# Android SDK root<\/span>\necho<\/span> $ANDROID_SDK_ROOT\n\n# Where is sdkmanager\/adb?<\/span>\nwhich sdkmanager\nwhich adb\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
        \n\n\n\n
        7) Create and run a Flutter project<\/h2>\n\n\n
        # Create<\/span>\nflutter create hello_app\ncd hello_app\n\n# List devices (emulators\/phones)<\/span>\nflutter devices\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
          \n
        • If you already created an AVD, start it: emulator -list-avds emulator -avd Pixel_8_API_35<\/code><\/li>\n\n\n\n
        • Then run: flutter run<\/code><\/li>\n<\/ul>\n\n\n\n
          \n\n\n\n
          8) Create an Android emulator (AVD) from CLI (optional)<\/h2>\n\n\n
          # Create a Pixel 8 AVD targeting android-35<\/span>\navdmanager create avd -n Pixel_8_API_35 \\\n  -k \"system-images;android-35;google_apis;arm64-v8a\"<\/span> -d pixel_8\n\n# Start it<\/span>\nemulator -avd Pixel_8_API_35\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
          \n\n\n\n
          9) (Optional) iOS setup on macOS<\/h2>\n\n\n\n
          If you want to run on iPhone simulators:<\/p>\n\n\n
          # Xcode CLTs<\/span>\nxcode-select --install || true<\/span>\n\n# First-run (may prompt)<\/span>\nsudo xcodebuild -runFirstLaunch\n\n# (Sometimes license acceptance is interactive in GUI)<\/span>\n# Install CocoaPods for iOS deps<\/span>\nbrew install cocoapods\npod setup\n\n# Check again<\/span>\nflutter doctor -v\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
          \n\n\n\n
          10) Quick Troubleshooting (copy\/paste fixes)<\/h2>\n\n\n\n
          A. Android sdkmanager not found<\/code><\/strong><\/p>\n\n\n
          # Ensure the file exists here:<\/span>\nls \"$ANDROID_SDK_ROOT\/cmdline-tools\/latest\/bin\/sdkmanager\"<\/span>\n\n# Ensure PATH contains it<\/span>\necho<\/span> $PATH | tr ':'<\/span> '\\n'<\/span> | grep cmdline-tools || \\\necho<\/span> 'export PATH=\"$PATH:$ANDROID_SDK_ROOT\/cmdline-tools\/latest\/bin\"'<\/span> >> ~\/.zshrc && source ~\/.zshrc\n\n# Reinstall \/ relink cmdline tools if missing<\/span>\nbrew reinstall --cask android-commandlinetools\nrm -rf \"$ANDROID_SDK_ROOT\/cmdline-tools\/latest\"<\/span>\nln -s \"\/opt\/homebrew\/Caskroom\/android-commandlinetools\/latest\/cmdline-tools\"<\/span> \\\n      \"$ANDROID_SDK_ROOT\/cmdline-tools\/latest\"<\/span>\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
          B. cmdline-tools component is missing<\/code><\/strong><\/p>\n\n\n
          sdkmanager \"cmdline-tools;latest\"<\/span>\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
          C. Emulator not listed in flutter devices<\/code><\/strong><\/p>\n\n\n
          emulator -list<\/span>-avds\n# If none, create one (see section 8), then:<\/span>\nemulator -avd Pixel_8_API_35\nflutter devices\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
          D. License prompts keep appearing<\/strong><\/p>\n\n\n
          yes | sdkmanager --licenses\nflutter doctor --android-licenses\n<\/code><\/span><\/pre>\n\n\n
          E. Wrong SDK path in Android Studio<\/strong><\/p>\n\n\n\n
            \n
          • Set Preferences \u2192 Languages & Frameworks \u2192 Flutter \u2192 Flutter SDK path<\/strong> to:\n
              \n
            • flutter sdk-path<\/code> (paste the result), e.g. \/opt\/homebrew\/share\/flutter<\/code><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n
              F. Verify everything at once<\/strong><\/p>\n\n\n
              echo<\/span> \"ANDROID_SDK_ROOT=$ANDROID_SDK_ROOT\"<\/span>\nwhich sdkmanager && sdkmanager --list<\/span> | head -n 30<\/span>\nadb version\njava -version\nwhich flutter && flutter --version\nflutter doctor -v\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
              \n\n\n\n
              11) One-time setup script (save as setup_flutter_android_macos.sh<\/code>)<\/h2>\n\n\n\n
              \n
              Edit the versioned<\/strong> line (13114758<\/code>) if your cask uses a different folder; the script also tries the latest<\/code> alias.<\/p>\n<\/blockquote>\n\n\n
              #!\/usr\/bin\/env bash<\/span>\nset -euo pipefail\n\n# JDK<\/span>\nbrew install --cask temurin || true<\/span>\n\n# SDK roots<\/span>\ngrep -q 'ANDROID_SDK_ROOT='<\/span> ~\/.zshrc || echo<\/span> 'export ANDROID_SDK_ROOT=\"$HOME\/Library\/Android\/sdk\"'<\/span> >> ~\/.zshrc\ngrep -q 'ANDROID_HOME='<\/span> ~\/.zshrc || echo<\/span> 'export ANDROID_HOME=\"$ANDROID_SDK_ROOT\"'<\/span> >> ~\/.zshrc\nsource ~\/.zshrc\n\nmkdir -p \"$ANDROID_SDK_ROOT\"<\/span>\n\n# Android command-line tools<\/span>\nbrew install --cask android-commandlinetools || true<\/span>\nmkdir -p \"$ANDROID_SDK_ROOT\/cmdline-tools\"<\/span>\nrm -rf \"$ANDROID_SDK_ROOT\/cmdline-tools\/latest\"<\/span>\nln -s \"\/opt\/homebrew\/Caskroom\/android-commandlinetools\/latest\/cmdline-tools\"<\/span> \"$ANDROID_SDK_ROOT\/cmdline-tools\/latest\"<\/span> \\\n  || ln -s \"\/opt\/homebrew\/Caskroom\/android-commandlinetools\/13114758\/cmdline-tools\"<\/span> \"$ANDROID_SDK_ROOT\/cmdline-tools\/latest\"<\/span>\n\n# PATHs<\/span>\ngrep -q 'platform-tools'<\/span> ~\/.zshrc || echo<\/span> 'export PATH=\"$PATH:$ANDROID_SDK_ROOT\/platform-tools\"'<\/span> >> ~\/.zshrc\ngrep -q 'emulator'<\/span> ~\/.zshrc || echo<\/span> 'export PATH=\"$PATH:$ANDROID_SDK_ROOT\/emulator\"'<\/span> >> ~\/.zshrc\ngrep -q 'cmdline-tools\/latest\/bin'<\/span> ~\/.zshrc || echo<\/span> 'export PATH=\"$PATH:$ANDROID_SDK_ROOT\/cmdline-tools\/latest\/bin\"'<\/span> >> ~\/.zshrc\nsource ~\/.zshrc\n\n# Accept licenses & core packages<\/span>\nmkdir -p ~\/.android && touch ~\/.android\/repositories.cfg\nyes | sdkmanager --licenses || true<\/span>\nsdkmanager \"platform-tools\"<\/span> \"emulator\"<\/span> \"cmdline-tools;latest\"<\/span> \\\n           \"platforms;android-35\"<\/span> \"build-tools;35.0.0\"<\/span> || true<\/span>\n\n# Flutter<\/span>\nbrew install --cask flutter || true<\/span>\ngrep -q 'flutter sdk-path'<\/span> ~\/.zshrc || echo<\/span> 'export PATH=\"$PATH:$(flutter sdk-path)\/bin\"'<\/span> >> ~\/.zshrc\nsource ~\/.zshrc\n\n# Final check<\/span>\nflutter doctor -v\necho<\/span> \"Done. If Android Studio is installed, add the Flutter plugin and set Flutter SDK path to: $(flutter sdk-path)\"<\/span>\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
              Run it:<\/p>\n\n\n
              chmod +x setup_flutter_android_macos.sh\n.\/setup_flutter_android_macos.sh\n<\/code><\/span><\/pre>\n\n\n
              \n\n\n\n
              12) Short checklist (what \u201cgreen\u201d looks like)<\/h2>\n\n\n\n
                \n
              • java -version<\/code> \u2192 prints Temurin\/Oracle\/OpenJDK<\/li>\n\n\n\n
              • which sdkmanager<\/code> \u2192 points to $ANDROID_SDK_ROOT\/cmdline-tools\/latest\/bin\/sdkmanager<\/code><\/li>\n\n\n\n
              • adb version<\/code> \u2192 prints version<\/li>\n\n\n\n
              • flutter --version<\/code> \u2192 prints 3.35.x<\/li>\n\n\n\n
              • flutter doctor -v<\/code> \u2192 Android toolchain \u2705<\/li>\n\n\n\n
              • Android Studio \u2192 Plugins: Flutter<\/strong> + Dart<\/strong>, Flutter SDK path set<\/li>\n\n\n\n
              • flutter create app && cd app && flutter run<\/code> \u2192 launches on emulator\/device<\/li>\n<\/ul>\n\n\n\n
                \n\n\n\n
                That\u2019s it. Save this guide and the script; next time it\u2019s a one-shot setup with predictable results.<\/p>\n\n\n\n
                <\/p>\n","protected":false},"excerpt":{"rendered":"
                It covers Android SDK, Java (JDK), Flutter, Path wiring, Plugin setup, Validation, AVD\/emulator, and creating a project\u2014plus quick fixes. Assumptions: default shell = zsh, Apple Silicon path (\/opt\/homebrew). If you\u2019re… <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"_joinchat":[],"footnotes":""},"categories":[2],"tags":[],"class_list":["post-51810","post","type-post","status-publish","format-standard","hentry","category-uncategorised"],"_links":{"self":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/51810","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/comments?post=51810"}],"version-history":[{"count":1,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/51810\/revisions"}],"predecessor-version":[{"id":51811,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/51810\/revisions\/51811"}],"wp:attachment":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/media?parent=51810"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/categories?post=51810"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/tags?post=51810"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}