在Eclipse中更改Android项目包名的方法

基础概念

包名(Package Name)是Android应用的唯一标识符，在AndroidManifest.xml文件中定义，格式通常为com.companyname.appname。它在整个应用生命周期中非常重要，用于应用商店识别、设备安装识别等。

更改包名的必要性

1. 避免与其他应用冲突
2. 公司品牌或产品名称变更
3. 项目所有权转移
4. 测试不同版本

在Eclipse中更改包名的完整步骤

方法一：重构包名（推荐）

1. 备份项目：在进行任何重大更改前先备份项目
2. 更改Java包名：
   • 在Package Explorer中右键点击要更改的包
   • 选择"Refactor" → "Rename"
   • 输入新包名并勾选"Update references"
   • 点击"Preview"确认更改，然后点击"OK"

• 更新AndroidManifest.xml：
  • 打开AndroidManifest.xml文件
  • 修改package属性为新包名
  • 更新所有activity、service等组件的完整路径
• 更新R.java引用：
  • 在代码中搜索旧包名对R类的引用
  • 替换为import 新包名.R;
• 清理和重建：
  • 选择"Project" → "Clean"
  • 重建项目

方法二：手动更改

1. 在Package Explorer中手动创建新包结构
2. 将源文件拖到新包中
3. 更新所有文件中的包声明
4. 更新AndroidManifest.xml
5. 更新资源引用

常见问题及解决方案

1. R.java文件丢失错误：
   • 原因：包名更改后未正确更新引用
   • 解决：检查所有R.java引用，清理并重建项目

• ClassNotFoundException：
  • 原因：AndroidManifest.xml中组件路径未更新
  • 解决：确保所有组件使用完整新包名路径
• 安装冲突：
  • 原因：设备上已安装旧包名版本
  • 解决：卸载旧版本或更改包名使其唯一

注意事项

1. 更改包名会影响：
   • 应用更新（被视为新应用）
   • 已保存的用户数据
   • 深层链接和Intent过滤器

• 对于已发布的应用，更改包名意味着：
  • 应用商店会视为全新应用
  • 用户需要重新下载
  • 评分和评论不会迁移
• 建议在开发早期确定包名，避免后期更改

示例代码

更改前AndroidManifest.xml：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.oldcompany.appname">

更改后AndroidManifest.xml：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.newcompany.appname">

Java文件更改前：

package com.oldcompany.appname;
import com.oldcompany.appname.R;

Java文件更改后：

package com.newcompany.appname;
import com.newcompany.appname.R;