ubuntu如何永久配置android开发环境变量？

在Ubuntu系统中搭建Android开发环境，配置正确的环境变量是至关重要的一步，这不仅能让您在系统的任何位置直接调用adb、fastboot等开发工具，也是许多IDE（如Android Studio）正常工作的前提，下面，我们将详细介绍如何在Ubuntu上配置Android环境变量，整个过程清晰明了,适合不同水平的用户。

第一步：准备工作与文件定位

在开始配置之前，请确保您已经在系统上下载并解压了Android SDK，如果您通过Android Studio进行安装，SDK会默认位于用户主目录下的Android/Sdk文件夹中，如果是从官网单独下载的命令行工具包，您可能将其解压到了自定义位置，例如~/android-sdk。

无论SDK位于何处，您都需要明确几个关键目录的路径,这些是后续配置的核心：

1. SDK根目录：这是Android SDK的安装主目录。

   • /home/your_username/Android/Sdk

2. platform-tools：这个目录包含了最常用的调试工具，如adb（Android Debug Bridge）和fastboot。

   • /home/your_username/Android/Sdk/platform-tools

3. cmdline-tools：这个目录包含了SDK管理器（sdkmanager）等命令行工具，注意，其路径可能包含版本号，通常建议使用latest指向最新版本。

   • /home/your_username/Android/Sdk/cmdline-tools/latest/bin

请将上述路径中的your_username替换为您自己的用户名，并根据您的实际安装路径进行调整,确认这些路径存在是成功配置的基础。

第二步：选择配置方式（临时与永久）

环境变量的配置分为两种：临时配置和永久配置。

• 临时配置：只在当前打开的终端窗口中有效，关闭窗口后，配置即失效,这种方式适合快速测试。
• 永久配置：将配置写入shell的配置文件中，每次打开新的终端时都会自动加载,这是推荐的做法。

临时配置示例

在终端中直接执行以下命令即可（请务必替换为您的实际路径）：

export ANDROID_SDK_ROOT=$HOME/Android/Sdk
export PATH=$PATH:$ANDROID_SDK_ROOT/platform-tools
export PATH=$PATH:$ANDROID_SDK_ROOT/cmdline-tools/latest/bin

执行后，您可以在同一终端窗口内立即使用adb等命令。

永久配置（推荐）

永久配置需要修改您当前使用的Shell的配置文件，Ubuntu默认使用Bash Shell，其配置文件为~/.bashrc，如果您使用的是Zsh Shell，则配置文件为~/.zshrc，您可以通过echo $SHELL命令来确认当前使用的Shell。

1. 打开配置文件
   使用您喜欢的文本编辑器（如nano或vim）打开配置文件，这里以nano和.bashrc为例：

   nano ~/.bashrc

2. 添加环境变量
   在文件的末尾，添加以下内容，同样，请确保路径正确无误，我们同时设置ANDROID_SDK_ROOT（官方推荐）和ANDROID_HOME（为了兼容旧版工具）。

   # Android SDK Environment Variables
   export ANDROID_SDK_ROOT=$HOME/Android/Sdk
   export ANDROID_HOME=$ANDROID_SDK_ROOT
   export PATH=$PATH:$ANDROID_SDK_ROOT/platform-tools
   export PATH=$PATH:$ANDROID_SDK_ROOT/cmdline-tools/latest/bin

   使用$HOME变量代替绝对路径（如/home/your_username）具有更好的可移植性。

3. 保存并使配置生效
   在nano中，按Ctrl + X，然后按Y确认保存，最后按Enter退出。
   最重要的一步是，让配置文件修改立即生效,您可以执行以下命令：

   source ~/.bashrc

   或者，更简单的方法是关闭当前终端,然后重新打开一个新的终端窗口。

第三步：验证配置是否成功

配置完成后，验证是必不可少的环节，打开一个新的终端窗口（确保已source或重启终端）,依次执行以下命令：

• echo $ANDROID_SDK_ROOT：应输出您设置的SDK根目录路径。
• adb version：如果配置成功，将显示Android Debug Bridge的版本信息，而不是“command not found”。
• sdkmanager --list：如果配置成功，将列出所有可下载的Android SDK组件列表。

如果以上命令都能得到预期的输出，那么恭喜您,Android环境变量已经成功配置！

相关问答FAQs

问题1：我已经按照步骤配置了，但在新终端中输入 adb 命令时，还是提示 ‘command not found’，为什么？

解答： 这个问题通常由以下几个原因导致：

1. 未执行source或未重启终端：修改.bashrc或.zshrc后，必须执行source ~/.bashrc命令或完全关闭并重新打开终端,新的环境变量才会被加载。
2. 路径错误：请仔细检查您在配置文件中填写的路径是否真实存在，可以使用ls /path/to/your/sdk/platform-tools这样的命令来验证目录是否存在且包含adb文件。
3. 修改了错误的配置文件：您可能修改了.bashrc，但您的系统默认Shell是Zsh，因此应该修改.zshrc，使用echo $SHELL确认您的Shell类型。
4. 语法错误：检查配置文件中添加的代码是否存在拼写错误（如export拼错）或缺少空格等语法问题。

问题2：ANDROID_HOME 和 ANDROID_SDK_ROOT 有什么区别？我应该用哪一个？

解答：ANDROID_HOME是过去广泛使用的环境变量名，用于指向Android SDK的根目录，从较新的版本开始，Google官方推荐使用ANDROID_SDK_ROOT作为新的标准变量名，以更清晰地表达其含义。
许多新的开发工具（如Android Studio）和构建脚本优先识别ANDROID_SDK_ROOT，一些第三方工具或较老的项目可能仍然依赖于ANDROID_HOME。
最佳实践是：为了确保最大的兼容性，建议同时设置这两个变量，并让它们指向同一个SDK目录，如上文示例所示，这样既能满足新工具的要求,也能兼容旧工具。