详解Android中利用Canvas实现图片添加文字及Logo水印的完整代码，涵盖Bitmap操作、透明度设置及本地保存，助开发者快速实现版权保护功能。
在移动端开发中，为图片添加水印是保护版权和展示品牌标识的常见需求。本文将通过原生Canvas API，带你从零实现支持文字和Logo的图片水印功能，并提供完整的代码实现与细节解读。
一、项目背景与需求分析
在实际的Android开发项目中，为图片添加水印往往不是孤立的功能，而是为了应对具体的业务痛点。例如，电商平台为了防止商家盗用高质感的商品原图，通常需要在展示前强制叠加品牌Logo；社交分享类应用则倾向于在用户截图或导出图片时自动添加带有用户ID或应用名称的水印，以增强品牌曝光并遏制内容被无授权传播；而摄影社区类APP则常允许用户添加个性化的签名或版权标识。这些场景虽然形式各异，但核心诉求高度一致：既要保证视觉上的美观与灵活，又要确保操作的高效与稳定。
基于上述业务背景，我们对水印功能的具体需求进行了细化。在功能层面，系统必须同时支持文字水印和图片水印两种类型。文字水印需允许开发者自定义字体、颜色及透明度，以满足不同UI风格的需要；图片水印则主要处理PNG和JPG格式，确保Logo等图形元素能清晰叠加。
交互体验方面，用户界面应提供便捷的图片选择入口、一键生成水印的触发机制以及本地保存功能，降低用户的使用门槛。而在性能层面，鉴于图片处理涉及大量的内存运算，子线程处理是避免UI卡顿的关键。同时，输出结果需保持高清晰度，避免因压缩导致水印模糊。明确这些需求边界后，后续的Canvas API选型及代码实现就有了明确的指向，我们将基于此构建具体的技术实现方案。
二、技术方案选型对比
明确了业务需求后，技术选型的合理性直接决定了开发效率与维护成本。在Android生态中，实现图片水印通常有三条路径：原生Canvas绘制、基于OpenGL的底层处理以及引入第三方图像处理库。我们需要根据项目对性能、复杂度和依赖关系的具体要求来权衡取舍。
Canvas绘制是Android提供的标准2D图形接口，对于静态图片的水印叠加，它表现出极高的稳定性与易用性。由于直接操作Bitmap对象，其内存管理直观，且无需额外依赖，非常适合本项目中文字与Logo叠加的场景。虽然它不适合处理复杂的实时滤镜或大规模并发渲染，但在静态图片处理上，其效率完全能够满足需求。
相比之下，OpenGL ES虽然拥有极高的GPU加速性能，适合处理批量大图或复杂特效，但其着色器编写和纹理映射逻辑复杂，学习曲线陡峭，对于简单的水印功能而言属于“杀鸡用牛刀”，显著增加了代码维护难度。而第三方库如Glide或Picasso，其核心优势在于图片加载与缓存，若仅为了水印功能引入这些重量级依赖，不仅包体积增加，还需额外扩展其源码以支持水印绘制，违背了轻量级开发的初衷。
综合考量，我们最终确定采用Canvas绘制方案。该方案依赖原生API，代码逻辑清晰，能够精准控制水印的位置、透明度及尺寸，既保证了功能实现的灵活性，又避免了不必要的技术债务。基于这一决策，我们将进入核心实现思路的梳理阶段。
三、核心实现思路梳理
选定Canvas方案后，理清执行逻辑是避免代码混乱的关键。整个流程遵循“加载-合成-输出”的数据流向。第一步是获取源图像，通过Intent选择图片后，需将返回的URI转换为Bitmap对象。这里有个常见坑：直接读取大文件极易导致内存溢出，实际开发中建议先通过inSampleSize进行采样缩放，确保Bitmap尺寸在可控范围内。
拿到原图后，第二步是准备画布。我们需要创建一个与原图尺寸完全一致的新Bitmap，并基于它实例化Canvas。这一步至关重要，新Bitmap必须设为ARGB_8888格式，以支持透明通道，否则后续水印的半透明效果会失效。
第三步入画，先将原图绘制到Canvas上，作为底层背景。紧接着执行核心水印逻辑：若是文字水印，调用drawText方法，配合Paint设置字体大小、颜色及Alpha值；若是Logo图片，则使用drawBitmap，注意计算好坐标使其位于右下角或中心位置。这里可以灵活调整Paint的Alpha属性来控制水印透明度，通常设置在100-150之间既能保证可见性又不干扰原图内容。
最后，将合成好的Bitmap保存至本地存储并在界面中展示。至此，从URI到最终带水印图像的转换闭环完成。具体的代码实现细节，我们放在下一节详细展开。
四、完整代码实现详解
基于前文梳理的逻辑，这里直接给出可运行的核心代码。在MainActivity中，我们利用Android 12+推荐的ActivityResultLauncher来替代旧版Intent结果，这样回调逻辑更简洁。当用户从文件选择器返回URI后，直接调用工具类方法处理。以下是工具类WatermarkUtils的核心实现片段：
public static Bitmap addTextWatermark(Bitmap srcBitmap, String text) { int width = srcBitmap.getWidth(); int height = srcBitmap.getHeight(); Bitmap destBitmap = Bitmap.createBitmap(width, height, Bitmap.Config.ARGB_8888); Canvas canvas = new Canvas(destBitmap); // 1. 绘制原图 canvas.drawBitmap(srcBitmap, 0, 0, null); // 2. 配置水印Paint Paint paint = new Paint(Paint.ANTI_ALIAS_FLAG); paint.setColor(Color.RED); paint.setTextSize(60f); paint.setAlpha(180); // 控制透明度，180约为70%不透明 // 3. 绘制水印文字 (此处以右下角为例，需根据实际需求调整坐标) canvas.drawText(text, width - text.length() * 30, height - 20, paint); return destBitmap;}
注意：坐标计算需结合具体字体度量，上述坐标仅为演示，实际开发中建议使用TextMetrics动态计算位置以避免溢出。若需添加Logo图片水印，逻辑类似，仅需将drawText替换为canvas.drawBitmap(logoBitmap, x, y, paint)，并确保Logo已解码为Bitmap。保存环节建议使用FileOutputStream将处理后的Bitmap以JPEG或PNG格式写入指定目录，记得在AndroidManifest.xml中声明存储权限（针对Android 10以下）或适配SAF框架（Android 10+）。后续关于常见内存泄漏陷阱的优化建议，将在下一节展开。
五、常见问题与优化扩展
在实际落地过程中，上一节提到的坐标计算往往是痛点。若想精确将水印置于右下角并保留20像素的安全边距，可参考公式：x = src.getWidth() - watermark.getWidth() - 20，高度同理。若希望实现更具设计感的旋转水印，只需在绘制前调用 canvas.rotate(angle, pivotX, pivotY)，指定旋转角度与支点即可轻松实现斜向或居中效果。
注意：处理高分辨率图片时，内存溢出是最大风险。务必避免反复解码原图，建议先通过 InSampleSize 将图片压缩至屏幕显示尺寸再进行Canvas绘制，这能显著降低GC频率并提升流畅度。
除了基础功能，扩展性也是考量重点。通过双重循环绘制同一水印素材，即可快速实现全屏平铺防盗水印；若需品牌定制，利用 Typeface.createFromAsset() 加载本地字体文件，能让水印更具辨识度。针对批量处理场景，可考虑引入后台线程池或GPU加速方案，以平衡性能与体验。掌握这些技巧，你的水印工具将从“能用”进阶到“好用”。
