原文：Understanding App Resources

—Understanding Strings and Resources

概述

在Android中，幾乎一切事物都是資源。定義在應用程序中可訪問的資源，是Android開發(fā)的一個重要部分。

資源用于定義顏色、圖像、布局、菜單和字符串值。這樣做的意義是可以使不良的“硬編碼”習慣消失。所有內容分別定義在這些資源文件中，可以被應用程序中的代碼引用。這些資源最簡單和最常見的用法是使用字符串資源，實現(xiàn)靈活的本地化文本。

資源類型

以下是Android應用中最常用的資源類型：

另外，注意以下定義在values文件夾下的關鍵文件:

想了解資源類型的完整列表，請參考Providing a Resource指南。

為應用提供資源

定義字符串資源

對于你要在應用中展示的每一段文本（例如按鈕的標簽或TextView上的文字），你應該先將文本定義在res/values/strings.xml文件中。每個條目包含一個“鍵”（代表文本的標識）和一個“值”（文本本身）。例如，如果你想在按鈕上展示“Submit”，你應該想如下的字符串資源添加到res/values/strings.xml文件中：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="hello">Hello!</string>
    <string name="submit_label">Submit</string>
</resources>

現(xiàn)在我如果引用了submit_label字符串資源，默認地將會顯示“Submit”。稍后，你可以創(chuàng)建全匹配的資源文件,以針對不同的系統(tǒng)語言或設備更改此值。我們還可以使用CDATA來轉義字符串，以存儲更復雜的字符串（帶有html標簽或特殊字符），例如：

<?xml version="1.0" encoding="utf-8"?>
<resources>
  <string name="feedback_label">
  <![CDATA[
    Please <a >let us know</a> if you have feedback on this or if 
    you would like to log in with another identity service. Thanks! This is a longer string!  
  ]]>
  </string>
</resources>

對于字符串資源定義的更多細節(jié)，請參考本篇指南。你還可以參考指南中的樣式資源和其他資源類型。

在應用中引用資源

既然我們已經定義好了自己的字符串資源，我們就能夠在Java代碼或者XML布局文件中訪問這些資源。要在XML布局文件中訪問資源，要使用@語法：

<Button
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:text="@string/submit_label" />

要在Java代碼中直接訪問資源，需要使用getResources.getString 或 getString 方法，訪問給定資源ID的值：

String submitText = getResources().getString(R.string.submit_label)

字符串值將會被檢索。其他資源類型也采用了類似的工作機制，比如Drawable和Color等。getResourses()方法返回一個包含許多資源提取方法的Resources對象。每一種資源定義在res目錄下的不同文件夾和文件中，這由它們的具體類型所決定。

定義顏色資源

除了上邊展示的字符串資源，還有以下常見的資源類型。首先，讓我們看一下用于定義整個應用中所有顏色的顏色資源文件。顏色資源在res/values/colors.xml中定義，XML文件的樣式如下所示：

<?xml version="1.0" encoding="utf-8"?>
<resources>
   <color name="white">#FFFFFF</color>
   <color name="yellow">#FFFF00</color>
   <color name="fuchsia">#FF00FF</color>
</resources>

顏色資源可以在Java代碼中訪問：

// getResources().getColor()：該方法目前被廢棄
// Resources res = getResources();
// int color = res.getColor(R.color.yellow); 

// 使用ContextCompatResources
int color = ContextCompat.getColor(context, R.color.yellow);

值得注意的是，當前最新的訪問顏色資源的方式（自從API 24開始），要求提供context來解析自定義的Theme屬性。參閱這篇文章了解更多的相關內容。

并且在XML布局中的任意View引用顏色資源如下所示：

<TextView
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:textColor="@color/fuchsia"
    android:text="Hello"/>

&esmp;這是關于顏色資源你所要知道的全部內容，一定不要在布局文件中使用“硬編碼”的顏色值。

定義尺寸資源

接下來，我們來看一下用于定義整個應用中所有尺寸大小的尺寸資源文件。一個尺寸由一個數(shù)字后邊跟測量單位來指定。例如10px，5sp。尺寸資源在res/values/dimens.xml文件中定義，XML文件中的樣式如下所示：

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <dimen name="textview_height">25dp</dimen>
    <dimen name="textview_width">150dp</dimen>
    <dimen name="ball_radius">30dp</dimen>
    <dimen name="font_size">16sp</dimen>
