Android 9-Patch图片构建错误求助：左上角像素不符合规范

嘿，这个问题我之前帮同好排查过，核心就是你的键盘皮肤/资源图片不符合Android AAPT2工具的校验规则，而且其他功能正常说明逻辑代码没问题，就是资源文件踩坑了。咱们一步步来解决：

先明确错误根源 #

你看到的这几个错误：

Error:top-left corner pixel must be either opaque white or transparent.
Error:found an invalid color.

本质是AAPT2对图片资源的格式校验变严格了，尤其是键盘应用常用的皮肤背景图、皮肤预览图这类资源，同时可能还有颜色值配置写错了。

具体修复步骤 #

1. 排查并修复图片资源 #

• 先找到项目里的图片资源目录：一般是res/drawable、res/drawable-xxhdpi这类文件夹，重点看和键盘皮肤相关的.png文件
• 用图片编辑工具（比如Photoshop、GIMP，甚至Windows自带的画图3D）打开可疑图片，检查左上角第一个像素：
  • 要求要么是完全透明（Alpha通道值为0），要么是不透明的纯白色（RGB值(255,255,255)，Alpha值255）
  • 如果是其他颜色或者半透明的白色，直接修改成符合要求的格式
• 保存时务必选带Alpha通道的PNG格式，别存成JPG这类不支持透明的格式

2. 修复无效颜色值 #

打开res/values/colors.xml（或者皮肤自定义的颜色配置文件），检查所有颜色值：

• 必须是标准格式：#RRGGBB（不透明）或者#AARRGGBB（带透明度）
• 别出现拼写错误，比如少写一位字符、用了0-9/a-f/A-F之外的字母

3. 精准定位问题文件（可选） #

要是不确定是哪个资源出问题，执行这个Gradle命令看详细日志：

./gradlew assembleDebug --info

日志里会明确标出触发错误的具体资源文件路径，直接针对性修复就行。

补充说明 #

这个坑主要是因为AAPT2比旧版AAPT的资源校验严格很多，键盘应用因为大量自定义皮肤资源，很容易碰到这类问题。修改完资源后重新构建，应该就能正常通过了。

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