新手使用Android Studio创建首个项目遇报错如何解决
Android Studio 首次创建项目报错修复方法
按以下步骤顺序操作,可解决90%以上Android Studio首次创建项目的报错问题:
- 校验核心SDK组件安装状态
依次打开顶部菜单栏File > Settings > Appearance & Behavior > System Settings > Android SDK,在SDK Platforms栏确认当前项目所选API等级的SDK完整安装;在SDK Tools栏确认Android SDK Build-Tools、Android SDK Platform-Tools两项核心组件已安装,缺失组件勾选后点击Apply等待安装完成,重启Android Studio后重试。 - 替换国内镜像源解决依赖拉取失败
首次创建项目默认从境外源拉取Gradle插件、项目依赖,网络连通性差是最高发的报错原因。找到项目根目录下的settings.gradle文件(Android Studio新版本配置路径,老版本对应根目录下build.gradle文件),将仓库配置段替换为国内公共镜像源配置,保存后点击顶部工具栏的Gradle同步按钮(大象图标)重新同步即可。
对应配置代码参考:pluginManagement { 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' } google() mavenCentral() gradlePluginPortal() } } dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { maven { url 'https://maven.aliyun.com/repository/google' } maven { url 'https://maven.aliyun.com/repository/public' } google() mavenCentral() } } - 校验Gradle JDK版本匹配
依次打开File > Settings > Build, Execution, Deployment > Build Tools > Gradle,找到Gradle JDK配置项,下拉选择Android Studio内置的对应版本JDK即可(2022年之后发布的Android Studio版本统一选择JDK 17,不要自行配置版本不匹配的独立安装JDK),确认后重新触发同步。 - 清理无效代理配置
如果之前配置过网络代理,依次打开File > Settings > Appearance & Behavior > System Settings > HTTP Proxy,选择No proxy选项保存,清除无效代理配置后再重试同步。
注意:首次项目同步过程不要手动中断进程,网络正常情况下3-5分钟即可完成同步,同步完成后项目无报红即可正常运行调试。
内容的提问来源于stack exchange,提问作者Momodu Sesay
相关产品推荐
相关产品推荐

