Android Studio集成TextInputLayout时因缺失颜色资源实例化失败

问题描述 #

我在Android应用中集成com.google.android.material.textfield.TextInputLayout组件，已在XML文件中为邮箱、用户名、密码对应的EditText添加相关代码，也在build.gradle中添加了依赖，但出现类无法实例化的问题，目标界面无法显示。错误日志如下：

android.content.res.Resources$NotFoundException: 在当前配置中找不到匹配值0x7F06FF0A（解析名称：purple_500）的颜色资源。
    at android.content.res.Resources_Delegate.throwException(Resources_Delegate.java:1161)
    at android.content.res.Resources_Delegate.throwException(Resources_Delegate.java:1137)
    at android.content.res.Resources_Delegate.throwException(Resources_Delegate.java:1141)
    at android.content.res.Resources_Delegate.getColorStateList(Resources_Delegate.java:264)
    at android.content.res.Resources.getColorStateList(Resources.java:1126)
    at androidx.core.content.res.ResourcesCompat$Api23Impl.getColorStateList(ResourcesCompat.java:688)
    at androidx.core.content.res.ResourcesCompat.getColorStateList(ResourcesCompat.java:244)
    at androidx.core.content.ContextCompat.getColorStateList(ContextCompat.java:519)
    at androidx.appcompat.content.res.AppCompatResources.getColorStateList(AppCompatResources.java:48)
    at androidx.appcompat.widget.TintTypedArray.getColorStateList(TintTypedArray.java:179)
    at com.google.android.material.textfield.TextInputLayout.<init>(TextInputLayout.java:649)
    at com.google.android.material.textfield.TextInputLayout.<init>(TextInputLayout.java:446)
    at java.base/jdk.internal.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method)
    at java.base/jdk.internal.reflect.NativeConstructorAccessorImpl.newInstance(NativeConstructorAccessorImpl.java:62)
    at java.base/jdk.internal.reflect.DelegatingConstructorAccessorImpl.newInstance(DelegatingConstructorAccessorImpl.java:45)
    at java.base/java.lang.reflect.Constructor.newInstance(Constructor.java:490)
    at org.jetbrains.android.uipreview.ViewLoader.createNewInstance(ViewLoader.java:351)
    at org.jetbrains.android.uipreview.ViewLoader.loadClass(ViewLoader.java:200)
    at org.jetbrains.android.uipreview.ViewLoader.loadView(ViewLoader.java:161)
    at com.android.tools.idea.rendering.LayoutlibCallbackImpl.loadView(LayoutlibCallbackImpl.java:294)
    at android.view.BridgeInflater.loadCustomView(BridgeInflater.java:417)
    at android.view.BridgeInflater.loadCustomView(BridgeInflater.java:428)
    at android.view.BridgeInflater.createViewFromTag(BridgeInflater.java:332)
    at android.view.LayoutInflater.createViewFromTag(LayoutInflater.java:965)
    at android.view.LayoutInflater.rInflate_Original(LayoutInflater.java:1127)
    at android.view.LayoutInflater_Delegate.rInflate(LayoutInflater_Delegate.java:72)
    at android.view.LayoutInflater.rInflate(LayoutInflater.java:1101)
    at android.view.LayoutInflater.rInflateChildren(LayoutInflater.java:1088)
    at android.view.LayoutInflater.inflate(LayoutInflater.java:686)
    at android.view.LayoutInflater.inflate(LayoutInflater.java:505)
    at com.android.layoutlib.bridge.impl.RenderSessionImpl.inflate(RenderSessionImpl.java:359)
    at com.android.layoutlib.bridge.Bridge.createSession(Bridge.java:436)
    at com.android.tools.idea.layoutlib.LayoutLibrary.createSession(LayoutLibrary.java:121)
    at com.android.tools.idea.rendering.RenderTask.createRenderSession(RenderTask.java:717)
    at com.android.tools.idea.rendering.RenderTask.lambda$inflate$9(RenderTask.java:873)
    at com.android.tools.idea.rendering.RenderExecutor$runAsyncActionWithTimeout$3.run(RenderExecutor.kt:192)
    at java.base/java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1128)
    at java.base/java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:628)
    at java.base/java.lang.Thread.run(Thread.java:829)

问题原因 #

日志明确显示找不到purple_500颜色资源，这是因为Material Components组件默认依赖项目主题中定义的该颜色，而你的项目未配置该资源，或主题未正确继承Material主题。

解决步骤 #

• 添加缺失的颜色资源
  在res/values/colors.xml中添加purple_500的定义，示例：

  <color name="purple_500">#6200EE</color>
  

  可根据设计需求替换为自定义颜色值。

• 确保主题正确配置
  打开res/values/styles.xml，检查App主题是否继承自Material Components主题：

  <style name="AppTheme" parent="Theme.MaterialComponents.Light.DarkActionBar">
      <!-- 其他主题属性配置 -->
  </style>
  

  若项目使用旧版AppCompat主题，可在布局中为TextInputLayout单独指定Material主题：

  <com.google.android.material.textfield.TextInputLayout
      android:layout_width="match_parent"
      android:layout_height="wrap_content"
      android:theme="@style/Theme.MaterialComponents.Light">
  
      <EditText
          android:id="@+id/username"
          android:layout_width="match_parent"
          android:layout_height="wrap_content"
          android:hint="用户名"/>
  </com.google.android.material.textfield.TextInputLayout>
  

• 清理重建项目
  在Android Studio中依次执行Build > Clean Project和Build > Rebuild Project，确保资源文件正确编译生效。

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