Android修改应用包名和ApplicationId：实战和理

2019-07-25 本文已影响9人 HWilliamgo

今天遇到了一个需求是，要改应用的applicationId然后上架，那么我以前的做法是将应用的包名一起给改了，让包名和applicationId统一。但是我今天想了一下，是否可以不改包名，只改appId，那么后期就不用维护两套差异比较大的代码了，毕竟改了包名，包的结构会发生改变，那么git分支合并就会有比较多的冲突了。

结论：可以只改build.gradle中的applicationId来改包名，因为后者会覆盖掉Manifest文件中的<package>，但是有使用的限制场景（文末指出了限制场景）。

1. 理解Manifest中定义的包名和gradle中定义的applicationId的差异

结论

在gradle构建apk的最后一步时，会将build.gradle中的applicationId，覆盖AndroidManifest.xml中定义的<package>，这样应用的ID就以gradle中指定的为准。而Manifest中指定的<package>，则影响的是真正的Java类目录，包括编译时的类目录和编译后生成的apk中的class文件的类路径。

1.1 Manifest中的包名

1.1.1 打包前后的表现

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
          package="com.william.changepackage">

    <application
            android:allowBackup="true"
            android:icon="@mipmap/ic_launcher"
            android:label="@string/app_name"
            android:roundIcon="@mipmap/ic_launcher_round"
            android:supportsRtl="true"
            android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN"/>

                <category android:name="android.intent.category.LAUNCHER"/>
            </intent-filter>
        </activity>
    </application>

</manifest>

Manifest中的包名指的就是package=""中的内容，在创建一个项目的时候，就会指定这个值，并且这个值默认是和gradle中定义的applicationId是一致的。

android {
    //...
    defaultConfig {
        applicationId "com.william.changepackage"
        //...
    }
    //...
}

那么看看此时的项目结构：

打一个debug包看看：

BuildConfig类和R.java类都是生成在/包名/路径下的。

而apk中，合并了的最终的Manifest:

<?xml version="1.0" encoding="utf-8"?>
<manifest
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:versionCode="1"
    android:versionName="1.0"
    android:compileSdkVersion="28"
    android:compileSdkVersionCodename="9"
    package="com.william.changepackage"
    platformBuildVersionCode="28"
    platformBuildVersionName="9">
    <uses-sdk
        android:minSdkVersion="16"
        android:targetSdkVersion="28" />
    <application
        android:theme="@ref/0x7f0c0005"
        android:label="@ref/0x7f0b0027"
        android:icon="@ref/0x7f0a0000"
        android:debuggable="true"
        android:testOnly="true"
        android:allowBackup="true"
        android:supportsRtl="true"
        android:roundIcon="@ref/0x7f0a0001"
        android:appComponentFactory="android.support.v4.app.CoreComponentFactory">
        <activity
            android:name="com.william.changepackage.MainActivity">
            <intent-filter>
                <action
                    android:name="android.intent.action.MAIN" />
                <category
                    android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

注意，这里的MainActivity的声明，在编写的时候是没有加上包名前缀的，合并成最终的Manifest加上了，加的就是类路径，也就是Manifest合并前的<package>。

1.1.2 存在的意义

Manifest中的<package>存在的意义是，BuildConfig.java，R.java等文件，都是在编译期生成的，那么这些文件生成了要放在哪里？放在我们的类路径中让我们的类能引用到R.java中定义的资源变量。那么R.java就需要被指明一个路径来生成，这就是<package>的意义，如果把<pakcage>随便写一个路径，然后打包，会遇到：

项目路径\changePackage\app\src\main\java\com\william\changepackage\MainActivity.kt: (10, 24): Unresolved reference: R

意思是MainActivity.java没办法引用到R.java了，因为R.java生成在了一个MainActivity.java无法识别的路径（即乱写的那个路径）。无法打包。

1.1.3 书写规则

项目的类路径是什么，Manifest的<package>就怎么写，两边保持一致。

1.2 gradle中的applicationId

applicationId就是用来表明应用ID的，就是应用市场上面的appId，应用区分于别的应用的唯一标志。

他与类路径无任何关系，你指定什么都不会影响类路径。

1.2.1 完全修改applicationId

我把

android {
    //...
    defaultConfig {
        applicationId "com.william.changepackage"
        //...
    }
    //...
}

改成了

android {
    //...
    defaultConfig {
        applicationId "how.are.you"
        //...
    }
    //...
}

编译->打包->检查apk：

先看apk中的manifest文件：

<?xml version="1.0" encoding="utf-8"?>
<manifest
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:versionCode="1"
    android:versionName="1.0"
    android:compileSdkVersion="28"
    android:compileSdkVersionCodename="9"
    package="how.are.you"
    platformBuildVersionCode="28"
    platformBuildVersionName="9">

    <uses-sdk
        android:minSdkVersion="16"
        android:targetSdkVersion="28" />

    <application
        android:theme="@ref/0x7f0c0005"
        android:label="@ref/0x7f0b0027"
        android:icon="@ref/0x7f0a0000"
        android:debuggable="true"
        android:testOnly="true"
        android:allowBackup="true"
        android:supportsRtl="true"
        android:roundIcon="@ref/0x7f0a0001"
        android:appComponentFactory="android.support.v4.app.CoreComponentFactory">

        <activity
            android:name="com.william.changepackage.MainActivity">

            <intent-filter>

                <action
                    android:name="android.intent.action.MAIN" />

                <category
                    android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

<package>的确被覆盖成了how.are.you。
MainActivity的声明依然保留的是原本的类路径的前缀，而不是新的how.are.you.MainActivity。（改成新的了就会出问题了不是吗）

查看一下classes.dex

类路径没有改变，依然是编译前类路径什么样现在类路径还是什么样。

1.2.2 存在的意义

以前用Eclispse开发的时候，不用build.gradle，那时候的包名就等同于应用名。没有却别。

但是后来AndroidStudio开发，引入了gradle这个高级的构建系统，gradle支持applicationId，因为你可以这样操作：

android {
    defaultConfig {
        applicationId "com.example.myapp"
    }
    productFlavors {
        free {
            applicationIdSuffix ".free"
        }
        pro {
            applicationIdSuffix ".pro"
        }
    }
}

来对免费和付费版app发布不同的应用到应用商店。

或者用

android {
    ...
    buildTypes {
        debug {
            applicationIdSuffix ".debug"
        }
    }
}

这样debug和release包的appID不一样，那么就可以同时在一个设备装发布版和调试版应用了。

1.2.3 书写规则

必须至少包含两段（一个或多个圆点）。
每段必须以字母开头。
所有字符必须为字母数字或下划线 [a-zA-Z0-9_]

2. applicationId的限制

Android文档中提示：

我点进到问题211768：

当WebView加载file:///android_res/URLS这种资源的时候，他的工作方式是，通过查找app的package name来找到R.java文件，从而引用res/下的资源，然而，当applicationId和package不同时，后者会在生成apk之前被覆盖掉，导致WebView查找不到这个资源，无法正常工作。

所幸，这个WebView的bug被部分地修复了，只要你的applicatIionId和包名拥有相同的前缀，那么就能被识别到。（我猜是他会从左到右根据"."分隔符去查找R.java资源文件）

所以，最保险的做法是，applicationId的前缀和包名完全相同。

如果要和包名不一样，那么就保证应用中的WebView不要用file:///android_res/URLS这种方式去引用资源，可以放在assets目录中。