必须先绕过gradle下载卡死、包名非法报错、模拟器启动失败三道门槛:选empty activity模板,包名用小写字母+数字如com.example.myfirstapp,配置阿里云gradle镜像和仓库源,创建并启动android 14 avd运行项目。

用Android Studio创建第一个安卓项目,必须先绕过Gradle下载卡死、包名非法报错、模拟器启动失败这三道新手门槛,否则连“Hello World”都看不到。
启动Android Studio并新建项目
双击桌面Android Studio图标启动,若首次运行会弹出配置向导,全部点“Next”→“Finish”,跳过主题和插件设置;等主界面加载完成,点击欢迎页的【New Project】按钮。
在模板选择页,务必选【Empty Activity】(不是Empty Views Activity),这是当前Android Studio 2025.1+版本中唯一默认启用Jetpack Compose且自带Material 3 UI组件的空模板,能直接跑通最新API特性。
点击“Next”后进入项目配置页:项目名称可填“MyFirstApp”,包名必须用小写字母+数字组合,例如【com.example.myfirstapp】——这里不能含下划线、中文或大写字母,否则后续构建会直接失败。
配置国内Gradle镜像加速下载
项目创建过程中,Android Studio会自动下载Gradle和依赖库,但默认走国外服务器,国内用户常卡在“Downloading Gradle distribution…”长达半小时以上。
方法一:修改gradle-wrapper.properties文件
打开项目根目录 → gradle → wrapper → gradle-wrapper.properties,找到distributionUrl这一行,把原链接替换成阿里云镜像:
【distributionUrl=https\://mirrors.aliyun.com/gradle/distributions/gradle-8.9-bin.zip】
Android 开发调试技能,通过系统 ADB 工具操作 Android 设备。以下场景必须触发此技能:(1) 直接 ADB 操作——安装 APK、查看设备列表、抓取 logcat 日志、查看已安装应用、清除应用数据、截图、重启设备、拉取/推送文件、查看 CPU/内存/电池信息、adb shell 操作;(2)...
方法二:同步更新settings.gradle仓库源
打开项目根目录下的settings.gradle,在pluginManagement → repositories区块内,把google()和mavenCentral()这两行删掉,替换成:
maven { url 'https://maven.aliyun.com/repository/google' }
maven { url 'https://maven.aliyun.com/repository/central' }
改完保存,Android Studio右下角会弹出“Reload project”的提示,点击它——这一步不点,所有修改都不会生效。
启动模拟器并运行项目
第一步:创建AVD
顶部菜单栏 → Tools → AVD Manager → 点击左下角“Create Virtual Device”,选Pixel 4 → Next → 在System Image页勾选“x86_64”架构的Android 14(API 34)镜像 → Download → 完成后点击Finish。
第二步:启动并部署
工具栏设备下拉框选刚建好的AVD → 点击绿色三角形Run按钮 → Android Studio会自动编译APK、安装到模拟器、启动MainActivity。
注意:首次启动模拟器需等待30~90秒,屏幕显示“Android”Logo后才真正就绪;若卡在黑屏或报错“HAXM not installed”,说明未开启Intel虚拟化技术,需进BIOS开启VT-x选项。
项目构建成功后,模拟器上会出现带“Hello World!”文字的空白界面,底部状态栏显示应用包名,此时第一个安卓项目已运行完毕。










