Android官方技術文檔翻譯——ApplicationId 與 PackageName

本文譯自androd官方技術文檔《ApplicationId versus PackageName》，原文位址：http://tools.android.com/tech-docs/new-build-system/applicationid-vs-packagename。

本文位址：http://blog.csdn.net/maosidiaoxian/article/details/41719357。轉載請注明出處。翻譯如有錯訛，敬請指正。

所有的 Android 應用程式都有一個包名。包名是裝置上的這個應用程式的唯一辨別，也是在谷歌Play商店上的唯一辨別。這意味着，一旦你已釋出的程式使用了這個包名， 你就永遠都無法改變它；如果修改了就會導緻你的應用程式被當作是一個全新的應用程式，你之前的應用程式的使用者也不能更新到使用了新的包名的安裝包。

在此前的 Android Gradle 建構系統中，您的應用程式的包名由你的manifest檔案的根元素裡的package屬性決定：

AndroidManifest.xml:

<code></code>

<code>&lt;manifest xmlns:android="http://schemas.android.com/apk/res/android"</code>

<code>    </code><code>package="com.example.my.app"</code>

<code>    android:versionCode="1"</code>

<code>    android:versionName="1.0" &gt;</code>

然而，這裡所定義的包也有第二個目的：它被用來命名你的資源類的包（以及解析任何相關的Activity的類名）。在上面的示例中，生成的 R 類将會是<code>com.example.my.app.R</code>，是以如果您其他包裡面的代碼需要引用這些資源，就需要導入com.example.my.app.R。

使用新的 Android Gradle 建構系統，你可以輕松建構多個不同版本的應用程式；例如，您可以建構一個“free”版本和“pro”版本的應用程式 （通過使用flavors），并且這些不同版本的程式在 Google Play 商店上應該有不同的包，這樣他們可以被單獨安裝和購買，或者是同時安裝兩個，等等。同樣，您還可以同時建立“debug”、“alpha”和“beta”版本的應用程式 （使用build types），而這些版本的程式同樣可以使用唯一的包名。

同時，您想要在代碼中導入的 R 類必須在這段時間内保持不變 ；在您正在建構您的應用程式的不同版本時您的.java 源檔案不應該被更改。

是以，我們解耦了包名稱的兩種用法：

最終的方案是，在您生成的.apk 的manifest 中，并且用于在你的裝置和 Google Play 商店來辨別你的應用的包，叫做“application id”。

用于在源代碼中來引用您的R類的，并且是解析任何相關的Activity/Service 注冊的包，繼續被稱為“package”。

你可以在你 gradle 檔案中，指定application id，如下所示：

app/build.gradle:

<code>apply plugin: 'com.android.application'</code>

<code>android {</code>

<code>    compileSdkVersion 19</code>

<code>    buildToolsVersion "19.1"</code>

<code>    defaultConfig {</code>

<code>        </code><code>applicationId "com.example.my.app"</code>

<code>        minSdkVersion 15</code>

<code>        targetSdkVersion 19</code>

<code>        versionCode 1</code>

<code>        versionName "1.0"</code>

<code>    }</code>

<code>    ...</code>

像以前一樣，你需要在 Manifest 檔案中指定用于代碼的包，就如上面的Andr​​oidManifest.xml示例一樣。

這裡說到了最關鍵的部分：當你像上面那樣做時，這兩個包是互相獨立的。你能夠完全自由地重構您的代碼——更改用于Activity和Service的内部包，更新你的Manifest裡的包，和重構您的導入語句。這都不會影響到你的程式的最終id，這個最終的id的值總是為你的Gradle檔案中指定的applicationId的值。（筆者注：packageName在代碼中使用，通常在AndroidManifest.xml中指定，applicationId則隻是用于程式的辨別，通常在build.gradle中指定。這樣有一個好處，假如你想釋出一個免費版，一個收費版，你隻需要在build.gradle中把applicationId後面加上免費版的字尾包名（如".free"），收費版加上收費版的字尾即可，而不需要修改你的其他代碼。）

你可以通過使用以下的 Gradle DSL 方法，為不同的flavors和建構類型修改您的應用程式的 applicationId：

<code>    productFlavors {</code>

<code>        pro {</code>

<code>            </code><code>applicationId = "com.example.my.pkg.pro"</code>

<code>        }</code>

<code>        free {</code>

<code>            </code><code>applicationId = "</code><code>com.example.my.pkg</code><code>.free"</code>

<code>    buildTypes {</code>

<code>        debug {</code>

<code>            </code><code>applicationIdSuffix ".debug"</code>

<code>    ....</code>

（在 Android Studio 中，您也可以在項目結構對話框中圖形化地進行這些配置。）

注意： 出于相容性原因，如果您沒有在您的 build.gradle 檔案中定義 applicationId，這個applicationId 将預設為 AndroidManifest.xml 中所指定的相同的值。在這種情況下，這兩個顯然未解耦，并且如果你試圖重構您的代碼也将會意外地更改您的應用程式的 id ！在 Android Studio 中，建立的項目始終會指定這兩個值。

注 2： 包名稱必須始終在預設 AndroidManifest.xml 檔案中指定。如果您有多個manifest （例如一個 flavor 的特定的manifest或一個 buildType 的特定的manifest），該包名是可選的，但如果它被指定了，它必須和主manifest中指定的包完全相同。