# ApplicationId 與 PackageName
> 基于 [http://blog.csdn.net/maosidiaoxian/article/details/41719357](http://blog.csdn.net/maosidiaoxian/article/details/41719357) 校對整理,感謝原文作者 [貌似掉線](http://my.csdn.net/maosidiaoxian)
Android 應用都有自己的包名。包名是設備上每個應用程序的唯一標識,同樣也是 Google Play 商店里的唯一標識。就是說,假如你已經使用某個包名來發布應用,**就不能再去改變應用的包名**,因為這樣做會導致你的應用被視為一個全新的應用,你現有的用戶也不會收到應用的更新通知。
舊版的 Android Gralde 構建系統中,應用的包名由 manifest 中根節點的 package 屬性決定:
AndroidManifest.xml:
~~~
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.my.app"
android:versionCode="1"
android:versionName="1.0" >
~~~
然而,這里所定義的 package 還有另一個作用:用來命名資源類 R(以及用于解析相關的 Activity)。在上面的示例中,最終生成的 R 類為 **com.example.my.app.R**,所以如果你在其他包中的代碼需要引用資源,對應的 .java 文件需要導入 `com.example.my.app.R`。
在新的 Android Gradle 構建系統中,你可以輕松地構建多個不同版本的應用。例如,你可以同時構建免費版和專業版的應用(使用 flavor),并且它們在 Google Play 上也應該要有不同的包名,這樣它們就能夠在同一設備上安裝并且能夠單獨購買使用等等。同樣的,你也可以構建 “debug”、“alpha”、“beta” 版的應用(使用 build type),它們也同樣可以有唯一的包名。
同時,代碼中引用的 R 類要保持不變;在構建不同版本的應用時,對應的(引用了 R 的) .java 源文件也不能改動。
因此,我們將包名的兩種作用**解耦**:
- “application id” 對應 apk 中 manifest 定義的應用包名,同時用于設備以及 Google Play 的應用唯一標識。
- “package” 用于在源碼中引用 R 類以及解析注冊相關的 activity/service,對應 Java 的包名概念。
你可以在 Gradle 文件中指定 application id,如下所示:
app/build.gradle:
~~~
apply plugin: 'com.android.application'
android {
compileSdkVersion 19
buildToolsVersion "19.1"
defaultConfig {
applicationId "com.example.my.app"
minSdkVersion 15
targetSdkVersion 19
versionCode 1
versionName "1.0"
}
...
~~~
像以前一樣,你需要像前面的 AndroidManifest.xml 示例在 Manifest 中指定給代碼用的 “package”。
**關鍵部分**:參照上面的做法,即能解耦 **applicationId** 和 **package**。意思是你能夠完全自由地重構你的代碼,改變用于 Activity 和 Service 的內部包,改變 Manifest 的 package,重構導入語句。這都不會影響到 app 的最終 id,app 的 id 對應 Gradle 文件中 applicationId 的值。
你可以通過以下的 Gradle DSL 方法來為不同的 flavor 和 build type 定義不同的 applicationId:
app/build.gradle:
~~~
productFlavors {
pro {
applicationId = "com.example.my.pkg.pro"
}
free {
applicationId = "com.example.my.pkg.free"
}
}
buildTypes {
debug {
applicationIdSuffix ".debug"
}
}
....
~~~
(在 Android Studio 中,你可以通過 Project Structure 圖形化界面來進行這些配置。)
注意:出于兼容性考慮,如果**沒有**在 build.gradle 文件中定義 applicationId,那么 applicationId 將默認為 AndroidManifest.xml 中所指定的 package 的值。在這種情況下,applicationId 和 package 顯然未解耦,此時重構代碼也將會更改應用的 id !在 Android Studio 中,新建的項目會指定這兩個值。
注意:package 始終必須在默認 AndroidManifest.xml 文件中指定。如果存在多個 manifest(例如一個 flavor 有特定的 manifest 或一個 buildType 有特定的 manifest),package 可不指定,但如果被指定,必須和主 manifest 中指定的 package 完全相同。
- 譯者序
- 簡介
- 新構建系統的目標
- 為什么使用 Gradle?
- 配置要求
- 基礎項目
- 構建文件示例
- 項目結構
- 配置項目結構
- 構建任務
- 通用任務
- Java 項目的 Task
- Android Tasks
- 基本的構建定制
- Manifest 屬性
- 構建類型
- 簽名配置
- 運行 ProGuard
- 清理資源
- 依賴、Library 和多項目
- 包依賴
- 本地包依賴
- 遠程包依賴
- 多項目設置
- Library 項目
- 創建 Library 項目
- 普通項目和 Library 項目的區別
- 引用 Library 項目
- Library 項目發布
- 測試
- 單元測試
- 基本知識和配置
- 運行測試
- 測試 Android Library 項目
- 測試報告
- 獨立項目
- 多項目報告
- Lint 支持
- 構建 Variants(變種)版本
- 產品定制
- 構建類型+產品定制=構建變種版本
- 產品定制的配置
- 源組件和依賴
- 構建和任務
- 測試
- 多定制的變種版本
- 高級構建的自定義
- 構建選項
- Java 編譯選項
- aapt 選項
- dex 選項
- 操作 task
- 構建類型和產物定制的屬性引用
- 使用sourceCompatibility 1.7
- 附錄
- ApplicationId 與 packageName