Save the date! Android Dev Summit is coming to Mountain View, CA on November 7-8, 2018.

设置应用 ID

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

您的应用 ID 通过模块的 build.gradle 文件中的 applicationId 属性定义,如下面所示:

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

当您在 Android Studio 中创建新项目时,applicationId 会完全匹配您在设置时选择的 Java 风格软件包名称。 不过,除了这一点,应用 ID 和软件包名称彼此无关。您可以更改代码的软件包名称(代码命名空间),这不会影响应用 ID,反之亦然(但同样,您发布应用后不应再更改应用 ID)。不过,您需要注意,更改软件包名称会产生其他影响,请参阅修改软件包名称的相关部分。

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

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

注: 应用 ID 用于直接关联到代码的软件包名称;所以有些 Android API 会在其方法名称和参数名称中使用术语“软件包名称”,但这实际上是您的应用 ID。例如,Context.getPackageName() 方法会返回您的应用 ID。 无论何时都不需要在应用代码以外分享代码真实的软件包名称。

注意:如果您使用的是 WebView,请考虑在您的应用 ID 中将您的软件包名称用作前缀;否则,您可能会遇到如问题 211768 中所述的问题。

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

当您为应用构建 APK 时,构建工具会使用 build.gradle 文件的 defaultConfig 块中定义的应用 ID 标记 APK(如下所示)。不过,如果您想要创建不同版本的应用以在 Google Play 商店上显示为单独详情,如“免费版”和“专业版”,您需要创建单独的构建变体,每个构建变体具有不同的应用 ID。

这种情况下,每个构建变体应定义为单独的产品风味。 对于 productFlavors {} 块中的每种风味,您可以重新定义 applicationId 属性,或者改用 applicationIdSuffix 在默认的应用 ID 上追加一段,如下所示:

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。

请记住,具有不同应用 ID 的 APK 在 Google Play 商店中会被视为不同的应用。 所以如果您想要改用相同的应用详情分发多个 APK,每个 APK 以不同设备配置(如 API 级别)为目标,那么您必须对每个构建变体使用相同的应用 ID,但为每个 APK 提供不同的 versionCode。如需了解详细信息,请参阅多 APK 支持

注意:对于与之前的 SDK 工具的兼容性,如果您不在 build.gradle 文件中定义 applicationId 属性,构建工具会将 AndroidManifest.xml 文件中的软件包名称用作应用 ID。这种情况下,重构您的软件包名称也会更改您的应用 ID。

提示:如果您需要在清单文件中引用应用 ID,可以在任何清单属性中使用 ${applicationId} 占位符。构建时,Gradle 会将此标记替换为实际的应用 ID。 如需了解详细信息,请参阅将构建变量注入清单

更改用于测试的应用 ID

默认情况下,构建工具会将应用 ID 应用到您的仪器测试 APK,该 APK 将应用 ID 用于给定的构建变体,同时追加 .test。例如,com.example.myapp.free 构建变体的测试 APK 的应用 ID 为 com.example.myapp.free.test

尽管不必需,您也可以通过在 defaultConfigproductFlavor 块中定义 testApplicationId 属性来更改应用 ID。

注:为了避免与受测应用的名称冲突,构建工具会根据测试应用 ID(而不是清单文件中定义的软件包名称)通过命名空间为您的测试 APK 生成 R 类。

更改软件包名称

默认情况下,您项目的软件包名称会匹配应用 ID,但您也可以更改软件包名称。 不过,如果您想要更改软件包名称,请注意软件包名称(由您的项目目录结构定义)应始终匹配 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" >

Android 构建工具会将 package 属性用于下面两方面:

  • 它会将此名称用作应用生成的 R.java 类的命名空间。

    示例:对于上面的清单,R 类将为 com.example.myapp.R

  • 它会使用此名称解析清单文件中声明的任何相关类名称。

    示例:对于上面的清单,声明为 <activity android:name=".MainActivity"> 的 Activity 将解析为 com.example.myapp.MainActivity

同样,package 属性中的名称应始终匹配您项目的基础软件包名称,软件包中保存着您的 Activity 和其他应用代码。 当然,您的项目中可以包含子软件包,但是这些文件必须从 package 属性导入使用命名空间的 R.java 类,而且清单中声明的任何应用组件均必须添加缺失的子软件包名称(或者使用完全限定软件包名称)。

如果您想要完全重构您的软件包名称,请确保也更新 package 属性。 只要您使用 Android Studio 的工具重命名和重构您的软件包,那么这些属性就会自动保持同步。 (如果这些属性未保持同步,您的应用代码将无法解析 R 类,因为它不在相同的软件包内,且清单不会标识您的 Activity 或其他组件。)

您必须始终在项目的主 AndroidManifest.xml 文件中指定 package 属性。 如果您有附加的清单文件(例如用于产品风味或构建类型),请注意优先级最高的清单文件提供的软件包名称始终用于最终合并的清单中。 如需了解详细信息,请参阅合并多个清单文件

您还需要了解以下内容:尽管清单 package 和 Gradle applicationId 可以具有不同的名称,但构建工具会在构建结束时将应用 ID 复制到 APK 的最终清单文件中。所以,如果您在构建后检查 AndroidManifest.xml 文件,package 属性发生更改就不足为奇。实际上,Google Play 商店和 Android 平台会注意 package 属性来标识您的应用;所以构建利用原始值后(用作 R 类的命名空间并解析清单类名称),它将会舍弃此值并将其替换为应用 ID。