React Native Skia 在 Web 平台加载资源的问题解析

问题背景

React Native Skia 是一个强大的 2D 图形渲染库，但在 Web 平台上使用时，开发者可能会遇到资源加载的问题。当尝试加载字体、图片等资源时，Metro 打包工具会返回资源的数字 ID 而非实际文件数据，导致渲染失败。

问题表现

在 Web 平台使用 React Native Skia 时，如果按照常规方式加载资源，例如：

const font = useFont(require("./my-font.ttf"), fontSize);

会出现错误提示，提示无法从数字创建图像资源。这是因为 Metro 在 Web 平台处理资源的方式与原生平台不同。

技术原理分析

在 React Native 的 Web 平台实现中，资源管理系统与原生平台存在差异：

1. Metro 打包工具在 Web 平台会将资源转换为数字 ID
2. React Native 的 Image.resolveAssetSource() 工具在 Web 平台不可用
3. Web 平台需要直接访问资源 URL 而非打包后的资源引用

解决方案

临时解决方案

开发者可以采用平台判断的方式加载资源：

const image = useImage(
  Platform.OS === 'web' 
    ? '/images/favicon.png' 
    : require("../../public/images/favicon.png")
);

这种方案要求将资源放置在项目的 public 或 assets 目录下，以便通过 URL 直接访问。

推荐解决方案

1. 对于公共目录资源：

const myAssetPath = 'assets/images/my-image.png';
const relativePath = '../../';
const asset = Platform.OS === 'web' 
  ? `/${myAssetPath}` 
  : require(`${relativePath}${myAssetPath}`);

2. 使用 expo-asset（适用于 Expo 项目）：

import { useAssets } from 'expo-asset';
const [assets, error] = useAssets([require(`../random-folder/my-image.png`)]);
const asset = !error && assets ? assets[0].uri : null;

最佳实践建议

1. 统一资源管理：建议将需要跨平台使用的资源集中放置在公共目录中
2. 封装资源加载工具：可以创建一个跨平台的资源加载工具函数，封装平台差异
3. 注意路径处理：Web 平台需要绝对路径，而原生平台使用相对路径

未来展望

虽然目前需要开发者手动处理平台差异，但随着 React Native Web 生态的完善，未来可能会提供更统一的资源加载方案。React Native Skia 团队也在持续优化跨平台支持，开发者可以关注后续版本更新。

通过理解这些技术细节和采用适当的解决方案，开发者可以顺利地在 Web 平台使用 React Native Skia 实现丰富的图形渲染功能。