指南 | 在 macOS 上快速配置 adb 环境:从零到调试 | Mac
1. 为什么需要在Mac上配置adb环境如果你是一名Android开发者或者偶尔需要在Mac电脑上调试Android设备那么adbAndroid Debug Bridge绝对是你离不开的工具。adb就像一座桥梁连接着你的Mac和Android设备让你能够直接在电脑上执行安装应用、查看日志、传输文件等操作。我刚开始接触Android开发时最头疼的就是adb环境配置。明明按照教程一步步操作却总是遇到各种报错。后来才发现问题往往出在环境变量配置和工具版本兼容性上。特别是对于Mac用户来说和Windows的配置过程还有些不同需要特别注意路径和权限问题。2. 准备工作安装Homebrew2.1 为什么要用HomebrewHomebrew是Mac上最受欢迎的包管理工具相当于Linux的apt-get或yum。它能帮你自动处理软件依赖关系一键安装各种开发工具。使用Homebrew安装adb最大的好处就是简单——不需要手动下载、解压、配置环境变量一条命令就能搞定所有事情。不过要注意的是国内用户直接使用官方源可能会很慢。我在实际使用中就经常遇到下载超时的情况这时候就需要切换到国内镜像源。2.2 安装Homebrew的两种方式对于国内用户我强烈推荐使用国内镜像源安装。下面这个脚本会自动配置国内源速度会快很多/bin/zsh -c $(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)如果你更倾向于使用官方源或者需要最新版本可以使用这个命令/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)安装完成后建议运行以下命令检查是否安装成功brew --version如果看到版本号输出说明安装成功了。我建议每次使用Homebrew前先更新一下brew update3. 安装adb工具3.1 使用Homebrew安装platform-tools安装好Homebrew后安装adb就非常简单了。只需要执行brew install android-platform-tools这里有个小坑需要注意新版本的Homebrew已经移除了--cask参数如果你看到教程里带有这个参数直接去掉就行。我在帮同事配置时就遇到过这个问题加上--cask反而会报错。安装完成后可以通过以下命令验证是否安装成功adb --version如果看到类似这样的输出就说明安装成功了Android Debug Bridge version 1.0.41 Version 31.0.3-75621333.2 手动安装方法备用方案有时候因为网络问题Homebrew安装可能会失败。这时候可以尝试手动安装首先删除可能存在的旧版本rm -rf ~/.android-sdk-macosx/从官网下载platform-tools 访问 https://developer.android.com/studio/releases/platform-tools 下载最新版的zip包解压并移动到指定目录unzip platform-tools-latest*.zip mkdir -p ~/.android-sdk-macosx mv platform-tools/ ~/.android-sdk-macosx/platform-tools4. 配置环境变量4.1 为什么需要配置环境变量安装完adb后你可能会遇到一个常见问题在终端输入adb命令时系统提示command not found。这是因为系统不知道去哪里找adb这个程序。环境变量PATH就是告诉系统在哪里查找可执行文件的。4.2 配置步骤对于使用bash的用户Mac默认shellecho export PATH$PATH:~/.android-sdk-macosx/platform-tools/ ~/.bash_profile source ~/.bash_profile如果你使用的是zshMacOS Catalina及以后版本的默认shellecho export PATH$PATH:~/.android-sdk-macosx/platform-tools/ ~/.zshrc source ~/.zshrc这里有个实用技巧你可以通过以下命令查看当前使用的shellecho $SHELL4.3 验证配置是否成功配置完成后新开一个终端窗口再次运行adb --version如果能看到版本信息说明环境变量配置成功了。如果还是不行可能是路径不对。你可以先用find命令查找adb的实际安装位置find /usr/local -name adb然后根据实际路径修改环境变量配置。5. 连接Android设备调试5.1 启用USB调试要让adb识别你的Android设备首先需要在设备上启用USB调试模式进入设置 关于手机连续点击版本号7次开启开发者模式返回设置进入开发者选项启用USB调试5.2 连接设备用USB线连接手机和Mac然后在终端运行adb devices你应该能看到类似这样的输出List of devices attached 1234567890abcdef device如果看到的是unauthorized需要在手机上弹出的授权对话框中点击允许。5.3 常见连接问题解决我在实际使用中遇到过几个典型问题设备不显示尝试更换USB线或USB接口有些线只能充电不能传输数据无权限运行以下命令查看设备权限lsusb然后根据设备ID创建规则文件echo SUBSYSTEMusb, ATTR{idVendor}你的设备厂商ID, MODE0666 | sudo tee /etc/udev/rules.d/51-android.rules sudo chmod ar /etc/udev/rules.d/51-android.rules还是无法连接尝试重启adb服务adb kill-server adb start-server6. 常用adb命令配置好环境后adb就能大显身手了。下面是一些我最常用的命令安装APKadb install app-debug.apk查看设备日志adb logcat进入设备shelladb shell从设备拉取文件adb pull /sdcard/DCIM/Camera/IMG.jpg ~/Downloads/向设备推送文件adb push ~/Documents/test.txt /sdcard/查看已安装应用列表adb shell pm list packages卸载应用adb uninstall com.example.app7. 进阶技巧与工具推荐7.1 无线调试除了USB连接adb还支持无线连接。首先用USB线连接设备然后adb tcpip 5555 adb connect 设备IP:5555之后就可以拔掉USB线了。我在办公室就经常这样用可以同时连接多台设备桌面也更整洁。7.2 图形化工具如果你不习惯命令行可以试试这些图形化工具Android Studio内置的Device File Explorerscrcpy通过adb投屏并控制Android设备ADB GUI简单的图形界面7.3 多设备管理当连接多个设备时需要在命令中指定设备序列号adb -s 设备序列号 shell或者使用设备IP地址adb -s 192.168.1.100:5555 install app.apk8. 保持adb环境更新Android平台工具会定期更新建议每隔一段时间检查更新brew outdated android-platform-tools brew upgrade android-platform-tools或者手动下载最新版的platform-tools包替换旧版本。