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

韩曙亮

发布于 2023-03-29 08:35:53

3.8K0

发布于 2023-03-29 08:35:53

文章被收录于专栏：韩曙亮的移动开发专栏

文章目录

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

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

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

一、 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;

修改为

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

对于源码中修改的 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>

对应的 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>