</resources>

尺寸資源可以在Java代碼中訪問：

Resources res = getResources();
float fontSize = res.getDimension(R.dimen.font_size);

并且在XML布局中的任意View引用尺寸資源如下所示：

<TextView
    android:layout_height="@dimen/textview_height"
    android:layout_width="@dimen/textview_width"
    android:textSize="@dimen/font_size"/>

這是關于尺寸資源你所要了解的全部內容。一定要以這種方式定義字體大小、內間距和外邊距值，避免“硬編碼”方式出現(xiàn)。這是有關的其他資源類型。

動態(tài)資源檢索

在某些情況下，你可能想通過鍵名稱而非“硬編碼”的資源ID來動態(tài)檢索資源。例如，假設我想通過單獨的鍵名稱來檢索“submit_label”字符串，就可以通過Activity中的getIdentifier方法實現(xiàn)：

public String getStringValue(String key) {
    //檢索資源ID
    String packageName = getBaseContext().getPackageName();
    Resources resources = getBaseContext().getResources();
    int stringId = resources.getIdentifier(key, "string", packageName);
    if (stringId == 0) { return null; }
    //基于資源ID返回字符串值
    return resources.getString(stringId);
}

現(xiàn)在你就可以動態(tài)的引用字符串資源了：

public String myKey = "submit_label"; // 映射到R.string.submit_label
public String myStringValue = getStringValue(myKey); // Returns string text

類似的方法也能被用在其他類型的資源上。例如，通過字符串類型的ID動態(tài)檢索View：

// getViewById("tvTest");
public View getViewById(String id) {
    //檢索資源ID
    String packageName = getBaseContext().getPackageName();
    Resources resources = getBaseContext().getResources();
    int viewId = resources.getIdentifier(id, "id", packageName);
    if (viewId == 0) { return null; }
    return findViewById(viewId);
}

查看getResources對象和<a href="http://developer.android.com/reference/android/content/res/Resources.html#getIdentifier(java.lang.String, java.lang.String, java.lang.String)">getIdentifier</a>獲取更多詳細信息。

提供可替代的資源

響應式設計

為了實現(xiàn)出色的UI設計，對于Android開發(fā)者來說，創(chuàng)建可在多種類型的備上正常工作的應用是非常重要的。為實現(xiàn)這個目的，我們首先要根據(jù)屏幕尺寸將Android設備分為以下不同的種類：

應用必須設計成可在多種不同的屏幕密度和屏幕尺寸上正常運行。這可借助于Android框架提供的各種系統(tǒng)實現(xiàn)。

介紹可替代資源

開發(fā)者能夠使用的強大開發(fā)工具之一是，可根據(jù)特定的限定符如手機尺寸，系統(tǒng)語言，屏幕密度等提供“替代資源”。替代資源的常見用途包括：

• 用于不同外形設備的替代布局文件（如手機VS平板）
• 用于不同系統(tǒng)語言的替代字符串資源（如英語VS意大利語）
• 用于不同屏幕密度的替代圖像資源
• 用于不同平臺版本的替代樣式資源（Holo VS Material）
• 用于不同屏幕方向的替代布局文件（portrait VS landscape）

要為一組資源指定基于特定配置下的替代資源，我們在res中以[資源類型]-[限定符]的形式創(chuàng)建一個新的目錄。一個最佳的實踐是確保為多種密度的屏幕提供了所有可適配的圖像。

多種屏幕密度

這是通過包含具有相同圖像不同版本的res/drawable-hdpi, res/drawable-xhdpi, and res/drawable-xxhdpi文件夾實現(xiàn)的。正確的資源會根據(jù)設備的屏幕密度被系統(tǒng)自動選中。目錄的列表展開可能會如下所示：

res/
    drawable/   
        icon.png
        background.png    
    drawable-hdpi/  
        icon.png
        background.png

注意所有不同文件夾下的資源文件都要有相同的名字。該系統(tǒng)適用于具有限定符的任意類型的資源。

理解限定符

Android支持多種限定符的配置，并且可以使用短線分隔限定符的方式，將多個限定符添加到一個目錄名稱。常用的限定符如下所示：

