4、创建第一个项目:项目模板选择、项目命名规范、包名与最小SDK版本设置

好,到了真正动手的时刻了。

说实话,每次带新人,我最怕看到的就是这一步出问题。项目建歪了,后面全是坑。今天咱们就把「创建项目」这件事掰开揉碎,讲清楚。

4.1 项目模板选择:别选错了起点

打开 Android Studio,点击 "New Project",你会看到一堆模板。我刚开始用的时候也懵过——这么多模板,选哪个?

其实核心就三类:

  • Empty Views Activity:最干净的模板。就一个空白页面,啥都没有。我个人习惯用这个,因为我不想让 Android Studio 替我生成一堆用不上的代码。
  • Basic Views Activity:带了一个底部导航栏和几个 Fragment。适合做多页面 App 的起点。
  • Compose 相关模板:如果你打算用 Jetpack Compose 写 UI,选这个。不过 Compose 的学习曲线稍微陡一点,新手建议先从传统 View 系统入手。
我的建议:初学者选 Empty Views Activity。干净、可控。等你熟悉了,再尝试其他模板。

我在项目中遇到过一件事:有个同事选了 "Basic Activity",结果项目里多了一堆导航相关的代码,他删了半天。嗯,选模板这事,宁少勿多。

4.2 项目命名规范:名字起得好,后面少烦恼

项目名、模块名、包名,这三者容易搞混。咱们一个一个说。

项目名(Project Name)

就是你在电脑上看到的文件夹名字。建议用英文,首字母大写,驼峰命名。比如:MyFirstAppWeatherApp

为什么不用中文?因为有些工具链对中文路径支持不好。我曾经因为项目名带了中文,导致 Gradle 编译报错,查了半天才发现是路径问题。从那以后,我所有项目名都只用英文。

包名(Package Name)

包名是 App 的唯一标识。Google Play 上不允许两个 App 包名相同。所以命名要规范。

标准格式是:com.你的域名.应用名。比如:com.example.myfirstapp

注意几点:

  • 全部小写
  • 用点号分隔
  • 不要用下划线
  • 不要用数字开头
避坑指南:我曾经见过有人把包名写成 com.123app.hello,结果编译直接报错。包名里不能有数字开头,这是 Java 的硬性规定。

4.3 最小 SDK 版本设置:选低了兼容好,选高了功能多

这一步很多人直接默认选 API 24。但你真的了解这个选项的意义吗?

说白了,最小 SDK 版本决定了你的 App 能跑在哪些旧设备上。选 API 24,意味着 Android 7.0 以下的手机就装不了你的 App。

那怎么选?我一般看这个数据:

API 级别 Android 版本 覆盖率(2024年数据) 建议
API 21 Android 5.0 约 95%+ 兼容性最好,但有些新 API 用不了
API 24 Android 7.0 约 90%+ 平衡之选,大多数项目用这个
API 26 Android 8.0 约 85%+ 可以用 Notification Channel 等新特性
API 29 Android 10 约 70%+ 新项目推荐,功能最全

我个人习惯:新项目选 API 24。为什么?因为 API 24 以上覆盖了 90% 的用户,同时支持 Java 8 的大部分特性。你想想看,为了那 10% 的旧设备,牺牲开发效率,值吗?

核心原则:最小 SDK 版本不是越低越好。选一个「够用」的版本,既能覆盖大部分用户,又能用上较新的 API。

4.4 实际操作:一步步创建项目

好,理论说完了,咱们走一遍流程。

  1. 打开 Android Studio,点击 "New Project"。
  2. 选择 "Empty Views Activity",点 Next。
  3. 填写项目名:MyFirstApp
  4. 包名自动生成:com.example.myfirstapp。你可以改成自己的域名。
  5. 选择保存路径。注意:路径不要有中文和空格。
  6. 语言选 Java 或 Kotlin。新手建议 Kotlin,现在官方主推。
  7. 最小 SDK 选 API 24: Android 7.0
  8. 点击 Finish,等 Gradle 同步完成。

同步完成后,你会看到项目结构。别慌,后面我们会慢慢拆解每个文件的作用。

小技巧:第一次创建项目时,Gradle 需要下载依赖,可能会比较慢。建议提前配好国内镜像源,比如阿里云的 Maven 仓库。具体配置方法,后面章节会讲。

4.5 常见问题与避坑

嗯,这里有几个我踩过的坑,分享给你:

  • 项目名和包名混淆:项目名是文件夹名字,包名是 App 的唯一标识。两者可以不一样。比如项目名叫 MyApp,包名叫 com.company.myapp
  • 最小 SDK 选太低:选了 API 16,结果发现很多新 API 用不了,还得写兼容代码。浪费时间。
  • 路径有中文:Gradle 编译报错,提示路径非法。解决办法:项目路径全英文。

我曾经带过一个实习生,他项目名用了中文「我的第一个App」,结果编译一直报错。我帮他改回英文后,一次通过。你想想看,这种低级错误,能避免就避免。

4.6 小结

创建项目看似简单,但每一步都有讲究。模板选对了,后面少删代码;命名规范了,团队协作不吵架;最小 SDK 选好了,兼容性和新特性两不误。

下一章,我们会正式进入代码编写环节。到时候,你会看到 Android Studio 的编辑器有多强大。

公众号:蓝海资料掘金营,微信deep3321