每个 Android 应用均有一个唯一的应用 ID，像 Java 软件包名称一样，如 com.example.myapp。 此 ID 可以在设备上和 Google Play 商店中对您的应用进行唯一标识。 如果您想要上传新版本的应用，应用 ID（以及使用它签署的证书）必须与原始 APK 相同 - 如果您更改应用 ID，Google Play 商店会将 APK 视为完全不同的应用。所以您发布应用后，绝不应更改应用 ID。



build.gradle 文件中的 applicationId

android {
    defaultConfig {
        applicationId "com.example.myapp"
        minSdkVersion 15
        targetSdkVersion 24
        versionCode 1
        versionName "1.0"
    }
    ...
}

applicationId

尽管应用 ID 看起来像传统的 Java 软件包名称，但应用 ID 的命名规则有更多限制：

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

注： 应用 ID 用于直接关联到代码的软件包名称；所以有些 Android API 会在其方法名称和参数名称中使用术语“软件包名称”，但这实际上是您的应用 ID。例如，Context.getPackageName() 方法会返回您的应用 ID。 无论何时都不需要在应用代码以外分享代码真实的软件包名称。 注意：如果您使用的是 WebView，请考虑在您的应用 ID 中将您的软件包名称用作前缀；否则，您可能会遇到如问题 211768 中所述的问题。

更改用于构建变体的应用 ID

build.gradle 文件的 defaultConfig 块中定义的应用 ID 标记 APK（如下所示）。不过，如果您想要创建不同版本的应用以在 Google Play 商店上显示为单独详情，如“免费版”和“专业版”，您需要创建单独的构建变体，每个构建变体具有不同的应用 ID。productFlavors {} 块中的每种风味，您可以重新定义 applicationId 属性，或者改用 applicationIdSuffix

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

这样，“免费”产品风味的应用 ID 就变为“com.example.myapp.free”。

您也可以根据自己的构建类型使用 applicationIdSuffix

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

因为 Gradle 会在产品风味后面应用构建类型配置，“免费调试”构建变体的应用 ID 现在为“com.example.myapp.free.debug”。如果您想要在同一个设备上创建调试和发布构建，这会十分有用，因为两个 APK 不会具有相同的应用 ID。

注意：对于与之前的 SDK 工具的兼容性，如果您不在 build.gradle 文件中定义 applicationId 属性，构建工具会将 AndroidManifest.xml 提示：如果您需要在清单文件中引用应用 ID，可以在任何清单属性中使用 ${applicationId}

更改用于测试的应用 ID

.test。例如，com.example.myapp.free 构建变体的测试 APK 的应用 ID 为 com.example.myapp.free.test。defaultConfig 或productFlavor 块中定义 testApplicationIdR

更改软件包名称

AndroidManifest.xml 文件中的 package

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.myapp"
    android:versionCode="1"
    android:versionName="1.0" >

package

  • 它会将此名称用作应用生成的 

R.java

  •  类的命名空间。 示例：对于上面的清单，

R

  •  类将为 

com.example.myapp.R

  • 。
  • 它会使用此名称解析清单文件中声明的任何相关类名称。 示例：对于上面的清单，声明为 

<activity android:name=".MainActivity">

  •  的 Activity 将解析为 

com.example.myapp.MainActivity

  • 。

package 属性中的名称应始终匹配您项目的基础软件包名称，软件包中保存着您的 Activity 和其他应用代码。 当然，您的项目中可以包含子软件包，但是这些文件必须从 package 属性导入使用命名空间的 R.javapackage 属性。 只要您使用 Android Studio 的工具重命名和重构您的软件包，那么这些属性就会自动保持同步。 （如果这些属性未保持同步，您的应用代码将无法解析 RAndroidManifest.xml 文件中指定 package 您还需要了解以下内容：尽管清单 package 和 Gradle applicationId 可以具有不同的名称，但构建工具会在构建结束时将应用 ID 复制到 APK 的最终清单文件中。所以，如果您在构建后检查 AndroidManifest.xml 文件，package 属性发生更改就不足为奇。实际上，Google Play 商店和 Android 平台会注意 package 属性来标识您的应用；所以构建利用原始值后（用作 R