你可以為單獨的一組資源，使用短線分隔方式指定多個限定符。例如，drawable-en-sw600dp-land用于英文系統(tǒng)的橫屏模式下的平板設備。注意如果你對一個資源目錄使用了多個限定符，在將它們添加到目錄名中時一定要按照上表中所列出的順序。參閱完整限定符集的官方文檔。

創(chuàng)建可替代資源

在Android Studio中，創(chuàng)建可替代資源最簡單的方式是在Android項目邊欄中的資源子目錄上右擊（例如layout），使用New => Layout resource file方法指定你期望的限定符（例如orientation）：

這將會創(chuàng)建兩個版本的布局文件，一個用于豎屏模型，一個用于橫屏模式。如果你為第二個版本的布局文件添加了不同的標簽，在屏幕方向旋轉時你將發(fā)現(xiàn)這個效果會自動觸發(fā)：

總結一下，你可以創(chuàng)建適用于不同情景下的多個資源文件版本，最合適的版本會被系統(tǒng)自動選中使用。

在運行時確定配置

當應用正在運行時，我們可以通過Activity或Context對象的getResources().getConfiguration()方法訪問Configuration對象來檢測當前的配置（方向，屏幕尺寸等）。例如，想要確定Activity中的屏幕方向（橫屏或豎屏），我們通過以下方式實現(xiàn)：

String image;
int orientation = getResources().getConfiguration().orientation;
if (orientation == Configuration.ORIENTATION_PORTRAIT) {
   image = "image_portrait.png";
   // ...
} else if (orientation == Configuration.ORIENTATION_LANDSCAPE) {
   image = "image_landscape.png";
   // ...
}

類似地我們可通過訪問一個Context對象在任何對象中訪問它。例如，在ArrayAdapter中使用getContext().getResources().getConfiguration()方法獲取配置。

備用布局文件

通常，替代資源用于為手機和平板指定不同的布局文件。這可以通過使用“最小寬度”限定符sw實現(xiàn)。文件夾結構可能設置如下：

res/
    layout/   
        activity_main.xml
        item_photo.xml    
    layout-sw600dp/ 
        activity_main.xml
    layout-sw600dp-land/
        activity_main.xml 
    layout-sw720dp/ 
        activity_main.xml
        item_photo.xml
    layout-land/
        activity_main.xml
        item_photo.xml

一般來說，手機和平板在sw240和sw480之間。7英寸平板為sw600，10英寸平板為sw720。你也可以簡單地添加限定符如layout-land，以橫屏模式應用于所有設備。這是針對上述說明的一個例子：

有關如何管理平板設備的響應式布局的指南，請參閱靈活的用戶接口指南。你也可以參閱這篇文章UI設計最佳實踐和有關資源的官方文檔 獲取更多細節(jié)信息。

最佳布局實踐

這有一個快速檢查清單，可確保你的應用可以在不同的屏幕上正常展示：

• 避免在應用代碼中使用硬編碼的像素值
• 合理使用RelativeLayout，絕不使用AbsoluteLayout
• 指定尺寸值時，使用wrap_content, match_parent, 或 dp 單位
• 為確保響應式的設計，使用替代布局和圖像資源

在官方指南上查看屏幕獨立性的其他最佳實踐。

資源別名

當你想在多個設備配置中使用同一個資源時，你不必將同一個資源文件在替代資源文件夾中拷貝多份。相反，你可以創(chuàng)建替代資源，作為保存在默認資源目錄中的資源別名。

最佳資源匹配

當你請求替代資源時，Android會基于當前設備的配置在運行時選擇替代資源。參閱 官方資源指南了解匹配資源如何被選中的詳細概述。

參考引用

• http://developer.android.com/guide/topics/resources/string-resource.html
• http://developer.android.com/guide/topics/resources/accessing-resources.html
• http://mobile.tutsplus.com/tutorials/android/android-string/
• http://developer.android.com/guide/topics/resources/providing-resources.html
• http://developer.android.com/training/multiscreen/screendensities.html
• http://www.evoketechnologies.com/blog/effective-ui-design-tips-android-devices/
• http://www.androiddesignpatterns.com/2016/08/contextcompat-getcolor-getdrawable.html/