| name | ui-shadowlayout |
| description | 在布局中需要阴影、圆角、纯色/渐变背景、描边、pressed/selected/ripple、虚线、子 View 按圆角裁剪， 或想少写 shape/layer-list/selector drawable 时，优先使用 com.lihang.ShadowLayout（ https://github.com/lihangleo2/ShadowLayout ）。流程与常见坑在 SKILL，R.styleable.ShadowLayout 下全部 app:hl_*、代码 API 与 raw 源码见 references/reference.md。以 Maven/JitPack 坐标与上游 GitHub README/raw 为准，不依赖工作区 shadowLibrary 模块路径。 |
ShadowLayout：阴影 + Shape/Selector + 裁剪
权威来源（仅 Maven + 上游 GitHub）
禁止在工作区内查找或假设存在 shadowLibrary/ 等上游子模块路径。能力说明、hl_* 属性全表、代码 API、版本 tag 与 raw 链接见 references/reference.md。
新增依赖：JitPack 坐标 com.github.lihangleo2:ShadowLayout:<version>；本仓库集中坐标时 Read project-gradle-central-deps/SKILL.md，勿重复 GAV。
何时用本 Skill（对齐 README 能力）
对照上游 README；属性枚举与实现细节以 references/reference.md 中的上游 raw 为准（仅通过上游 URL，不读本地模块）。
在以下场景优先用 ShadowLayout 包裹子 View，减少 drawable 里的 shape / selector / layer-list：
- 阴影：颜色、扩散、圆角、X/Y 偏移、单边或多边隐藏、是否完全关闭阴影。
- 圆角：统一圆角，或四角独立（含阴影与内容区）。
- 背景：纯色、
reference 图片、与 pressed / selected / ripple 组合（类 selector）。
- 描边：实线或虚线（dash）；可按状态切换描边色。
- 渐变：线性渐变（起止色、可选中间色、角度）；设置后纯色背景属性失效。
- 不可点击态：
clickable=false 时的单独背景（配合 pressed 等）。
- 子 View 圆角裁剪：如视频、图片、任意 View 需要不规则圆角外轮廓裁剪（README「剪裁各种难以搞定的圆角」）。
不适用 / 慎用：hl_shapeMode="dashLine" 时控件退化为虚线线段模式，初始化路径与阴影/shape 主流程不同，不能混用渐变等能力（见下文「虚线模式」）。
与 DevWidget round 包：若需求仅为无阴影的圆角矩形纯色+描边且工程已用 DevWidget，可按项目 ui-devwidget-round 取舍；本 Skill 覆盖阴影、渐变、ripple、selector 态、裁剪等更重场景。
核心事实（减少踩坑）
- 类与父类：
com.lihang.ShadowLayout 继承 FrameLayout，子 View 写在标签内即可。
- 命名空间：
xmlns:app="http://schemas.android.com/apk/res-auto"（以工程为准）。
- styleable 名：
ShadowLayout，XML 里属性前缀一般为 app:（全表见 references/reference.md）。
- 库内拼写：描边宽度属性为
app:hl_strokeWith（README 与源码均为 With，不是 Width）。
- 默认背景：未设置背景时内部逻辑偏白色底；仅做裁剪、不要白底时设
app:hl_layoutBackground 为透明色（README 示例用 @color/transparent）。
- 子 View 裁剪：
dispatchDraw 内对子级做 clipPath（@RequiresApi(LOLLIPOP)）；逻辑在存在 getChildAt(0) != null 时按圆角裁剪，需 API 21+ 行为与设备 GPU 路径支持。
- RecyclerView 内点透：README 建议裁剪容器上
app:clickable="false" 避免与 item 点击冲突（见属性表 clickable）。
虚线模式 dashLine（单独使用）
- 仅保留：
hl_shapeMode="dashLine"、hl_strokeColor、hl_stroke_dashWidth、hl_stroke_dashGap（缺一会抛 UnsupportedOperationException）。
- 横向虚线：View 宽 > 高；纵向虚线：高 ≥ 宽（README：以长边为宽度、短边为线粗语义）。
- 此模式下勿再依赖阴影、渐变、圆角卡片等主流程 API（上游行为见 references/reference.md）。
常用属性与 API 速查
XML 最小片段（速查）
圆角 + 阴影 + 子 View
<com.lihang.ShadowLayout
android:layout_width="wrap_content"
android:layout_height="wrap_content"
app:hl_cornerRadius="10dp"
app:hl_shadowColor="#2a000000"
app:hl_shadowLimit="5dp">
<TextView
android:layout_width="wrap_content"
android:layout_height="36dp"
android:text="内容" />
</com.lihang.ShadowLayout>
仅裁剪 + 透明底（README 视频圆角）
<com.lihang.ShadowLayout
android:layout_width="match_parent"
android:layout_height="200dp"
app:hl_cornerRadius_leftTop="12dp"
app:hl_cornerRadius_rightTop="12dp"
app:hl_layoutBackground="@android:color/transparent"
app:clickable="false">
</com.lihang.ShadowLayout>
自检清单（写布局前）
