Android开发新手遇AAPT错误：'@tools:sample/avatars'与src属性不兼容

错误含义 #

这个错误说明你给ImageView的android:src属性设置的@tools:sample/avatars不符合该属性的要求。android:src仅接受单个图片资源引用或颜色值，但@tools:sample/avatars是Android Studio提供的集合型预览占位符，它对应一组图片，不是单个可直接引用的资源，因此和src属性不兼容。

问题根源 #

• @tools:sample/avatars属于Android tools命名空间的工具资源，这类资源是用来在布局预览时展示随机示例内容的集合，不能直接作为android:src的属性值（src需要明确的单个资源）。
• 你之前能用的内置库存图片是单个具体的drawable资源，完全符合android:src的要求，所以可以正常显示。

排查与解决方法 #

• 用单个示例图片替代集合
  如果只是需要布局预览的占位图，换成单个tools示例资源，比如：

  android:src="@tools:sample/avatars[0]"
  

  也可以选择其他单张示例资源，比如@tools:sample/backgrounds/scenic、@tools:sample/user_backgrounds/0等。
• 改用tools:src属性
  要是你只想在布局编辑器预览时显示示例头像，运行时用真实资源，就用tools:src属性（仅作用于预览，不影响实际运行）：

  tools:src="@tools:sample/avatars"
  android:src="@drawable/your_real_image"
  

• 导入真实自定义图片
  将你需要的自定义图片放到项目的res/drawable或res/mipmap目录下，然后直接引用：

  android:src="@drawable/your_custom_image"
  

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