[山东大学软件学院项目实训个人博客1]Android Studio 踩坑指南

最近用React Native搞项目的时候，发现npx react-native run-android命令经常卡住不动，或者出现Gradle下载慢，adb找不到设备或者SDK路径报错的情况。折腾了好久终于搞定，这里把配置经验分享给大家。

一、安装Android Studio的正确姿势

1. 安装注意事项

操作步骤：

1. 先去官网（https://developer.android.com/studio）下最新版，现在2024年建议用Giraffe 2022.3.1或更高版本。
2. 安装时这几个组件一定要勾上：
   • Android SDK
   • Android Virtual Device（想用模拟器就得装）
   • Android Emulator（官方模拟器）
   • Intel HAXM（AMD/Intel的CPU加速神器）

检查是否装好了：

# 试试adb命令能不能用  
adb devices  
# 如果没连设备应该显示这样：  
# List of devices attached  
# （这里空着但是不报错就对了）  

二、SDK配置要点

1. 必须装的SDK组件

打开SDK Manager（路径：Android Studio → Tools → SDK Manager），这几个一定要装：

2. 配置环境变量

Windows用户看这里：

1. 新建系统变量：

   • ANDROID_HOME = C:\Users\你的用户名\AppData\Local\Android\Sdk
   • JAVA_HOME = C:\Program Files\Java\jdk-17.0.10
     

2. 编辑Path变量，加上这些：

   %ANDROID_HOME%\platform-tools  
   %ANDROID_HOME%\emulator  
   %ANDROID_HOME%\tools  
   %JAVA_HOME%\bin  
   

三、解决Gradle慢的问题

1. 换国内镜像源

改项目里的android/build.gradle文件：

buildscript {  
    repositories {  
        // 换成阿里云的源  
        maven { url 'https://maven.aliyun.com/repository/google' }  
        maven { url 'https://maven.aliyun.com/repository/public' }  
        maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }  
    }  
}  

allprojects {  
    repositories {  
        maven { url 'https://maven.aliyun.com/repository/google' }  
        maven { url 'https://maven.aliyun.com/repository/public' }  
        mavenLocal()  
        mavenCentral()  
    }  
}  

2. 手动下载Gradle

遇到Could not install Gradle distribution报错时：

1. 去Gradle官网（https://services.gradle.org/distributions/）下对应版本的zip包（比如gradle-8.13-bin.zip）。
2. 扔到这个目录下：
   • Windows：C:\Users\你的用户名\.gradle\wrapper\dists\gradle-8.13-bin\一堆随机字符的文件夹
   • macOS/Linux：~/.gradle/wrapper/dists/gradle-8.13-bin/随机字符文件夹

五、常见问题急救手册