JakeWharton/ViewPagerIndicator CirclePageIndicator属性找不到问题求助

问题场景 #

使用JakeWharton/ViewPagerIndicator库的CirclePageIndicator时，布局中配置自定义属性出现AAPT错误，提示pageColor、snap、fillColor、centered等属性不存在。布局代码如下：

<com.viewpagerindicator.CirclePageIndicator
    android:id="@+id/blogindicator"
    android:layout_width="match_parent"
    android:layout_height="10dp"
    android:layout_marginStart="8dp"
    android:layout_marginTop="8dp"
    android:layout_marginEnd="8dp"
    app:centered="true"
    app:fillColor="@color/black"
    app:layout_constraintEnd_toEndOf="parent"
    app:layout_constraintStart_toStartOf="parent"
    app:layout_constraintTop_toBottomOf="@+id/txtblogname"
    app:pageColor="@color/white"
    app:snap="false" />

错误信息：

AAPT: error: attribute pageColor (aka com.package:pageColor) not found.
AAPT: error: attribute snap(aka com.package:snap) not found.
AAPT: error: attribute fillColor(aka com.package:fillColor) not found.
AAPT: error: attribute centered(aka com.package:centered) not found.

已尝试添加xmlns:app="http://schemas.android.com/apk/res-auto"命名空间、改用vpi命名空间，但问题未解决。

解决方案 #

1. 确认依赖库正确引入 #

确保项目的build.gradle(Module level)中已正确添加ViewPagerIndicator库的依赖：

dependencies {
    implementation 'com.viewpagerindicator:library:2.4.1'
}

如果使用本地导入的aar文件，需确保aar包包含res/values/attrs.xml（该文件定义了CirclePageIndicator的所有自定义属性），且已正确配置到项目中。

2. 清理并重建项目 #

Android Studio缓存可能导致AAPT无法识别库中的自定义属性，执行以下操作：

• 点击菜单栏 Build > Clean Project
• 完成后点击 Build > Rebuild Project

3. 验证命名空间使用 #

保持布局根节点的命名空间为xmlns:app="http://schemas.android.com/apk/res-auto"，无需改用vpi前缀。res-auto会自动匹配依赖库的命名空间，确保所有CirclePageIndicator的自定义属性都使用app:前缀。

4. 检查属性名称拼写 #

确认布局中使用的属性名称与库中定义的完全一致：

• pageColor：未选中的指示器颜色
• fillColor：选中的指示器颜色
• centered：指示器是否居中显示
• snap：是否启用吸附效果

内容的提问来源于stack exchange，提问作者Hassaan J.