Android 圖片 EXIF 資訊修改與自定義 Tag 寫入：繞過 ExifInterface 限制的 JNI 方案

Android 原生 ExifInterface 僅支援讀寫標準 EXIF 標籤（如 TAG_DATETIME、TAG_GPS_LATITUDE 等），**無法新增自定義 Tag**（如 setAttribute("name", "android") 會失效）。若需在 JPEG 檔案中嵌入任意 XML/JSON 資料且不影響圖片正常顯示，業界通用做法是：**C/C++ 層操作 JPEG 段落 + JNI 橋接**。

為何 Java 層無法實現？

• ExifInterface 內部硬編碼支援的標籤集合，未暴露擴充機制。
• JPEG 結構中，自定義資料通常寫入 APP1 段落（EXIF 即佔用 APP1）或 APP2~APP15 保留段落，需手動構造段落結構（Marker + Length + Data）。
• Java 純記憶體操作 JPEG 二進位極易出錯（位元組序、段落長度計算、掃描資料完整性），效能也較差。

JNI 方案完整架構

1. C/C++ 層核心邏輯（使用 libjpeg 或獨立解析器）

// 伪代碼：向 JPEG 寫入自定義 APP2 段落
bool writeCustomAppSegment(const char* jpegPath, const char* tag, const char* value) {
    // 1. 讀取整個 JPEG 到記憶體
    // 2. 解析段落結構：SOI (0xFFD8) -> APP0/APP1... -> SOS (0xFFDA) -> 掃描資料 -> EOI (0xFFD9)
    // 3. 在第一個掃描段落 (SOS) 前插入新 APP2 段落：
    //    Marker: 0xFFE2 (APP2)
    //    Length: 2 + tagLen + 1 + valueLen (含長度欄位本身2字節)
    //    Data: tag + '\0' + value
    // 4. 重寫檔案
    return true;
}

成熟開源庫推薦：

• libjpeg-turbo：高效能 JPEG 編解碼，支援段落級操作。
• exiv2：C++ 元資料庫，直接支援自定義 XMP/EXIF/IPTC 標籤，API 友善。

2. JNI 橋接層

// NativeLib.cpp
#include 
#include "exiv2/exiv2.hpp"

extern "C" JNIEXPORT jboolean JNICALL
Java_com_example_ImageMetaWriter_writeCustomTag(
        JNIEnv* env, jclass clazz,
        jstring jpegPath, jstring tag, jstring value) {
    const char* path = env->GetStringUTFChars(jpegPath, nullptr);
    const char* t = env->GetStringUTFChars(tag, nullptr);
    const char* v = env->GetStringUTFChars(value, nullptr);

    bool ok = false;
    try {
        Exiv2::Image::AutoPtr img = Exiv2::ImageFactory::open(path);
        img->readMetadata();
        Exiv2::XmpData& xmp = img->xmpData();
        xmp[std::string(t)] = std::string(v); // 寫入 XMP 自定義標籤
        img->writeMetadata();
        ok = true;
    } catch (...) { ok = false; }

    env->ReleaseStringUTFChars(jpegPath, path);
    env->ReleaseStringUTFChars(tag, t);
    env->ReleaseStringUTFChars(value, v);
    return ok;
}

3. Java/Kotlin 呼叫端

public class ImageMetaWriter {
    static { System.loadLibrary("native-lib"); }

    public static native boolean writeCustomTag(String jpegPath, String tag, String value);

    // 使用範例
    public void embedXmlToImage(File imageFile, String xmlContent) {
        boolean ok = writeCustomTag(imageFile.getAbsolutePath(), "CustomXml", xmlContent);
        if (!ok) throw new RuntimeException("寫入自定義 Tag 失敗");
    }
}

替代方案對比

| 方案 | 優點 | 缺點 | 適用場景 | |------|------|------|----------| | **JNI + exiv2** | 功能完整、效能高、支援所有標準/自定義標籤 | 需編譯 so、增加 APK 體積、跨架構適配 | 專業攝影/檔案管理 App、需寫入大量自定義資料 | | **純 Java 修改 APP 段落** | 無原生依賴、APK 體積小 | 易出錯、不支援大資料、需自行處理 JPEG 結構 | 簡單 Key-Value 寫入、資料極小（<1KB） | | **XMP sidecar 檔案** | 完全不修改原圖、相容性最好 | 需管理兩個檔案、易分離 | 歸檔系統、不允許修改原始影像 |

最佳實務建議

1. **優先用 XMP 標準**：exiv2 直接支援 XMP 命名空間，自定義資料建議放入 xmp:CustomNamespace，相容性優於私有 APP 段落。
2. **保留原圖備份**：寫入前複製原檔，失敗可回滾。
3. **針對大圖優化**：使用 mmap 或分塊讀寫，避免 OOM。
4. **ProGuard 保護 JNI 類**：防止反編譯洩露自定義 Tag 結構。

採用 JNI + exiv2 方案，即可突破 Android ExifInterface 的限制，實現靈活、穩健的圖片自定義元資料寫入，滿足專業級影像應用需求。