[官方文档]设置应用 ID

原文地址: https://developer.android.com/studio/build/application-id?hl=zh-cn

设置应用 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)。不过,您需要注意,更改软件包名称会产生其他影响,请参阅修改软件包名称的相关部分。

笔记:在Android Studio中创建新项目时,applicationId默认和AndroidManifest配置的包名相同。但是应用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"
        }
    }
}

笔记:构建变体 buildVariants,产品风味productFlavors,构建类型buildTypes。其中产品风味和构建类型组合生成不同的构建变体,productFlavors-buildTypes。

这样,“免费”产品风味的应用 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。

笔记:项目主AndroidManifest.xml中指定的package属性为软件包名称,主要用于生成R.java类的命名空间,解析清单文件中声明的相关类名。通过apktool反编译apk包,可以看到AndroidManifest.xml中的package属性最终值替换为应用ID。

后续:在集成友盟sdk时遇到相关概念,故进一步复习巩固。该公司集成文档总感觉读起来怪怪的,资源包名应该是指package中定义的软件包名城,应用程序包名应该是最终替换后的应用ID。

友盟push集成文档截图
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,362评论 5 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,330评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,247评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,560评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,580评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,569评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,929评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,587评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,840评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,596评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,678评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,366评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,945评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,929评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,165评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,271评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,403评论 2 342

推荐阅读更多精彩内容