在低版本Android上使用Material Design

譯自http://android-developers.blogspot.com/2014/10/appcompat-v21-material-design-for-pre.html—— By NashLegend

原譯文在我的github上:https://github.com/NashLegend/ProjectBabel/blob/master/Material%20Design%20for%20Pre-Lollipop%20Devices.md

這裏有個關於MaterialDesign的小例子。https://github.com/NashLegend/MaterialDesignTest

這篇只是關於在低版本上使用的方法,更詳細的見下篇:如何在你的App中應用Material Design設計風格

前排渣翻譯預警j_0009.gif,如果你能提供更好更專業的翻譯或者提出修改意見就好了……

Android 5.0已經發布,帶來了新的Material Design,這種新的設計語言提供了更好的視覺體驗。爲了使舊版本的Android系統也可以使用這種設計,我們擴展了支持包,對其中的AppCompat進行了重大更新,同時帶來了新的RecyclerVier,CardView以及Palette庫。

這篇文章中我們會介紹一下AppCompat發生了哪些新變化以及如何用它設計Material Design應用.

What's new in AppCompat?

AppCompat(又叫ActionBarCompat)爲4.0前的Android版本提供ActionBar後向兼容。而最新的AppCompat v21則可以提供Android 5.0特性支持。

在這個版本中,Android引入了新的 ToolBar控件。類似於ActionBar,但是提供了更多的控制權和靈活性。ToolBar就像其他的普通控件一樣,因此你可以容易地對其佈局、執行動畫以及與滾動事件交互。你也可以把它設置成你的Activity的ActionBar——就和原先的ActionBar一樣使用。

最新的AppCompat包含了多種Meterial Design樣式更新。比如Google I/O 2014應用就使用了這些東東.

下面是如何使用它

開始使用

如果你使用Gradle,把appcompat加入到依賴庫。修改你的build.gradle:

dependencies {
    compile "com.android.support:appcompat-v7:21.0.+"
}
如果你的App首次使用AppCompat

如果你沒用過AppCompat,那麼下面教給你:

  • 所有的Activity必須繼承ActionBarActivity,ActionBarActivity繼承自v4包的FragmentActivity,因此你仍然可以使用Fragment.

  • 所有theme必須繼承Theme.AppCompat——這個主題包含一些不同的子主題,比如LightNoActionBar

  • 如果你要inflate一些元素(比如說一個列表)以展示在ActionBar上的話,請確保你使用的是ActionBar的themed context——使用getSupportActionBar().getThemedContext()方法獲得這個context。

  • 對MenuItem進行相關操作時,必須MenuItemCompat的靜態方法

For more information, see the Action Bar API guide which is a comprehensive guide on AppCompat. 欲知更多更深入的知識,請看 ActionBar指南

如果你的App之前就使用AppCompat

對於大多數的應用來說,你只要在values/裏聲明一個主題就可以了:

values/themes.xml:

<style name="Theme.MyTheme" parent="Theme.AppCompat.Light">
    <!-- Set AppCompat’s actionBarStyle -->
    <item name="actionBarStyle">@style/MyActionBarStyle</item>

    <!-- Set AppCompat’s color theming attrs -->
    <item name=”colorPrimary”>@color/my_awesome_red</item>
    <item name=”colorPrimaryDark”>@color/my_awesome_darker_red</item>

    <!-- The rest of your attributes -->
</style>

完了你就可以把values-v14+的ActionBar樣式移除了。

設置主題

AppCompat has support for the new color palette theme attributes which allow you to easily customize your theme to fit your brand with primary and accent colors. For example: AppCompat已經支持新的color palette theme屬性,使用這些屬性,你可以很輕易地講你的應用色調與primary and accent colors搭配。舉個栗子:

values/themes.xml:

