目錄

第一步

第二步

一、必須安裝的工具

二、具體安裝步驟

1. 安裝 Homebrew

切換國內源和其他配置：?

2. 安裝 node?

?3.下載watchman

?4. Ruby

5.CocoaPods

配置環境

6. jdk

7. 配置git 開發環境

第三步——啟動項目（可以忽略）

1.Xcode的問題?編輯

?編輯

2.android模擬器的問題

---

?

背景：新的 mac電腦，要配置 iOS 與 Android 的開發環境，并且我是使用 React Native 開發。

目標：可以使用 xcode 與 Android studio 去開發。

第一步

已知設備是全新的，沒有什么環境，那么我們要第一步，先去 Apple store 去下載xcode，然后去下載 Android studio，根據配置下載并安裝，默認進去安裝所有的sdk 即可。這個耗時比較久，所以放在第一步，在此期間我們可以去配置我們的其他環境

https://developer.android.com/studio?hl=zh-cn

第二步

接著整理我們需要安裝的全部工具。

一、必須安裝的工具

以下是開發 iOS 和 Android 所需的全部工具：

工具	用途	安裝方式
?Homebrew?	管理其他工具的安裝	終端運行安裝腳本
?Node.js?	運行 JavaScript 環境	brew install node??Node.js — Download Node.js?
?Watchman?	監聽文件變化，提升開發體驗	brew install watchman
?Ruby?	iOS 依賴管理（CocoaPods 需要）	macOS 自帶，或?brew install ruby
?CocoaPods?	管理 iOS 原生依賴	sudo gem install cocoapods
?JDK?	編譯 Android 代碼	brew install --cask adoptopenjdk/openjdk/adoptopenjdk11
?Android Studio?	Android 開發 IDE 和 SDK	官網下載
?Xcode?	iOS 開發 IDE 和工具鏈	App Store 下載
?NVM?	管理node的版本	brew install nvm，可以下載也可以不下載

---

首先是Homebrew，也就是brew，?? 是 macOS 上推薦安裝的包管理工具，它能幫你高效安裝和管理開發所需的依賴。這個可以在安裝 node 的時候去安裝。

二、具體安裝步驟

1. 安裝 Homebrew

Homebrew — The Missing Package Manager for macOS (or Linux)

打開執行命令即可，有可能需要輸入密碼，之后就會開始下載一系列東西，過程很長，結束后看到提示，需要去配置一下環境：推薦國內源

#官方
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"#國內源
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"   

切換國內源和其他配置：?

國內源的配置情況：

有時候下載東西的時候，homebrew會去自動檢查，有時候會漫長，所以可以在配置里禁掉：

# 方法1：設置環境變量（臨時生效）
export HOMEBREW_NO_AUTO_UPDATE=1# 方法2：寫入配置文件（永久生效）
echo 'export HOMEBREW_NO_AUTO_UPDATE=1' >> ~/.zshrc
source ~/.zshrc

---

2. 安裝 node?

Node.js — Download Node.js?

打開 node 的安裝頁面，有nvm的安裝方式，也有?brew 的安裝命令：

這里推薦使用 nvm，當然你可以選擇使用 homebrew，只是下載 node 的方式不一樣而已。

這里我下載 v20.19.2版本的，并且使用nvm下載，根據官網的配置下載后，檢查環境：

---

?3.下載watchman

因為是react native開發，所以為了監控文件系統的變化，必須下載這個。

如果電腦上之前安裝了這個，需要檢測一下gcc的版本，太低會有不兼容。

brew install watchman

使用-v 去看一下版本，如果是最近的日期，說明安裝成功：

?

---

?4. Ruby

mac 電腦自帶ruby，如果滿足需求就可以不用更新了，可以先查看自己的版本：

# 查看版本
ruby -v#我的是ruby 2.6.10p210 (2022-04-12 revision 67958) [universal.arm64e-darwin24]# 重新下載
brew install ruby

安裝成功后，會提示是否需要寫入環境變量：

If you need to have ruby first in your PATH, run:echo 'export PATH="/opt/homebrew/opt/ruby/bin:$PATH"' >> ~/.zshrc

之后關閉終端之后再查看版本信息，可以看到最新的，我這里安裝的是3.4.4

---

5.CocoaPods

這個是工作里開發iOS用的依賴管理工具，也是版本管理的工具，可以自動化流程解決第三方庫的集成問題。

一個小細節，如果啟動項目的時候，installing cocoapods。。。一直卡頓，很有可能是網絡、版本有沖突。

