如何安装 Android Studio 2023.1 和配置 Gradle:Windows 和 macOS 系统详细指南
一、系统要求
Windows
- 操作系统:Windows 10/11(64 位)
- 处理器:Intel Core i5 或更高
- 内存:8 GB RAM(建议 16 GB)
- 存储:至少 4 GB 的可用磁盘空间(推荐使用 SSD)
macOS
- 操作系统:macOS 10.15(Catalina)或更高版本
- 处理器:Intel Core i5 或 Apple M1 芯片
- 内存:8 GB RAM(建议 16 GB)
- 存储:至少 4 GB 的可用磁盘空间(推荐使用 SSD)
二、下载 Android Studio 2023.1(记住这个版本的jdk只能是17或17以上的,就好比汽车的轮子自行车用不了一样)
-
访问官网: 打开浏览器,前往 Android Studio 下载页面。
-
选择下载版本:
- Windows:点击“Download Android Studio”按钮,下载
.exe
安装文件。 - macOS:点击“Download Android Studio”按钮,下载
.dmg
安装包。
- Windows:点击“Download Android Studio”按钮,下载
- 也可以用我打包好的安装包 链接:https://pan.baidu.com/s/1IuIzaTnzMvxbH_oO9knK9A 提取码:Z6Z8
三、安装 Android Studio 2023.1
Windows
-
启动安装程序:
- 双击下载的
.exe
文件以启动安装程序。
- 双击下载的
-
选择安装选项:
- 在欢迎界面中,点击“Next”。
- 选择安装路径(默认路径通常为
C:\Program Files\Android\Android Studio
),点击“Next”。 - 选择要安装的组件。建议保留默认选项,包括 Android Studio、Android SDK、Android SDK Platform-Tools 和 Android SDK Build-Tools,点击“Next”。
- 选择是否创建桌面快捷方式,点击“Next”。
-
开始安装:
- 点击“Install”开始安装过程。
- 等待安装完成后,点击“Finish”以启动 Android Studio。
-
首次启动向导:
- 启动 Android Studio 后,会弹出欢迎界面。选择“Do not import previous settings”,点击“OK”。
- 选择“Standard”安装类型,点击“Next”。
- 选择要安装的 SDK 组件,点击“Next”。
- 点击“Finish”开始下载和安装 SDK 组件及虚拟设备。
macOS
-
打开
.dmg
文件:- 双击下载的
.dmg
文件以打开。
- 双击下载的
-
拖动到应用程序文件夹:
- 将 Android Studio 图标拖动到“应用程序”文件夹中。
-
启动 Android Studio:
- 打开“应用程序”文件夹,找到 Android Studio 图标并双击启动。
-
首次启动向导:
- 启动 Android Studio 后,选择“Do not import previous settings”,点击“OK”。
- 选择“Standard”安装类型,点击“Next”。
- 选择要安装的 SDK 组件,点击“Next”。
- 点击“Finish”开始下载和安装 SDK 组件及虚拟设备。
四、配置 Android Studio 和 Gradle
1. 配置 Android Studio
-
打开项目: 启动 Android Studio 后,点击“Open”以打开现有项目,或选择“New Project”以创建新项目。
-
SDK可以在系统里面去下载也可以直接下载资源链接:https://pan.baidu.com/s/1jC7xiGEmBgenFulUGeFNjQ
提取码:Z6Z8 -
配置 SDK:(注意:SDK安装路径不能有中文 不然安装不成功,最好是自己创建一个文件夹)
- 在“SDK Location”中查看和设置 Android SDK 的路径。
- 在“SDK Platforms”中确保安装了最新版本的 Android SDK 平台。
- 在“SDK Tools”中确保安装了 Android SDK Build-Tools 和 Android Emulator。
- 选择“File” > “Project Structure”。
-
创建虚拟设备:
- 点击工具栏上的“AVD Manager”图标(或选择“Tools” > “AVD Manager”)。
- 点击“Create Virtual Device”,选择设备型号和系统版本,点击“Next”。
- 配置虚拟设备的详细信息,点击“Finish”创建虚拟设备。
2. 配置 Gradle
Gradle 是 Android Studio 的构建系统,默认情况下会自动下载并配置所需版本。如果需要手动管理或更新 Gradle,可以按照以下步骤进行:
这是下载好的安装包
链接:https://pan.baidu.com/s/1h8ygr9W_BcLDkJaV4ax7pQ
提取码:Z6Z8
下载完将原先的gradle里面的文件复制替换
通过 Android Studio 配置 Gradle
-
检查 Gradle 版本:
- 在 Android Studio 中,选择“File” > “Project Structure”。
- 在左侧菜单中选择“Project”。
- 在“Gradle Version”字段中查看当前使用的 Gradle 版本。如果需要,可以从下拉菜单中选择合适的版本。
-
同步项目:
- 在 Android Studio 工具栏中点击“Sync Project with Gradle Files”按钮,以确保 Gradle 配置生效。
手动下载和配置 Gradle
-
下载 Gradle:
- 前往 Gradle 发行版页面。
- 下载所需版本的 Gradle 压缩包(
.zip
)。
-
解压 Gradle:
-
Windows:
- 打开文件资源管理器,找到下载的
.zip
文件。 - 右键点击
.zip
文件,选择“解压到指定文件夹”。 - 将其解压到你选择的目录,例如
C:\gradle
。
- 打开文件资源管理器,找到下载的
-
macOS:
- 打开终端,导航到下载目录,解压
.zip
文件:unzip gradle-7.5-bin.zip -d /opt/gradle
- 打开终端,导航到下载目录,解压
-
-
配置环境变量:
-
Windows:
- 右键点击“此电脑” > “属性” > “高级系统设置” > “环境变量”。
- 点击“新建”来创建一个新的系统变量
GRADLE_HOME
,值为 Gradle 解压目录(例如C:\gradle\gradle-7.5
)。 - 在“系统变量”部分,找到
Path
变量,点击“编辑”,添加%GRADLE_HOME%\bin
。
-
macOS: 编辑你的
export GRADLE_HOME=/opt/gradle/gradle-7.5.bash_profile
、.zshrc
或.profile
文件,添加以下内容:
export PATH=$PATH:$GRADLE_HOME/bin- 保存文件并执行
source ~/.bash_profile
或source ~/.zshrc
使修改生效。
- 保存文件并执行
-
-
验证 Gradle 安装:
- Windows:打开命令提示符,运行: cmd
复制代码
gradle -v
- macOS:打开终端,运行: bash
复制代码
gradle -v
- 确认 Gradle 的版本信息正确显示,确保 Gradle 已正确安装。
- Windows:打开命令提示符,运行: cmd
配置 Gradle Wrapper
Gradle Wrapper 是一种确保项目使用一致 Gradle 版本的工具。
-
编辑
gradle-wrapper.properties
文件:- 文件位置:
<项目根目录>/gradle/wrapper/gradle-wrapper.properties
。
- 文件位置:
-
设置 Gradle 版本:
- 修改
distributionUrl
,指定所需的 Gradle 版本。例如:复制代码
distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip
- 修改
-
同步项目:
- 在 Android Studio 中点击“Sync Project with Gradle Files”按钮,确保 Gradle Wrapper 配置生效。
五、常见问题解答
Q1: Gradle 下载失败怎么办?
- 检查网络连接:确保网络连接稳定,且没有防火墙或代理阻止 Gradle 下载。
- 重新同步:在 Android Studio 中点击“Sync Project with Gradle Files”重新同步项目。
- 使用离线模式:在 Gradle 设置中启用离线模式(在
gradle.properties
文件中设置org.gradle.daemon=true
)。
Q2: Gradle 版本不兼容怎么办?
- 确保一致性:在
gradle-wrapper.properties
文件和build.gradle
文件中使用一致的 Gradle 版本。 - 更新配置:修改
gradle-wrapper.properties
文件中的 Gradle 版本,确保与项目要求匹配。
Q3: Gradle 性能问题如何优化?
2. 修改 gradle-wrapper.properties
在你的 Android 项目的 gradle/wrapper/gradle-wrapper.properties
文件中,修改 distributionUrl
为相应的国内镜像地址。例如:
Q2: 如何验证镜像是否可用?
Q3: 配置国内镜像后 Gradle 下载仍然失败怎么办?
3. 更新 Gradle Wrapper
修改 gradle-wrapper.properties
文件后,需要让 Gradle Wrapper 重新下载新的 Gradle 版本。可以在 Android Studio 中点击“Sync Project with Gradle Files”按钮,或在命令行中运行以下命令:
复制代码
./gradlew wrapper --gradle-version 7.5
确保在 gradle-wrapper.properties
文件中使用的 Gradle 版本与你实际需要的版本一致。
七、常见问题解答
Q1: 为什么需要使用国内镜像?
- 增加内存分配:编辑
gradle.properties
文件,增加最大堆内存设置:复制代码
org.gradle.jvmargs=-Xmx2048m
- 启用并行构建:
复制代码
org.gradle.parallel=true
六、配置国内 Gradle 镜像
1. 查找国内 Gradle 镜像
以下是几个常用的国内 Gradle 镜像地址,你可以根据需要选择合适的镜像源:
- 阿里云(Aliyun)
- URL:
https://maven.aliyun.com/nexus/content/groups/public/gradle/
- URL:
- 清华大学(Tsinghua University)
- URL:
https://mirrors.tuna.tsinghua.edu.cn/gradle/
- URL:
- 中科大(USTC)
- URL:
https://mirrors.ustc.edu.cn/gradle/
- URL:
-
使用阿里云镜像
复制代码
distributionUrl=https\://maven.aliyun.com/nexus/content/groups/public/gradle/gradle-7.5-bin.zip
-
使用清华大学镜像
复制代码
distributionUrl=https\://mirrors.tuna.tsinghua.edu.cn/gradle/gradle-7.5-bin.zip
-
使用中科大镜像
复制代码
distributionUrl=https\://mirrors.ustc.edu.cn/gradle/gradle-7.5-bin.zip
- 提高下载速度:国内镜像源一般会提供更快的下载速度和更稳定的网络连接。
- 减少网络延迟:访问国内服务器可以减少由于跨国网络传输带来的延迟和不稳定性。
- 测试下载链接:尝试在浏览器中打开镜像 URL,确认能够下载到正确的 Gradle 压缩包。
- 检查 Gradle 版本:在 Android Studio 中运行项目,确保 Gradle Wrapper 能够成功下载并使用指定版本的 Gradle。
- 检查 URL 配置:确认
gradle-wrapper.properties
中的distributionUrl
配置正确。 - 检查网络设置:确认你的网络连接正常,且没有防火墙或代理设置阻碍下载。
- 切换镜像源:尝试使用其他国内镜像源,或者返回使用官方镜像。
总结
通过本教程,你已经完成了 Android Studio 2023.1 的安装,并成功配置了 Gradle。确保 Gradle 配置正确可以帮助你更顺利地开发和构建 Android 应用。如果遇到问题,请参考官方文档或访问开发者社区寻求帮助。祝你开发顺利!