关于Android 设置应用 ID applicationId
2017-04-19 12:30
204 查看
每个 Android 应用均有一个唯一的应用 ID,像 Java 软件包名称一样,如 com.example.myapp。
此 ID 可以在设备上和 Google Play 商店中对您的应用进行唯一标识。 如果您想要上传新版本的应用,应用 ID(以及使用它签署的证书)必须与原始
APK 相同 - 如果您更改应用 ID,Google Play 商店会将 APK 视为完全不同的应用。所以您发布应用后,绝不应更改应用 ID。
您的应用 ID 通过模块的
当您在 Android Studio 中创建新项目时,
尽管应用 ID 看起来像传统的 Java 软件包名称,但应用 ID 的命名规则有更多限制:
必须至少包含两段(一个或多个圆点)。
每段必须以字母开头。
所有字符必须为字母数字或下划线 [a-zA-Z0-9_]。
注: 应用 ID 用于直接关联到代码的软件包名称;所以有些 Android API 会在其方法名称和参数名称中使用术语“软件包名称”,但这实际上是您的应用 ID。例如,
ID。 无论何时都不需要在应用代码以外分享代码真实的软件包名称。
注意:如果您使用的是
211768 中所述的问题。
ID。
这种情况下,每个构建变体应定义为单独的app。 对于
这样,“免费”产品风味的应用 ID 就变为“com.example.myapp.free”。
您也可以根据自己的构建类型使用
因为 Gradle 会在产品风味后面应用构建类型配置,“免费调试”构建变体的应用 ID 现在为“com.example.myapp.free.debug”。如果您想要在同一个设备上创建调试和发布构建,这会十分有用,因为两个 APK 不会具有相同的应用 ID。
注意:对于与之前的 SDK 工具的兼容性,如果您不在
提示:如果您需要在清单文件中引用应用 ID,可以在任何清单属性中使用
尽管不必需,您也可以通过在
注:为了避免与受测应用的名称冲突,构建工具会根据测试应用 ID(而不是清单文件中定义的软件包名称)通过命名空间为您的测试 APK 生成
Android 构建工具会将
它会将此名称用作应用生成的
示例:对于上面的清单,
它会使用此名称解析清单文件中声明的任何相关类名称。
示例:对于上面的清单,声明为
同样,
如果您想要完全重构您的软件包名称,请确保也更新
您必须始终在项目的主
您还需要了解以下内容:尽管清单
Play 商店和 Android 平台会注意
此 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。
这种情况下,每个构建变体应定义为单独的app。 对于
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。
注意:对于与之前的 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。
尽管不必需,您也可以通过在
defaultConfig或
productFlavor块中定义
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。
相关文章推荐
- Android应用开发---关于SQL中通过cursor获取指定id的内容
- 关于网上解决Android4.x系统设置字体大小导致应用布局混乱引起的问题
- 关于Android应用的内存管理及性能
- 关于CKeditor的非主流个性应用的设置
- android中application 关于全局变量
- 关于Android系统中system.img和data.img中文件系统的权限设置
- 关于CKeditor的个性应用设置 转
- 关于9080端口和80端口实现真正意义的WebServer+ApplicationServer结合应用
- android 的Application应用
- 用eclipse 开发 android应用时出现个错误,“your project contains error(s),please fix them before running your application”
- 关于Android系统中system.img和data.img中文件系统的权限设置
- 关于标准android中视频播放器中的快进和快退的步长时间设置
- 关于CKeditor的非主流个性应用的设置
- 如何设置隐藏Android应用的标题栏和状态栏
- [Android应用] 问题4: Re-installation failed due to different application signatures
- eclipse 上调试android的自带应用方法 二 (Re-installation failed due to different application signatures.)
- VC.NET界面编程中关于的ToolBar(工具栏)的编程应用(二)2008/07/01 19:22 上回说到给工具栏上添加IE风格的下拉菜单按钮,我们通过设置工具栏按钮的风格已经完成了下拉菜单按钮的添加,现在我们准备为下拉菜单按钮中响应下拉箭头部分的实现
- 首届 Google 暑期大学生博客分享大赛——2010 Android 篇 android关于 Google Map 开发的应用
- 关于Android中传递数据的一些讨论 intent行不通,static不让用的时候用application
- 关于不用重新部署就可以应用更改的设置