API 19、21模拟器中CardView显示灰色的原因排查求助

这问题我之前做项目时也踩过坑，其实根源是CardView在不同Android版本上的默认背景行为差异，具体原因和解决方法如下：

问题原因 #

在Android 5.0（API 21）及以上系统中，CardView使用原生的elevation属性实现阴影效果，默认背景色是白色；但在API 21以下的系统（比如你用的API 19），CardView是通过模拟阴影图层来实现卡片视觉效果的，它的默认背景色并不是白色，而是继承自系统主题的灰色调，这就导致了低版本模拟器里卡片变灰、高版本显示正常的情况。

解决方案（两种可选） #

1. 直接给CardView设置专属背景色（推荐）

在你的CardView布局标签中添加app:cardBackgroundColor属性，明确指定白色背景。这个属性是CardView的专属属性，能完美适配卡片的圆角和阴影效果，不会出现普通android:background可能导致的样式冲突：

<android.support.v7.widget.CardView 
    xmlns:android="http://schemas.android.com/apk/res/android" 
    xmlns:app="http://schemas.android.com/apk/res-auto" 
    android:layout_width="match_parent" 
    android:layout_height="wrap_content" 
    android:layout_margin="8dp"
    app:cardBackgroundColor="@android:color/white"> <!-- 新增这一行 -->

    <RelativeLayout 
        android:layout_width="match_parent" 
        android:layout_height="wrap_content" 
        android:gravity="center" 
        android:orientation="vertical">

        <TextView 
            android:id="@+id/text_view_name" 
            android:layout_width="wrap_content" 
            android:layout_height="wrap_content" 
            android:layout_alignParentTop="true" 
            android:layout_centerHorizontal="true" 
            android:layout_marginBottom="8dp" 
            android:layout_marginTop="8dp" 
            android:text="Name" 
            android:textColor="@android:color/black" 
            android:textSize="20sp" />

        <ImageView 
            android:id="@+id/image_view_upload" 
            android:layout_width="match_parent" 
            android:layout_height="200dp" 
            android:layout_below="@+id/text_view_name" />

    </RelativeLayout>
</android.support.v7.widget.CardView>

2. 通过主题统一设置所有CardView的样式

如果你希望项目里所有CardView都用浅色背景，可以在App的主题样式（比如styles.xml中的AppTheme）里添加以下配置：

<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
    <!-- 其他主题属性 -->
    <item name="cardViewStyle">@style/CardView.Light</item>
</style>

这样所有CardView都会自动使用浅色背景，不用逐个布局修改。

注意事项 #

别用android:background来设置CardView的背景，因为这会覆盖CardView自带的圆角和阴影图层，尤其是在低版本系统上，会导致卡片的视觉效果失效。

内容的提问来源于stack exchange，提问作者Florian Walther