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)
就是你在电脑上看到的文件夹名字。建议用英文,首字母大写,驼峰命名。比如:MyFirstApp、WeatherApp。
为什么不用中文?因为有些工具链对中文路径支持不好。我曾经因为项目名带了中文,导致 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 实际操作:一步步创建项目
好,理论说完了,咱们走一遍流程。
- 打开 Android Studio,点击 "New Project"。
- 选择 "Empty Views Activity",点 Next。
- 填写项目名:
MyFirstApp。 - 包名自动生成:
com.example.myfirstapp。你可以改成自己的域名。 - 选择保存路径。注意:路径不要有中文和空格。
- 语言选 Java 或 Kotlin。新手建议 Kotlin,现在官方主推。
- 最小 SDK 选
API 24: Android 7.0。 - 点击 Finish,等 Gradle 同步完成。
同步完成后,你会看到项目结构。别慌,后面我们会慢慢拆解每个文件的作用。
4.5 常见问题与避坑
嗯,这里有几个我踩过的坑,分享给你:
- 项目名和包名混淆:项目名是文件夹名字,包名是 App 的唯一标识。两者可以不一样。比如项目名叫
MyApp,包名叫com.company.myapp。 - 最小 SDK 选太低:选了 API 16,结果发现很多新 API 用不了,还得写兼容代码。浪费时间。
- 路径有中文:Gradle 编译报错,提示路径非法。解决办法:项目路径全英文。
我曾经带过一个实习生,他项目名用了中文「我的第一个App」,结果编译一直报错。我帮他改回英文后,一次通过。你想想看,这种低级错误,能避免就避免。
4.6 小结
创建项目看似简单,但每一步都有讲究。模板选对了,后面少删代码;命名规范了,团队协作不吵架;最小 SDK 选好了,兼容性和新特性两不误。
下一章,我们会正式进入代码编写环节。到时候,你会看到 Android Studio 的编辑器有多强大。
公众号:蓝海资料掘金营,微信deep3321