CocoaPods.org

下載前，先確保自己的 ruby>=2.6（Mac電腦默認的）

然后去下載：

sudo gem install cocoapods

配置環境

?安裝后如果像我這樣找不到pod，那么就需要配置一下環境?

先找一下自己的pod的安裝位置：

gem which cocoapods

然后再去看解決方案，例如我這里的是安裝位置與系統的變量的位置不一致，所以我找到位置后，更換了一下位置：

export PATH="/opt/homebrew/lib/ruby/gems/3.4.0/bin:$PATH"

---

6. jdk

下載方式：

brew install openjdk@17

下載成功，配置環境：

#驗證路徑：brew --prefix openjdk@17#安裝的時候推薦的路徑：echo 'export PATH="/opt/homebrew/opt/openjdk@17/bin:$PATH"' >> ~/.zshrc#保存source ~/.zshrc#驗證：java --version

在android studio里配置：sdk使用的gradle是homebrew 17 jdk。

7. 配置git 開發環境

mac 電腦默認的git版本較舊。

蘋果 macOS 默認預裝了 Git，但版本通常較舊?，路徑為?/usr/bin/git，與 macOS 系統工具深度集成。建議安裝新版的git，并配置一下環境，這樣系統命令行里使用的時候就是新版的git。

此外我習慣使用GitHub Desktop?，這個應用的 Git 僅用于該應用內部操作，不會影響終端中的 Git 命令。若需在終端使用 GitHub Desktop 的 Git，需將其路徑添加到環境變量。

所以為了兩個都能使用，我是會安裝一個新的版本的git,并且配置兩處的環境，使其指向一個。

Git - Downloading Package

# 安裝 git
brew install git# 將Homebrew的bin目錄添加到PATH最前面
echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc  # 若使用zsh（默認）
# 或
echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.bash_profile  # 若使用bash# 立即生效配置
source ~/.zshrc  # 或 source ~/.bash_profile# 驗證路徑是否更新
which git  # 應顯示 /opt/homebrew/bin/git
git --version  # 確認版本為2.49.0或者其他版本

?安裝成功后，在github desktop 里面可以去登錄，也可以不登錄，跳過這一步，然后設置名字和郵箱，注意，郵箱設置為自己的托管地址的郵箱，然后配置ssh，就可以正常使用了！

可以使用這個方式去查看自己的郵箱與名字，?

git config --global user.email
git config --global user.name

也可以在這里設置自己的名字與郵箱：?

第三步——啟動項目（可以忽略）

一般先是clone項目，然后啟動項目，再打開模擬器，就可以正常開發了。

但是如果第一次啟動的時候遇到這些問題：

1.Xcode的問題

這個是系統當前配置的開發者工具路徑指向了 ??Command Line Tools??（命令行工具），而非完整的 ??Xcode 開發環境??，需要修改指向位置：

sudo xcode-select -s /Applications/Xcode.app/Contents/Developerxcode-select --print-path  # 應輸出 `/Applications/Xcode.app/Contents/Developer`#驗證版本xcodebuild -version

2.沒有模擬器

Starting Metro Bundler
CommandError: No iOS devices available in Simulator.app

如何新建模擬器：

2.android模擬器的問題

如果第一次啟動項目出現android模擬器沒有找到的問題，先去android studio查一下是否有下載sdk，如果下載了，那么檢查一下系統內安裝了哪些模擬器：

adb version          # 檢查 ADB
emulator -list-avds  # 列出模擬器
sdkmanager --list    # 查看可安裝的 SDK 組件

?正常情況下，執行第一個就可以看到：

Android Debug Bridge version 1.0.41

Version 35.0.2-12147458

Installed as /Users/admin/Library/Android/sdk/platform-tools/adb

Running on Darwin 24.5.0 (arm64)

command not found: adb? ?如果出現這個問題，代表沒有被識別，是否是沒有配置環境變量？自查

配置環境變量：

#進入配置文件
nano ~/.zshrc#添加下面的配置，去掉注釋export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/emulator          # 模擬器
export PATH=$PATH:$ANDROID_HOME/platform-tools    # adb/fastboot
export PATH=$PATH:$ANDROID_HOME/tools             # 舊版工具
export PATH=$PATH:$ANDROID_HOME/tools/bin         # sdkmanager
export PATH=$PATH:$ANDROID_HOME/build-tools/<版本號>  # 如 34.0.0（可選）#退出保存并執行
source ~/.zshrc

?

?