如何安装 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
安装包。也可以用我打包好的安装包 链接:https://pan.baidu.com/s/1IuIzaTnzMvxbH_oO9knK9A 提取码:Z6Z8
三、安装 Android Studio 2023.1
Windows
启动安装程序:
双击下载的 .exe
文件以启动安装程序。
选择安装选项:
在欢迎界面中,点击“Next”。选择安装路径(默认路径通常为 C:Program FilesAndroidAndroid 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:gradlegradle-7.5
)。在“系统变量”部分,找到 Path
变量,点击“编辑”,添加 %GRADLE_HOME%in
。
macOS: 编辑你的 .bash_profile
、.zshrc
或 .profile
文件,添加以下内容:
export GRADLE_HOME=/opt/gradle/gradle-7.5
export PATH=$PATH:$GRADLE_HOME/bin
保存文件并执行 source ~/.bash_profile
或 source ~/.zshrc
使修改生效。
验证 Gradle 安装:
Windows:打开命令提示符,运行:
cmd
复制代码
gradle -v
macOS:打开终端,运行:
bash
复制代码
gradle -v
确认 Gradle 的版本信息正确显示,确保 Gradle 已正确安装。
配置 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/
清华大学(Tsinghua University)
URL: https://mirrors.tuna.tsinghua.edu.cn/gradle/
中科大(USTC)
URL: https://mirrors.ustc.edu.cn/gradle/
使用阿里云镜像
复制代码
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 应用。如果遇到问题,请参考官方文档或访问开发者社区寻求帮助。祝你开发顺利!