【Android 应用开发】Android 工程修改包名流程 ( 修改 applicationId | 修改 package | 修改 R 资源引用 | 修改 BuildConfig 引用 )_安卓修改软件包名

需要将一份工程源码编译出的应用 , 在同一手机上运行多个 , 这里不修改源码中的包名 , 仅修改当前工程配置中的包名 ;

如果当前工程中源码数量较多 , 几百个或几千个的量级 , 不推荐修改代码中的实际包名 ;

刚移植了一个几千个源码文件的工程 , 记录下流程 ;

一、 Android 工程修改包名流程

---

Android 工程修改包名流程 :

• ① 修改 applicationId : 修改 Module 下的 build.gradle 中的 applicationId ;
• ② 修改 package : 修改 AndroidManifest.xml 清单文件中的 packge 包名 ;
• ③ 修改 R 引用 : 修改 Java 代码中的 package.R 引用 ;
• ④ 修改 BuildConfig 引用 : 修改 Java 代码中的 package.BuildConfig 引用 ;
• ⑤ AndroidManifest.xml 清单文件修改 : 所有的组件都使用全路径名称 , FileProvider 的 authorities 也要进行相应修改 ;

二、 修改 applicationId

---

在 Module 下的 build.gradle 中 , 修改 applicationId , 该配置在 android / defaultConfig 层级下 ;

将 applicationId 修改为 “kim.hsl.package_change2” ;

( 修改后 )

三、 修改 package 包名

---

在 AndroidManifest.xml 清单文件中 , 修改 manifest 根节点的 package 包名属性 ,

( 修改前 )

将其修改为与 applicationId 相同 , “kim.hsl.package_change2” ;

( 修改后 )

四、 AndroidManifest.xml 清单文件组件

---

AndroidManifest.xml 清单文件中注册的所有 Activity , Service 等组件 , 其 android:name 属性 , 都使用该组件的完整的包名类名 , 避免使用如下缺省包名的形式 :

包名缺省 , 如果修改根节点的 package 属性 , 就无法找到对应的组件了 , 这里建议使用组件的全路径名称 ;

( 推荐使用方式 )

五、 修改 R 资源引用、修改 BuildConfig 引用

---

包名修改后 , 对应生成的资源类 R , 编译配置类 BuildConfig 的包名也发生了相应的改变 ;

需要将

import kim.hsl.package_change.R;
import kim.hsl.package_change.BuildConfig;
1
2

修改为

import kim.hsl.package_change2.R;
import kim.hsl.package_change2.BuildConfig;
1
2

对于源码中修改的 R 较多时 , 选中源码目录 src , 使用 " Ctrl + Shift + R " 快捷键 , 也可以右键点击 src 目录 , 选择 " Replace in Path… " 选项 ,

修改 R 资源引用 : 在 " Replace in Path " 对话框中 ,

搜索 “import kim.hsl.package_change.R;”
替换为 “import kim.hsl.package_change2.R;”

直接点击下方的 " Replace All " 按钮 , 替换工程中所有的导入选项即可 ;

修改 BuildConfig 引用 : 在 " Replace in Path " 对话框中 ,

搜索 “import kim.hsl.package_change.BuildConfig;”
替换为 “import kim.hsl.package_change2.BuildConfig;”

( 在该示例中只有一个 , 如果是一个大型项目 , 会有几百上千的匹配 )

六、 修改 FileProvider

---

由于忽略了该步骤 , 导致出错 , 【错误记录】Android 应用安装报错 ( The application could not be installed: INSTALL_FAILED_CONFLICTING_PROVIDER ) ;

如果在代码中使用了 FileProvider , 需要修改 provider 标签的 android:authorities 属性 , 该属性的属性值是 包名.fileProvider , 这里的包名需要替换成修改后的包名 ;

修改前 :

修改后 :

        <provider
            android:name="androidx.core.content.FileProvider"
            android:authorities="kim.hsl.package_change.fileProvider"
            android:grantUriPermissions="true"
            android:exported="false">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/provider_path" />
        </provider>
1
2
3
4
5
6
7
8
9

对应的 provider_path 文件中的相关包名 , 也要进行相应修改 ;

<?xml version="1.0" encoding="utf-8"?>
<paths  xmlns:android="http://schemas.android.com/apk/res/android">
    <external-path path="Android/data/kim.hsl.package_change2/" name="files_root" />
    <files-path path="." name="files-path" />
    <cache-path path="." name="cache-path" />
    <external-files-path path="." name="external_file_path" />
    <external-cache-path path="." name="external_cache_path" />
</paths>
1
2
3
4
5
6
7
8

七、 博客资源

---

源码 : Package_Change 是原始工程 , Package_Change_2 是修改后的工程 ;

https://download.csdn.net/download/han1202012/15712500