Android Studio中如何缩短并修改项目包名?
在Android Studio中重命名包名的详细步骤
要把旧包名 com.google.android.gms.location.sample.locationupdates 改成 com.example.app,按照以下步骤操作就行:
方法一:使用Android Studio自动重构(推荐)
这是最省心的方式,IDE会帮你自动更新所有引用:
- 打开Android Studio,切换到Android视图(左侧面板顶部默认就是这个),找到项目包名(通常在
app/java目录下)。 - 右键点击旧包名
com.google.android.gms.location.sample.locationupdates,选择 Refactor > Rename。 - 在弹出的对话框里,选 Rename Package(别选Rename Directory,那只会改文件夹名,不会同步更新代码里的引用)。
- 输入新包名
com.example.app,点击Refactor。 - IDE会扫描所有需要修改的文件,确认无误后点击Do Refactor。
- 等待重构完成后,顺便检查下
AndroidManifest.xml、Module级build.gradle里的包名是否已经同步更新。
方法二:手动修改(适合精细控制场景)
如果自动重构有遗漏,或者你想手动操作,按以下步骤来:
- 切换到Project视图:左侧面板顶部切换到Project,这样能看到完整的目录层级。
- 调整目录结构:
- 找到
app/src/main/java/com/google/android/gms/location/sample/locationupdates,先把最内层的locationupdates文件夹重命名为app。 - 一步步往上调整,把
sample改成example,再删除gms、android这些不需要的文件夹,最终目录变成app/src/main/java/com/example/app。
- 找到
- 更新代码里的包声明:打开每个Java/Kotlin类文件,把顶部的
package com.google.android.gms.location.sample.locationupdates;改成package com.example.app;。 - 修改AndroidManifest.xml:找到
<manifest>标签里的package属性,改成com.example.app,同时检查所有<activity>、<service>等组件的android:name属性是否正确(一般是.XXX格式或者完整新包名)。 - 同步build.gradle配置:打开
app/build.gradle,找到defaultConfig里的applicationId,改成com.example.app。 - 清理并重建项目:点击顶部菜单栏的File > Sync Project with Gradle Files,然后依次选Build > Clean Project、Build > Rebuild Project,确保没有报错。
最后检查项
重构完成后,建议核对几个关键地方:
- 所有Java/Kotlin类的包声明是否正确。
AndroidManifest.xml里的包名和组件引用是否正常。- Module级
build.gradle里的applicationId是否匹配新包名。 - 项目中有没有硬编码旧包名的地方(比如字符串资源、第三方库配置等),如果有手动修改即可。
内容的提问来源于stack exchange,提问作者Anand Singh




