纽扣助手兼容android 5.0–14系统及armv7/arm64/x86_64架构；华为/荣耀需开安装权限、后台自启与无障碍；小米需加白名单、设省电无限制；oppo等需改存储权限为始终允许、加受保护应用；三星/pixel需开开发者选项及usb调试。
如果您在安装或运行纽扣助手时遇到兼容性问题，可能是由于设备品牌、系统版本或硬件架构未被当前版本充分适配。以下是针对不同品牌机型的兼容性确认与适配操作步骤：
一、主流安卓品牌兼容范围
纽扣助手官方声明支持覆盖市面上绝大多数安卓手机品牌，其底层适配基于Android 5.0至Android 14系统环境，并兼容ARMv7、ARM64及部分x86_64架构设备。适配不依赖特定厂商定制系统，但需满足基础运行条件。
1、确认手机系统版本是否为Android 5.0及以上版本。
2、进入“设置→关于手机→软件信息”，查看“Android版本”与“内核版本”字段。
3、若系统版本低于Android 5.0，该设备不在官方支持范围内，无法正常安装或启动主程序。
二、华为/荣耀机型专项适配方法
华为自EMUI 11及HarmonyOS 2起启用应用管控策略，可能拦截非华为应用市场来源的APK安装行为及后台服务。纽扣助手需手动开启必要权限以维持云存档、脚本注入等核心功能稳定运行。
1、前往“设置→安全→更多安全设置→安装外部来源应用”，为文件管理器或浏览器开启“允许安装未知应用”权限。
2、进入“设置→电池→应用启动管理”，搜索“纽扣助手”，关闭“自动管理”，并手动启用“允许后台活动”与“允许自启动”。
3、如使用HarmonyOS 4.2及以上系统，需在“设置→隐私→权限中心→特殊访问权限”中授予“无障碍服务”和“显示在其他应用上方”权限。
三、小米/Redmi机型白名单配置
MIUI系统默认限制第三方工具类应用的后台保活与通知显示，导致云同步中断或脚本失效。需通过系统级白名单解除限制，确保服务持续在线。
1、打开“设置→密码与安全→系统安全→授权管理→自启动管理”，将“纽扣助手”状态设为“允许”。
2、进入“设置→应用设置→应用管理→纽扣助手→省电策略”，选择“无限制”模式。
3、返回“应用管理→纽扣助手→通知设置”，开启全部通知类别，特别是“悬浮窗”与“锁屏通知”两项必须启用。
四、OPPO/Realme/OnePlus ColorOS适配步骤
ColorOS对非商店应用实施更严格的存储与运行沙盒机制，可能导致云存档上传失败、游戏加速无效等问题。需调整存储权限与后台冻结策略。
1、进入“设置→应用管理→纽扣助手→权限”，将“存储”权限由“仅在使用中允许”改为“始终允许”。
2、在“设置→电池→应用耗电管理→受保护应用”，将“纽扣助手”加入受保护列表。
3、如启用“智能冻结”功能，须在“设置→应用管理→应用冻结”中将纽扣助手设为“永不冻结”。
五、三星/Google Pixel等AOSP系机型处理方式
AOSP原生或接近原生系统通常无需深度适配，但部分Pixel设备因SELinux策略严格，可能拒绝加载非签名脚本模块。此时需验证安装包完整性并启用开发者选项中的关键调试开关。
1、在“设置→关于手机”连续点击“版本号”七次，激活开发者选项。
2、进入“设置→开发者选项”，开启“USB调试”与“通过USB验证应用”。
3、返回“设置→应用→特殊应用访问→无障碍”，启用纽扣助手的无障碍服务；若提示“此应用未获Google Play保护”，请忽略并继续授权。
