当前位置:首页 > 行业动态 > 正文

安卓工作室重命名包

重命名前的准备工作

  1. 关闭项目并重新打开
    确保Android Studio完全关闭后重新打开,避免缓存残留导致错误。
  2. 检查SDK路径
    File -> Project Structure中确认SDK路径正确,避免因路径问题引发后续错误。

修改build.gradle中的applicationId

文件路径
app/build.gradle defaultConfig中的applicationId改为新包名(如com.newdomain.myapp
其他模块的build.gradle(如有) 检查并同步修改依赖项中的旧包名(如implementation project(':oldpackage')
// 示例:修改前
defaultConfig {
    applicationId "com.example.myapp"
    ...
}
// 修改后
defaultConfig {
    applicationId "com.newdomain.myapp"
    ...
}

重命名包目录及文件

方法1:手动重命名(风险较高)

  1. 展开src/main/java目录,右键点击原包名文件夹(如com.example.myapp)。
  2. 选择Refactor -> Rename,输入新包名(如com.newdomain.myapp)。
  3. 勾选Refactor directory namesUpdate references,点击Refactor

方法2:使用Android Studio重构工具(推荐)

  1. 右键点击原包名文件夹,选择Refactor -> Rename
  2. 输入新包名,确保勾选Refactor directory namesUpdate references
  3. 点击Refactor,等待IDE自动更新所有引用。

同步Gradle并重建项目

  1. 点击Sync Now同步Gradle配置。
  2. 选择菜单栏Build -> Clean Project,再点击Build -> Rebuild Project

验证修改结果

  1. 检查AndroidManifest.xml
    确保package属性已更新为新包名:

    <manifest xmlns:android="http://schemas.android.com/apk/res/android"
        package="com.newdomain.myapp">
  2. 运行项目
    启动应用,确认无ClassNotFoundExceptionResourceNotFoundException错误。

常见问题与解决方案

问题描述 解决方案
重命名后R文件报错 检查所有Java/Kotlin文件的包声明是否更新
删除build目录后重新构建
依赖库无法识别新包名 清理Gradle缓存(File -> Invalidate Caches / Restart
检查依赖库配置是否需同步更新

相关问题与解答

问题1:重命名后应用崩溃,日志提示Activity not found

原因AndroidManifest.xml中的.class路径未更新。
解决

安卓工作室重命名包  第1张

  1. 打开AndroidManifest.xml,检查<activity>标签的android:name属性。
  2. 确保类名使用完整路径(如com.newdomain.myapp.MainActivity),而非相对路径。

问题2:重命名后第三方库(如Firebase)配置失效

原因:部分库依赖旧包名或未重新初始化配置。
解决

  1. 删除google-services.json文件,重新从Firebase控制台下载。
  2. 检查build.gradle中的依赖版本是否兼容新包
0