开源鸿蒙跨平台开发者社区 · 鸿蒙 React Native
前言
先认一认这三张底片。海岸灯塔写了日期和坐标,傍晚天台写了同一日期,白纸样本没写实际标签。日期特意填成同一个值,因为换到天台时,能拿来判断缓存有没有被清掉的,是 GPS 那一行。要是换完还显示灯塔的坐标,问题就藏在照片详情页。
接口参考选用 react-native-exif-reader 0.4.2。从 React Native 发起读取后,ArkTS 通过 Image Kit 取原始拍摄时间和 GPS 标签。样片生成时写入已知字段,再用 Pillow 独立读取,最后拿真机页面比对。上游源码
底片一:时间和坐标都在

MatePad Edge 全屏:海岸灯塔返回时间和测试坐标 · 查看原件
真机显示的坐标文本为 31, 15, 0 N / 121, 30, 0 E,与 Pillow 从 JPEG 回读的度、分、秒分量一致。接地图时要转换为十进制度,南纬和西经取负。测试坐标由生成脚本写入文件。
底片二:时间未变,坐标留空

MatePad Edge 全屏:切换样本后 GPS 字段留空 · 查看原件
天台图的时间同样为 2026:11:11 09:20:15。这一次原生只读到时间,GPS 显示「未写入」。页面在调用前清除上次的结果,读取完成后整份替换,避免把两张照片的字段拼到一起。
底片三:可以打开,但没有标签

MatePad Edge 全屏:白纸样本完成读取,但两项都没有写入 · 查看原件
白纸样本带有一个空 EXIF 容器。它能正常解码,Pillow 查到的两个子目录都为空。真机显示「读取完成」,拍摄时间和 GPS 两项各自留空。

MatePad Edge 全屏:依次打开三张样片的字段 · 查看原件
真机演示:读取三张 JPEG 的 EXIF
MatePad Edge 真机演示 · 查看原件
| 环境 | 版本或范围 |
|---|---|
| 真机 | MatePad Edge(QXS-W00),HarmonyOS 7.0.0.111 (SP16C00E111R6P5),API 26 |
| 模拟器 | DevEco Emulator 26.0.0.402,MatePad Pro 13 镜像(PADEMU-FD00),HarmonyOS 7.0.0.107 (SP8DEVC00E16R1P1),API 26;首张样片回读到原始拍摄时间 |
| SDK 与构建 | DevEco Studio 6.1.1.300;API 26 SDK 26.0.0.105 |
| 框架 | React Native 0.84.1;RNOH 0.84.4 |
| 样本源 | 应用内置合成样片,日期和坐标固定,Pillow 独立回读 EXIF |

模拟器全屏:首张样片完成读取 · 查看原件

MatePad Edge 关于本机 · 查看原件

API 26 模拟器关于本机 · 查看原件

DevEco Studio 关于 · 查看原件
空值从哪一层开始

