接入Hanks PasscodeView出现Error inflating class报错怎么解决

常见报错原因 #

• 依赖引入异常：gradle配置中未正确添加组件依赖，或是依赖同步失败，运行时无法找到PasscodeView对应的类定义
• 依赖版本冲突：项目为AndroidX架构时，PasscodeView默认依赖的Android Support包与AndroidX不兼容，类加载失败
• 布局属性配置错误：XML布局中给PasscodeView设置的自定义属性不符合要求，包括使用了不存在的属性、属性值类型不匹配、资源引用无效等
• 主题适配异常：当前页面使用的主题缺少PasscodeView需要的基础属性，导致布局解析器无法完成实例化
• 混淆规则缺失：开启代码混淆后，未给PasscodeView配置防混淆规则，组件相关类被混淆或删除，布局解析器找不到对应类名

对应解决方法 #

• 检查依赖配置：确认module级build.gradle中已正确添加PasscodeView的依赖声明，重新执行gradle同步后，到External Libraries目录下检查组件包是否已经成功导入
• 处理兼容问题：AndroidX项目优先检查gradle.properties文件，确保已经添加android.enableJetifier=true配置，该配置会自动将第三方组件的Support依赖转换为AndroidX兼容格式；如果仍存在冲突，可以选择引入组件的AndroidX适配版本
• 校验布局属性：逐一核对PasscodeView的所有自定义配置，重点确认密码长度、颜色、边框宽度等属性的值类型正确，所有资源引用均有效
• 修复主题配置：可以先给PasscodeView单独添加android:theme="@style/Theme.AppCompat.Light"兼容主题测试，如果恢复正常则说明原有主题缺少必填属性，补充对应属性即可
• 补充混淆规则：如果开启了代码混淆，在proguard-rules.pro文件中添加防混淆规则-keep class com.hanks.passcodeview.** {*;}，避免组件类被混淆处理

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