macOS 下快速配置 Android NDK 開發環境完整指南

前言

在 macOS 上進行 Android NDK 開發，首要任務是正確配置環境變數，讓終端機能識別 ndk-build、adb 等工具指令。本文整理出最精簡、可驗證的配置步驟。

配置步驟

1. 編輯 Shell 設定檔

啟動「終端機」，輸入以下指令編輯 .bash_profile（若使用 zsh 請改編輯 .zshrc）：

pico ~/.bash_profile

2. 加入環境變數匯出語句

將下列內容貼上，**路徑請依實際安裝位置修改**：

export ANDROID_SDK_ROOT=/Users/你的用戶名/Desktop/adt-bundle/sdk
export ANDROID_NDK_ROOT=/Users/你的用戶名/Documents/Android/android-ndk-r8e
export PATH=$PATH:$ANDROID_SDK_ROOT
export PATH=$PATH:$ANDROID_NDK_ROOT
export ANDROID_TOOL=$ANDROID_SDK_ROOT/platform-tools
export PATH=$PATH:$ANDROID_TOOL

關鍵提醒： 路徑中**不可包含空格**，否則會導致指令解析失敗。

3. 存檔並生效

• 按 Ctrl+X 離開編輯器
• 輸入 Y 確認儲存
• 按 Enter 確認檔名
• 關閉終端機視窗，**重新開啟** 終端機

4. 驗證配置是否成功

重新開啟終端機後：

• 若出現 -bash: export: command not found 等錯誤，表示語法有誤（常見為拼寫錯誤如 PAHT 應為 PATH），請回頭檢查。
• 若無錯誤提示，輸入 ndk-build 若顯示用法說明，即代表 NDK 路徑已生效。

5. 實際編譯測試

cd /你的專案路徑/jni
ndk-build

若編譯通過輸出 .so 檔案，環境配置完成。

常見問題排查

進階建議

• 使用 android-sdk-macosx 官方壓縮包而非 ADT Bundle，結構更清晰。
• 將 platform-tools、tools 同時加入 PATH，方便直接呼叫 adb、android 指令。
• 考慮使用 NDK 官方下載頁 獲取最新穩定版。

總結

macOS 配置 NDK 核心在於正確設定 ANDROID_NDK_ROOT 並加入 PATH，配合 ANDROID_SDK_ROOT 即可滿足大多數原生開發需求。養成「改完設定檔必重啟終端機」的習慣，能避免 90% 的環境變數不生效問題。