VS Code 工程:原生模块逐个读取 EXIF 字段 · 查看原件
桥接层的输入是固定样片 ID,以便演示可以重复。不接收任意文件路径,也不会去相册翻找照片。调用进入原生模块后,按样片 ID 读取内置 JPEG,创建 ImageSource,再逐个请求字段。字段不存在时使用专门的默认值,将它在桥接层收敛成 null。这样页面很容易区分文件解析失败与某一项没有写入。
private async property(source: image.ImageSource, key: image.PropertyKey): Promise<string | null> {
const missing = '__EXIF_FIELD_MISSING__';
const value = await source.getImageProperty(key, { index: 0, defaultValue: missing });
return value === missing || value.trim().length === 0 ? null : value.trim();
}
分别请求日期、纬度、纬度方向、经度、经度方向的理由也在这里。如果把“日期为空”当成整张图不合法,即使它写了坐标也会被丢弃。反过来,经纬度少一项时,仍可以展示剩余的拍摄时间。finally 负责释放 ImageSource,避免反复打开照片时把原生对象积在页面状态里。
上游库还定义了写入 EXIF 和更新坐标的接口。这个验证工程没有对这两个接口做兼容,也没有沿用上游所有返回字段。若要把已上线应用切过去,应该先列出现有调用者用到的键、字段类型和异常约定,再补兼容层。直接把样例中的对象作为整个库的返回值,会破坏只在 Android 或 iOS 上使用的字段。
上游接口差异
HarmonyOS 开发助手扩展的安装已验证。三方库转换功能仍需满足官方账号条件,本轮没有取得工具生成的补丁。这里的原生桥接是手工实现和验证的,所以这份草稿只能作为读路径实验材料。若按「AI 三方库适配工具」方向投稿,还要补上真正的工具输入、工具输出、人工修改和最终复测之间的对应关系。HarmonyOS 开发助手三方库鸿蒙化指南
以项目原包名重新签名后,在 API 26 平板模拟器上依次重测三张固定样片。海岸灯塔返回拍摄时间与坐标,傍晚天台返回同一拍摄时间、GPS 为空,白纸样本的拍摄时间和 GPS 均为空。这组结果覆盖的是样例的读取路径。上游 react-native-exif-reader 0.4.2 还暴露了写入接口,当前样例没有覆盖。上游源码
同一份以项目原包名签名的安装包也在 MatePad Edge 上复测了三张样片。灯塔返回 2026:11:11 09:20:15 和预置坐标,天台只返回相同的拍摄时间,白纸两项均提示未写入。三张样片与模拟器回读一致。
FAQ
为什么无坐标的文件还能显示读取完成? JPEG 能正常打开,读取也已经结束。GPS 没写入是文件内容的一种常见状态,应该给出具体提示,避免把它误当成模块异常。
白纸样本的「无 EXIF」指什么? 界面用这几个字概括没有设置任何 EXIF 标签。用十六进制查看这张样片,仍能找到 JPEG 写入器留下的空 EXIF 容器。Pillow 按标签回读时两个子目录都为空,所以测试的是业务字段缺失。要同时覆盖 JPEG 从未含这段容器的情况,可以在生成白纸时关闭 EXIF 写入,再用独立的文件检查确认。
如何单独确认时间没有从系统日期里读错? 两张测试图固化了相同的 EXIF 原始拍摄时间。导入后用独立工具读标签,与原生页面结果对照。真实图片还需要留意时区字段,因为本例的日期字段本身没有时区。
接用户照片要改哪里? 用系统文件或照片选择器获得用户授权输入,再由原生模块在有效权限内打开,保持读取方法和空值表示不变。样片入口和真实用户文件入口应有各自的测试,日志只记处理状态。
总结
三张样片形成了有日期有坐标、有日期无坐标、两项都缺三种情况,MatePad Edge 的结果与文件标签一致。适配真实库时先锁定 API 兼容范围,再考虑扩大到可选 URI、更多标签与写回操作。用于工具适配方向的稿件,还需要有真实的工具实操证据。
工程代码
EXIF 原生模块
harmony/entry/src/main/ets/ExifPackage.ets
import { common } from '@kit.AbilityKit';
import { image } from '@kit.ImageKit';
import { RNPackageContext, RNOHPackage, UITurboModule, UITurboModuleContext } from '@rnoh/react-native-openharmony';
interface ExifReport {
date: string | null;
latitude: string | null;
latitudeRef: string | null;
longitude: string | null;
longitudeRef: string | null;
}
class ExifReader extends UITurboModule {
async readExif(sample: string): Promise<string> {
if (sample !== 'location' && sample !== 'date' && sample !== 'plain') {
return JSON.stringify({ error: '未知样图' });
}
const context = this.ctx.uiAbilityContext as common.UIAbilityContext;
const content = context.resourceManager.getRawFileContentSync(`exif-${sample}.jpg`);
const source = image.createImageSource(content.buffer as ArrayBuffer);
try {
const key = image.PropertyKey;
// 单独读取每个字段,保留其余已经读到的信息。
const report: ExifReport = {
date: await this.property(source, key.DATE_TIME_ORIGINAL),
latitude: await this.property(source, key.GPS_LATITUDE),
latitudeRef: await this.property(source, key.GPS_LATITUDE_REF),
longitude: await this.property(source, key.GPS_LONGITUDE),
longitudeRef: await this.property(source, key.GPS_LONGITUDE_REF)
};
return JSON.stringify(report);
} finally {
await source.release();
}
}
private async property(source: image.ImageSource, key: image.PropertyKey): Promise<string | null> {
const missing = '__EXIF_FIELD_MISSING__';
const value = await source.getImageProperty(key, { index: 0, defaultValue: missing });
return value === missing || value.trim().length === 0 ? null : value.trim();
}
}
export class ExifPackage extends RNOHPackage {
constructor(ctx: RNPackageContext) { super(ctx); }
getUITurboModuleFactoryByNameMap(): Map<string, (ctx: UITurboModuleContext) => UITurboModule | null> {
return new Map<string, (ctx: UITurboModuleContext) => UITurboModule | null>([
['ExifReader', (ctx: UITurboModuleContext) => new ExifReader(ctx)]
]);
}
}
原生方法注册
harmony/entry/src/main/cpp/PackageProvider.cpp
#include "RNOH/PackageProvider.h"
#include "RNOHPackagesFactory.h"
#include "generated/RNOHGeneratedPackage.h"
using namespace rnoh;
namespace {
class ExifTurboModule : public ArkTSTurboModule {
public:
ExifTurboModule(Context ctx, const std::string& name) : ArkTSTurboModule(ctx, name) {
methodMap_ = { ARK_ASYNC_METHOD_METADATA(readExif, 1) };
}
};
class ExifFactory : public TurboModuleFactoryDelegate {
public:
SharedTurboModule createTurboModule(Context ctx, const std::string& name) const override {
if (name == "ExifReader") return std::make_shared<ExifTurboModule>(ctx, name);
return nullptr;
}
};
class ExifPackage : public Package {
public:
explicit ExifPackage(Context ctx) : Package(ctx) {}
std::unique_ptr<TurboModuleFactoryDelegate> createTurboModuleFactoryDelegate() override {
return std::make_unique<ExifFactory>();
}
};
}
std::vector<std::shared_ptr<Package>> PackageProvider::getPackages(
Package::Context ctx) {
auto packages = createRNOHPackages(ctx); // <= autolinking
packages.push_back(std::make_shared<RNOHGeneratedPackage>(
ctx)); // generated by codegen-harmony v1 on app preBuilt stage)
packages.push_back(std::make_shared<ExifPackage>(ctx));
return packages;
}
样片选择与字段报告
App.tsx
import React, {useState} from 'react';
import {Pressable,ScrollView,StyleSheet,Text,TurboModuleRegistry,View} from 'react-native';
type Sample = 'location' | 'date' | 'plain';
type Report = {date:string|null;latitude:string|null;latitudeRef:string|null;longitude:string|null;longitudeRef:string|null};
type Bridge = {readExif(sample:Sample):Promise<string>};
const samples:{id:Sample; title:string; note:string; color:string}[] = [
{id:'location',title:'海岸灯塔',note:'日期和测试坐标',color:'#acd1da'},
{id:'date',title:'傍晚天台',note:'仅写入日期',color:'#e9be9f'},
{id:'plain',title:'白纸样本',note:'无 EXIF',color:'#d9d9d0'},
];
function coordinates(report:Report){
const lat = report.latitude && report.latitudeRef ? report.latitude+' '+report.latitudeRef : null;
const lon = report.longitude && report.longitudeRef ? report.longitude+' '+report.longitudeRef : null;
return lat && lon ? lat+' / '+lon : '未写入 GPS';
}
export default function App(){
const [chosen,setChosen]=useState<Sample>('location');
const [result,setResult]=useState<Report>();
const [status,setStatus]=useState('选一张样片后读取字段。');
const [busy,setBusy]=useState(false);
async function read(){
setBusy(true);setResult(undefined);
try{const bridge=TurboModuleRegistry.getEnforcing<any>('ExifReader') as Bridge;
const next=JSON.parse(await bridge.readExif(chosen));
if(next.error)throw new Error(next.error);
setResult(next as Report);setStatus('读取完成');
}catch{setStatus('读取失败,请检查样图资源与原生模块。');}finally{setBusy(false);}
}
return <ScrollView style={s.screen} contentContainerStyle={s.body}><Text style={s.kicker}>图像信息</Text><Text style={s.title}>照片底片</Text>
<View style={s.strip}>{samples.map(sample=><Pressable key={sample.id} accessibilityRole="button" accessibilityState={{selected:sample.id===chosen}}
disabled={busy} onPress={()=>{setChosen(sample.id);setResult(undefined);setStatus('已选择'+sample.title);}}
style={[s.sample,{backgroundColor:sample.color},chosen===sample.id&&s.selected]}><Text style={s.sampleTitle}>{sample.title}</Text><Text style={s.note}>{sample.note}</Text></Pressable>)}</View>
<View style={s.panel}><Text style={s.panelTitle}>文件字段</Text><Text style={s.term}>原始拍摄时间</Text><Text style={s.value}>{result?result.date??'未写入拍摄时间':'—'}</Text>
<Text style={s.term}>GPS</Text><Text style={s.value}>{result?coordinates(result):'—'}</Text></View>
<Pressable style={s.action} accessibilityRole="button" disabled={busy} onPress={read}><Text style={s.actionText}>{busy?'正在读取…':'读取 EXIF'}</Text></Pressable>
<Text style={s.status}>{status}</Text>
</ScrollView>;
}
const s=StyleSheet.create({
screen:{flex:1,backgroundColor:'#f9f6ee'},body:{width:'100%',maxWidth:980,alignSelf:'center',paddingHorizontal:28,paddingTop:45,paddingBottom:38},
kicker:{fontSize:15,color:'#53635c',fontWeight:'700'},title:{fontSize:46,fontWeight:'800',color:'#162e27',marginBottom:17},
strip:{flexDirection:'row',flexWrap:'wrap',gap:10},sample:{minWidth:104,flexGrow:1,padding:13,paddingTop:38,borderWidth:2,borderColor:'transparent',borderRadius:5},
selected:{borderColor:'#1c493a'},sampleTitle:{color:'#172e27',fontSize:17,fontWeight:'800'},note:{color:'#2d4940',fontSize:13,marginTop:3},
panel:{borderTopWidth:1,borderBottomWidth:1,borderColor:'#c2c9bd',marginTop:21,paddingVertical:15},
panelTitle:{fontSize:21,fontWeight:'800',color:'#16372b'},term:{fontSize:13,color:'#4e6258',marginTop:10},
value:{fontSize:18,color:'#192e25',marginTop:3},action:{backgroundColor:'#214d3d',alignSelf:'flex-start',paddingHorizontal:17,paddingVertical:12,marginTop:15,borderRadius:5},
actionText:{color:'white',fontSize:15,fontWeight:'800'},status:{color:'#3a5147',marginTop:10},
});
27



被折叠的 条评论
为什么被折叠?



