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。轉載請註明出處。翻譯如有錯訛,敬請指正。

ApplicationId 與 PackageName
所有的 Android 應用程序都有一個包名。包名是設備上的這個應用程序的唯一標識,也是在谷歌Play商店上的唯一標識。這意味着,一旦你已發佈的程序使用了這個包名, 你就永遠都無法改變它;如果修改了就會導致你的應用程序被當作是一個全新的應用程序,你之前的應用程序的用戶也不能更新到使用了新的包名的安裝包。

在此前的 Android Gradle 構建系統中,您的應用程序的包名由你的manifest文件的根元素裏的package屬性決定:

AndroidManifest.xml:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.my.app"
    android:versionCode="1"
    android:versionName="1.0" >

然而,這裏所定義的包也有第二個目的:它被用來命名你的資源類的包(以及解析任何相關的Activity的類名)。在上面的示例中,生成的 R 類將會是com.example.my.app.R,因此如果您其他包裏面的代碼需要引用這些資源,就需要導入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:
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"
    }
    ...

像以前一樣,你需要在 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:

app/build.gradle:
    productFlavors {
        pro {
            applicationId = "com.example.my.pkg.pro"
        }
        free {
            applicationId = "com.example.my.pkg.free"
        }
    }

    buildTypes {
        debug {
            applicationIdSuffix ".debug"
        }
    }
    ....

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

注意: 出於兼容性原因,如果您沒有在您的 build.gradle 文件中定義 applicationId,這個applicationId 將默認爲 AndroidManifest.xml 中所指定的相同的值。在這種情況下,這兩個顯然未解耦,並且如果你試圖重構您的代碼也將會意外地更改您的應用程序的 id !在 Android Studio 中,新建的項目始終會指定這兩個值。

注 2: 包名稱必須始終在默認 AndroidManifest.xml 文件中指定。如果您有多個manifest (例如一個 flavor 的特定的manifest或一個 buildType 的特定的manifest),該包名是可選的,但如果它被指定了,它必須和主manifest中指定的包完全相同。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章