Android Studio 在 macOS 上的完整安装与使用指南

独隅

已于 2025-04-15 16:22:54 修改

阅读量1.1k

点赞数 8

于 2025-04-13 19:06:39 首次发布

本文链接：https://blog.csdn.net/qq_45657541/article/details/147171983

版权

Android Studio 专栏收录该内容

6 篇文章

订阅专栏

在这里插入图片描述

一、Android Studio 简介

Android Studio 是 Google 官方推出的集成开发环境（IDE），专为 Android 应用开发设计。它基于 JetBrains 的 IntelliJ IDEA，提供代码编辑、调试、性能分析、模拟器等全套工具，支持 macOS、Windows 和 Linux。

二、下载与安装

1. 下载 Android Studio

• 官网地址：https://developer.android.com/studio
• 选择 macOS 版本：点击 Download Android Studio → 选择 macOS → 下载 .dmg 文件（约 1GB）。
• 注意：若使用 Apple Silicon（M1/M2/M3 芯片），需选择 Intel 版本（需通过 Rosetta 2 运行）或 Apple Silicon 原生版本（若可用）。

2. 安装前的依赖准备

• 安装 Homebrew（推荐，用于管理依赖）：

 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

• 安装 JDK：
• Android Studio 2022+ 要求 JDK 17：

   brew install openjdk@17

• 设置环境变量 JAVA_HOME：

 echo 'export JAVA_HOME=$(/usr/libexec/java_home -v 17)' >> ~/.zshrc
 source ~/.zshrc

3. 安装步骤

挂载安装包：双击下载的 .dmg 文件，将 Android Studio.app 拖拽到 Applications 文件夹。
首次启动配置：
• 打开 Applications 文件夹，双击运行 Android Studio.app。
• 首次启动时，按提示安装 Android Command Line Tools 和 Android SDK。
• 选择 UI 主题（Darcula 或 IntelliJ）。
完成安装：点击 Finish 退出向导。

三、基础使用指南

1. 创建第一个项目

点击 Start a new Android Studio project。
选择项目模板（如 Empty Activity）。
配置项目名称、包名、保存路径和目标 SDK（建议选择最新稳定版，如 API Level 34）。
点击 Finish，等待 Gradle 构建完成。

2. 运行应用

• 使用模拟器：

点击工具栏中的 AVD Manager 图标（🖥️）。
创建新的虚拟设备（AVD），选择设备型号（如 Pixel 6）和系统镜像（建议选择 API Level 34）。
启动 AVD，返回 IDE 点击运行按钮（▶️）。
• 连接真实设备：
• 启用开发者选项中的 USB 调试（进入设置 > 关于手机 > 软件信息，连续点击版本号 7 次）。
• 通过 USB 连接手机，授权电脑访问。
• 在运行配置中选择连接的设备。

3. 核心功能

• 代码编辑：智能补全、代码重构、实时错误提示。
• 布局设计：通过 Layout Editor 拖拽 UI 组件。
• 调试工具：断点、日志（Logcat）、内存分析器（Profiler）。

四、进阶功能配置

1. 配置 SDK 和工具

• SDK Manager（工具栏图标 🛠️）：
• 添加或更新 SDK 平台（如 Android 14.0）。
• 安装系统镜像（用于模拟器）。
• 下载命令行工具（如 adb、fastboot）。

2. 自定义主题与插件

• 更换主题：
Android Studio > Preferences > Appearance & Behavior > Appearance → 选择主题。
• 安装插件：
Android Studio > Preferences > Plugins → 搜索插件（如 Material Theme UI、ADB Idea）→ 点击 Install。

3. Gradle 配置优化

• 修改 build.gradle 文件：调整编译版本、依赖库和构建类型。
• 启用并行构建：在 gradle.properties 中添加：

org.gradle.parallel=true
org.gradle.daemon=true

4. 快捷键速查

• Cmd + N：搜索类。
• Cmd + Shift + N：搜索文件。
• Cmd + B：跳转到声明。
• Shift + F6：重命名变量/方法。
• Option + Enter：快速修复代码问题。

五、常见问题与解决方法

1. 安装失败或启动崩溃

• 问题：启动时提示 No JDK found。
解决：确保已安装 JDK 17 并正确设置 JAVA_HOME 环境变量。
• 问题：安装过程中提示权限错误。
解决：右键 .dmg 文件 → 打开 → 手动允许安装（系统安全设置）。

2. 模拟器无法启动

• 问题：AVD 启动报错 Failed to allocate memory。
解决：
• 编辑 AVD 配置，降低 RAM 和存储分配（建议 ≤ 2048MB）。
• 启用 Cold Boot 替代快速启动。
• 安装 Intel HAXM：
bash brew install --cask android-platform-tools sdkmanager --install "Intel x86 Emulator Accelerator (HAXM Installer)"

3. Gradle 构建缓慢

• 问题：构建时间过长。
解决：
• 启用离线模式（Android Studio > Preferences > Build, Execution, Deployment > Build Tools > Gradle）。
• 使用国内镜像（修改项目根目录的 build.gradle）：
groovy repositories { maven { url 'https://maven.aliyun.com/repository/public' } google() mavenCentral() }

4. ADB 连接问题

• 问题：设备未识别或 adb devices 无响应。
解决：
• 重启 ADB 服务：
bash adb kill-server && adb start-server
• 检查 USB 调试授权弹窗（设备端）。

六、卸载 Android Studio

1. 删除安装目录

rm -rf /Applications/Android\ Studio.app

2. 清理残留文件

# 删除用户配置和缓存
rm -rf ~/Library/Application\ Support/Google/AndroidStudio*
rm -rf ~/Library/Caches/AndroidStudio*
rm -rf ~/.android
rm -rf ~/.gradle

七、高级技巧与工具

1. 使用命令行工具

• ADB 常用命令：

adb install app-debug.apk      # 安装 APK
adb logcat                     # 查看实时日志
adb shell pm list packages     # 列出已安装包

• 通过 studio.sh 启动脚本：可添加到 PATH 或创建桌面快捷方式。

2. 性能优化

• 增加 IDE 内存：编辑 studio.vmoptions（位于 ~/Library/Application Support/Google/AndroidStudio2023.2/studio.vmoptions）：

-Xms1024m
-Xmx4096m
-XX:ReservedCodeCacheSize=512m

3. 版本控制集成

• Git 集成：
Android Studio > Preferences > Version Control > Git → 配置 Git 路径。
• GitHub 插件：安装 GitHub Integration 插件，直接推送代码。

4. 自定义模板

• 创建 Live Template：
Android Studio > Preferences > Editor > Live Templates → 添加自定义代码片段（如日志打印）。

八、故障排查工具

1. 查看日志

• IDE 日志：Help > Show Log in Finder（路径：~/Library/Logs/AndroidStudio2023.2/）。
• Gradle 日志：在终端运行 ./gradlew build --info。

2. 重置配置

• 删除 ~/Library/Application Support/Google/AndroidStudio2023.2/config 目录，恢复默认设置。

3. 社区支持

• 官方文档：Android Developers
• 社区论坛：Stack Overflow
• GitHub Issues：Android Studio Issues

九、资源与官方链接

下载页面：Android Studio for macOS
SDK 管理器：Android SDK 参考
官方教程：Build Your First App

通过以上步骤，您可以在 macOS 上高效使用 Android Studio 进行 Android 应用开发。建议定期更新 SDK 和依赖库，并利用版本控制工具管理代码。