<style name="Theme.MyTheme" parent="Theme.AppCompat.Light">
    <!-- colorPrimary is used for the default action bar background -->
    <item name=”colorPrimary”>@color/my_awesome_color</item>

    <!-- colorPrimaryDark is used for the status bar -->
    <item name=”colorPrimaryDark”>@color/my_awesome_darker_color</item>

    <!-- colorAccent is used as the default value for colorControlActivated,
         which is used to tint widgets -->
    <item name=”colorAccent”>@color/accent</item>

    <!-- You can also set colorControlNormal, colorControlActivated
     colorControlHighlight, and colorSwitchThumbNormal. -->
</style>

在Android 5.0以上系統上,設置了上面這些後,跟使用了Material主題一樣了,你不必單獨設置Material主題,它會自動修改狀態欄、最近運行屏幕等的顏色。

而在早期版本中,AppCompat會儘可能的模擬Material色彩主題。現階段時能作用於ActionBar和某些組件上——也就是說,對於以前版本的Android系統來說,就算使用了AppCompat也不可能實現所有的Android 5.0樣式。

Widget着色(Widget tinting)

當設備的版本在Android 5.0以上時,所有的組件都會使用我們剛纔設置的主題顏色進行着色,這是因爲Android 5.0支持正面這兩種特性(5.0之前系統的悲劇):drawable着色(drawable tinting)和在drawable中引用主題屬性(使用?attr/xxx方式)。

對於早期版本的Android系統,AppCompat爲下列UI組件提供了類似的行爲。

AppCompat會幫助你實現這些行爲,你完全不需要插手(有些要注意的地方,看下面的FAQ)。

Toolbar組件

AppCompat支持完全特性的Toolbar組件——android.support.v7.widget.Toolbar——和Android5.0系統的Toolbar完全一樣。要兩種使用ToolBar的方式:

  • 如果你想要使用現有的ActionBar功能(比如使用菜單、ActionBarDrawerToggle等等)同時又想自己掌握它的樣式,那麼你可以把ToolBar用作ActionBar。

  • 對於一些ActionBar所不支持的場景——比如說在同一屏幕上使用多個ToolBar、使用低於屏幕寬度的尺寸的ToolBar等等(看上圖就知道了)——你就要使用ToolBar了。

Action Bar

要將ToolBar用作ActionBar,首先要禁用系統ActionBar,最方便的方式是使用Theme.AppCompat.NoActionBar主題(或者light版的NoActionBar).

然後創建一個ToolBar實例,通常是寫在XML裏。

<android.support.v7.widget.Toolbar
    android:id=”@+id/my_awesome_toolbar”
    android:layout_height=”wrap_content”
    android:layout_width=”match_parent”
    android:minHeight=”?attr/actionBarSize”
    android:background=”?attr/colorPrimary” />

寬、高、背景等你完全可以自定義;由於ToolBar只是一個ViewGroup,因此你可以任意定義它的樣式的位置。

然後在Activity裏面將ToolBar設置爲ActionBar就行了:

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.blah);

    Toolbar toolbar = (Toolbar) findViewById(R.id.my_awesome_toolbar);
    setSupportActionBar(toolbar);
}

然後options menu就會顯示在ToolBar上了。

Standalone

standalone模式與actionbar模式的不同是你不必setSupportActionBar了,把它當一個普通組件看待就好,也不必非得把ActionBar給禁用了。

standalone模式下,你就得手動設置ToolBar的內容和動作了。比如說,如果你想讓它顯示一個動作按鈕(就像Actoinbar一樣,但不是actionbar模式),你可以這麼做:

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.blah);

    Toolbar toolbar = (Toolbar) findViewById(R.id.my_awesome_toolbar);

    // Set an OnMenuItemClickListener to handle menu item clicks
    toolbar.setOnMenuItemClickListener(new Toolbar.OnMenuItemClickListener() {
        @Override
        public boolean onMenuItemClick(MenuItem item) {
            // Handle the menu item
            return true;
        }
    });

    // Inflate a menu to be displayed in the toolbar
    toolbar.inflateMenu(R.menu.your_toolbar_menu);
}

ToolBar還支持很多其他功能,欲知更多,請查看它的API

Styling

ToolBar的樣式的設置方式和標準的ActionBar是不一樣的,ToolBar的樣式是直接設置在這個View上的。

