1page.title=維持相容性 2 3@jd:body 4 5<div id="tb-wrapper"> 6<div id="tb"> 7<h2>本課程示範</h2> 8<ol> 9 <li><a href="#Theme">定義替代樣式</a></li> 10 <li><a href="#Layouts">提供替代版面配置</a></li> 11 <li><a href="#SupportLib">使用支援程式庫</a></li> 12 <li><a href="#CheckVersion">檢查系統版本</a></li> 13</ol> 14<h2>您也應該閱讀</h2> 15<ul> 16 <li><a href="http://www.google.com/design/spec">材料設計規格</a></li> 17 <li><a href="{@docRoot}design/material/index.html">Android 上的材料設計</a></li> 18</ul> 19</div> 20</div> 21 22 23<p>某些材料設計功能如材料設計風格和自訂操作行為轉換等，只能在 Android 5.0 (API 級別 21) 及以上版本中使用。 24然而，您還是可以將應用程式設計為在支援材料設計的裝置上執行時才使用這些功能，並仍然與執行舊版 Android 的裝置相容。 25 26</p> 27 28 29<h2 id="Theme">定義替代樣式</h2> 30 31<p>您可以設定應用程式在支援材料設計風格的裝置上執行時才予以使用，在執行舊版 Android 的裝置上執行時則轉換成舊版的設計風格： 32</p> 33 34<ol> 35<li>在 <code>res/values/styles.xml</code> 中定義繼承自舊版設計風格 (例如 Holo) 的設計風格。 36</li> 37<li>在 <code>res/values-v21/styles.xml</code> 中定義與材料設計風格相同名稱的設計風格。 38</li> 39<li>在宣示說明檔案中將此設計風格設定為應用程式的設計風格。</li> 40</ol> 41 42<p class="note"><strong>注意</strong>：若您的應用程式使用材料設計風格，但卻未以此方式提供替代設計風格，您的應用程式將無法在 Android 5.0 之前的版本上執行。 43 44 45</p> 46 47 48<h2 id="Layouts">提供替代版面配置</h2> 49 50<p>若您根據材料設計指南所設計的版面配置並未使用任何 Android 5.0 (API 級別 21) 中推出的全新 XML 屬性，則這些版面配置就可以在舊版 Android 上運作。 51 52或者，您也可以提供替代的版面配置。您也可提供替代的版面配置以自訂應用程式在舊版 Android 上如何顯示。 53</p> 54 55<p>在 <code>res/layout-v21/</code> 內建立 Android 5.0 (API 級別 21) 的版面配置檔案，並在 <code>res/layout/</code> 內建立舊版 Android 的替代版面配置檔案。例如，<code>res/layout/my_activity.xml</code> 是 <code>res/layout-v21/my_activity.xml</code> 的替代版面配置。 56 57 58</p> 59 60<p>為了避免程式碼重複，請在 <code>res/values/</code> 內定義您的樣式，在 <code>res/values-v21/</code> 中針對新的 API 修改樣式，再使用樣式繼承，在 <code>res/values/</code> 中定義基礎樣式，然後從 <code>res/values-v21/</code> 中的樣式繼承。 61 62</p> 63 64 65<h2 id="SupportLib">使用支援程式庫</h2> 66 67<p><a href="{@docRoot}tools/support-library/features.html#v7">v7 支援程式庫</a> r21 以及更新版本包含下列材料設計功能： 68</p> 69 70<ul> 71<li>當您套用其中一個 <code>Theme.AppCompat</code> 設計風格時，某些系統小工具的<a href="{@docRoot}training/material/theme.html">材料設計樣式</a>。 72</li> 73<li>在 <code>Theme.AppCompat</code> 設計風格中的<a href="{@docRoot}training/material/theme.html#ColorPalette">色板設計風格屬性</a>。 74</li> 75<li><a href="{@docRoot}training/material/lists-cards.html#RecyclerView">顯示資料集合</a>的 {@link android.support.v7.widget.RecyclerView} 小工具。 76</li> 77<li><a href="{@docRoot}training/material/lists-cards.html#CardView">建立卡片</a>的 {@link android.support.v7.widget.CardView} 小工具。</li> 78<li><a href="{@docRoot}training/material/drawables.html#ColorExtract">從影像提取顯著顏色</a>的 {@link android.support.v7.graphics.Palette} 類別。 79</li> 80</ul> 81 82<h3>系統小工具</h3> 83 84<p><code>Theme.AppCompat</code> 設計風格提供下列小工具的材料設計樣式：</p> 85 86<ul> 87 <li>{@link android.widget.EditText}</li> 88 <li>{@link android.widget.Spinner}</li> 89 <li>{@link android.widget.CheckBox}</li> 90 <li>{@link android.widget.RadioButton}</li> 91 <li>{@link android.support.v7.widget.SwitchCompat}</li> 92 <li>{@link android.widget.CheckedTextView}</li> 93</ul> 94 95<h3>色板</h3> 96 97<p>如果要取得材料設計樣式並使用 Android v7 支援程式庫自訂色板，請套用其中一個 <code>Theme.AppCompat</code> 設計風格： 98</p> 99 100<pre> 101<!-- extend one of the Theme.AppCompat themes --> 102<style name="Theme.MyTheme" parent="Theme.AppCompat.Light"> 103 <!-- customize the color palette --> 104 <item name="colorPrimary">@color/material_blue_500</item> 105 <item name="colorPrimaryDark">@color/material_blue_700</item> 106 <item name="colorAccent">@color/material_green_A200</item> 107</style> 108</pre> 109 110<h3>清單和卡片</h3> 111 112<p>在舊版 Android 中，透過 Android v7 支援程式庫可以使用 {@link android.support.v7.widget.RecyclerView} 和 {@link 113android.support.v7.widget.CardView} 小工具，但有下列限制： 114</p> 115<ul> 116<li>{@link android.support.v7.widget.CardView} 只能使用額外的填補方式，有計畫地實作陰影。 117</li> 118<li>{@link android.support.v7.widget.CardView} 不會裁剪與圓形邊角重疊的下方視圖。 119</li> 120</ul> 121 122 123<h3>相依性</h3> 124 125<p>如果要在 Android 5.0 (API 級別 21) 以前的版本中使用這些功能，請在您的專案中包含 Android v7 支援程式庫做為 <a href="{@docRoot}sdk/installing/studio-build.html#dependencies">Gradle 相依性</a>： 126</p> 127 128<pre> 129dependencies { 130 compile 'com.android.support:appcompat-v7:21.0.+' 131 compile 'com.android.support:cardview-v7:21.0.+' 132 compile 'com.android.support:recyclerview-v7:21.0.+' 133} 134</pre> 135 136 137<h2 id="CheckVersion">檢查系統版本</h2> 138 139<p>下列功能只能在 Android 5.0 (API 級別 21) 以及更新版本中使用：</p> 140 141<ul> 142<li>操作行為轉換</li> 143<li>輕觸回饋</li> 144<li>顯示動畫</li> 145<li>路徑型動畫</li> 146<li>矢量可繪</li> 147<li>繪製著色</li> 148</ul> 149 150<p>如要維持與舊版 Android 的相容性，在呼叫這些功能的 API 之前，請先在執行期間檢查系統 {@link 151android.os.Build.VERSION#SDK_INT version}： 152</p> 153 154<pre> 155// Check if we're running on Android 5.0 or higher 156if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) { 157 // Call some material design APIs here 158} else { 159 // Implement this feature without material design 160} 161</pre> 162 163<p class="note"><strong>注意：</strong>如果要指定應用程式支援的 Android 版本，請在您的宣示說明檔案中使用 <code>android:minSdkVersion</code> 和 <code>android:targetSdkVersion</code> 屬性。 164 165如果要在 Android 5.0 中使用材料設計功能，請將 <code>android:targetSdkVersion</code> 屬性設定為 <code>21</code>。 166如需詳細資訊，請參閱 <a href="{@docRoot}guide/topics/manifest/uses-sdk-element.html"><uses-sdk> API 指南</a>。 167 168</p> 169