下面是一個要作爲ActionBar使用的ToolBar的基本樣式。

<android.support.v7.widget.Toolbar  
    android:layout_height="wrap_content"
    android:layout_width="match_parent"
    android:minHeight="?attr/actionBarSize"
    app:theme="@style/ThemeOverlay.AppCompat.ActionBar" />

app:theme可以確保你的文本的裏面的items使用solid colors。

DarkActionBar

你也可以直接通過而已屬性設置ToolBar的Style。要得到一個看起來像'DarkActionBar'(深色內容、淺色菜單)樣式的ToolBar,可以像下面設置theme和popupTheme屬性:

<android.support.v7.widget.Toolbar
    android:layout_height=”wrap_content”
    android:layout_width=”match_parent”
    android:minHeight=”@dimen/triple_height_toolbar”
    app:theme="@style/ThemeOverlay.AppCompat.Dark.ActionBar"
    app:popupTheme="@style/ThemeOverlay.AppCompat.Light" />

SearchView Widget

AppCompat提供了最新與Lollipop一樣的SearchView樣式和API,使其具有更強的可定製性(此處應該有掌聲).

你應該這樣定義SearchView的樣式:

values/themes.xml:
<style name=”Theme.MyTheme” parent=”Theme.AppCompat”>
    <item name=”searchViewStyle”>@style/MySearchViewStyle</item>
</style>
<style name=”MySearchViewStyle” parent=”Widget.AppCompat.SearchView”>
    <!-- Background for the search query section (e.g. EditText) -->
    <item name="queryBackground">...</item>
    <!-- Background for the actions section (e.g. voice, submit) -->
    <item name="submitBackground">...</item>
    <!-- Close button icon -->
    <item name="closeIcon">...</item>
    <!-- Search button icon -->
    <item name="searchIcon">...</item>
    <!-- Go/commit button icon -->
    <item name="goIcon">...</item>
    <!-- Voice search button icon -->
    <item name="voiceIcon">...</item>
    <!-- Commit icon shown in the query suggestion row -->
    <item name="commitIcon">...</item>
    <!-- Layout for query suggestion rows -->
    <item name="suggestionRowLayout">...</item>
</style>

你不必設置所有上面的屬性,甚至一個都不設置也行,默認的就很不錯。

結語

希望這篇文章能讓你學會使用AppCompat並開發出牛逼的Material Design風格的app。

FAQ

爲啥我的老Android系統上的EditText(或者上面提到的支持的控件)長得不像Material風格呢?

AppCompat的工作原理是攔截layout inflation並且在對應的位置插件一個特殊的可使用Material樣式的組件(tint-aware version of the widget)來實現的。對於大部分人來說這應該沒啥問題,但是下面幾種情況有可能導致一些問題:

  • 你使用自己的自定義的widget(比如使用的自定義的繼承了EditText的類)。

  • 你創建EditText的時候沒有給它LayoutInflater(比如直接New EditText())

這些特殊的組件目前被我們藏起來了,因爲還沒有完全做完。以後可能會好點……

爲何某某組件在我的老Android系統上長得不像Material風格?

目前AppCompat只支持常用的組件的Material主題,其他的以後會有的。

爲啥我的ActionBar在Android 5.0上的陰影,我已經把android:windowContentOverlay設置爲null了啊?

Android 5.0上,ActionBar的陰影是由最新的elevation API提供的。如果不想要它,可以使用getSupportActionBar().setElevation(0)方法,或者在Action Bar style裏面修改elevation屬性。

爲啥我的老版本Android沒有波紋效果?

這東西只有用Android 5.0最新的RenderThread才能跑流暢,爲了不讓你卡出翔,我們現在還是先不給老版本支持這玩意兒。

我使用了AppCompat後還能用Preference麼?

在API v11+版本的機器上,你仍然可以在ActionBarActivity中使用PreferenceFragment。對於更老的老爺機來說,你只能使用普通的非Material樣式的PreferenceActivity。

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