文档模板：v0.4.2

react-native-blob-util

本项目基于 react-native-blob-util。

该第三方库的仓库已迁移至 Gitcode，并支持直接从 npm 下载，新的包名为：@react-native-ohos/react-native-blob-util，各版本对应关系如下：

简介

react-native-blob-util 是一款跨平台 RN 二进制网络文件与本地文件操作原生库，支持大文件上传下载与流式读写，可有效解决 fetch 处理二进制文件时的 OOM 问题。

下载安装

进入工程目录，并输入以下命令：

npm

npm install @react-native-ohos/react-native-blob-util

yarn

yarn add @react-native-ohos/react-native-blob-util

链接

使用 AutoLink 的工程需要根据该文档进行配置，AutoLink 框架指导文档：https://gitcode.com/CPF-RN/ohos_react_native/blob/master/docs/zh-cn/Autolinking.md

如您使用的版本支持 AutoLink，并且工程已接入 AutoLink，可跳过 ManualLink 配置。

{
  "overrides": {
    "@rnoh/react-native-openharmony": "^0.82.1" // ohpm 在线版本
    // "@rnoh/react-native-openharmony" : "./react_native_openharmony.har" // 指向本地 har 包的路径
    // "@rnoh/react-native-openharmony" : "./react_native_openharmony" // 指向源码路径
  }
}

"dependencies": {
    "@react-native-ohos/react-native-blob-util": "file:../../node_modules/@react-native-ohos/react-native-blob-util/harmony/blobUtil.har"
  }

cd entry
ohpm install

project(rnapp)
cmake_minimum_required(VERSION 3.4.1)
set(CMAKE_SKIP_BUILD_RPATH TRUE)
set(RNOH_APP_DIR "${CMAKE_CURRENT_SOURCE_DIR}")
set(NODE_MODULES "${CMAKE_CURRENT_SOURCE_DIR}/../../../../../node_modules")
+ set(OH_MODULES "${CMAKE_CURRENT_SOURCE_DIR}/../../../oh_modules")
set(RNOH_CPP_DIR "${CMAKE_CURRENT_SOURCE_DIR}/../../../../../../react-native-harmony/harmony/cpp")
set(LOG_VERBOSITY_LEVEL 1)
set(CMAKE_ASM_FLAGS "-Wno-error=unused-command-line-argument -Qunused-arguments")
set(CMAKE_CXX_FLAGS "-fstack-protector-strong -Wl,-z,relro,-z,now,-z,noexecstack -s -fPIE -pie")
set(WITH_HITRACE_SYSTRACE 1) # for other CMakeLists.txt files to use
add_compile_definitions(WITH_HITRACE_SYSTRACE)

add_subdirectory("${RNOH_CPP_DIR}" ./rn)

# RNOH_BEGIN: manual_package_linking_1
add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package)
+ add_subdirectory("${OH_MODULES}/@react-native-ohos/react-native-blob-util/src/main/cpp" ./blob-util)
# RNOH_END: manual_package_linking_1

file(GLOB GENERATED_CPP_FILES "./generated/*.cpp")

add_library(rnoh_app SHARED
    ${GENERATED_CPP_FILES}
    "./PackageProvider.cpp"
    "${RNOH_CPP_DIR}/RNOHAppNapiBridge.cpp"
)
target_link_libraries(rnoh_app PUBLIC rnoh)

# RNOH_BEGIN: manual_package_linking_2
target_link_libraries(rnoh_app PUBLIC rnoh_sample_package)
+ target_link_libraries(rnoh_app PUBLIC rnoh_blob_util)
# RNOH_END: manual_package_linking_2

#include "RNOH/PackageProvider.h"
#include "SamplePackage.h"
+ #include "BlobUtilPackage.h"

using namespace rnoh;

std::vector<std::shared_ptr<Package>> PackageProvider::getPackages(Package::Context ctx) {
    return {
      std::make_shared<SamplePackage>(ctx),
+     std::make_shared<RNBlobUtilPackage>(ctx),
    };
}

+ import {BlobUtilPackage} from '@react-native-ohos/react-native-blob-util/ts';

export function createRNPackages(ctx: RNPackageContext): RNPackage[] {
  return [
+   new BlobUtilPackage(ctx)
  ];
}

运行

点击右上角的 sync 按钮

或在终端执行：

cd entry
ohpm install

随后编译、运行即可。

约束与限制

兼容性

本文档内容已在以下版本中验证通过：

1. RNOH: 0.82.1; SDK: HarmonyOS 6.0.1 Release SDK; IDE: DevEco Studio 6.0.1 Release; ROM: 6.0.0.120 SP7;
2. RNOH: 0.84.2; SDK: HarmonyOS 6.0.1 Release SDK; IDE: DevEco Studio 26.0.0 Beta1; ROM: 6.0.0.120 SP7;

权限要求

• 上传与下载需申请网络权限

  在entry/src/main/module.json5中添加

requestPermissions: [
  {
    name: "ohos.permission.INTERNET",
  },
],

使用示例

以下代码演示了该库的基本用法：

import React, { useState } from "react";
import {
  ScrollView,
  StyleSheet,
  Button,
  View,
  Text
} from "react-native";
import ReactNativeBlobUtil from "react-native-blob-util";

export default function BlobUtilDemo() {
  const [result, setResult] = useState<string | null>(null);
  const [mkdirParam] = useState("blobUtilDemo");
  const cacheDir = ReactNativeBlobUtil.fs.dirs.CacheDir;
  const textFile = cacheDir + "/text.txt";
  const textFileCopy = cacheDir + "/text1.txt";

  const show = (value: unknown) => {
    setResult(typeof value === "string" ? value : JSON.stringify(value));
  };

  const showError = (err: unknown) => {
    const message = err instanceof Error ? err.message : String(err);
    setResult(message);
  };

  const createFile = async () => {
    try {
      await ReactNativeBlobUtil.fs.createFile(textFile, "123456", "utf8");
      show("createFile success");
    } catch (err) {
      showError(err);
    }
  };

  const ls = async () => {
    try {
      const files = await ReactNativeBlobUtil.fs.ls(cacheDir);
      show(files);
    } catch (err) {
      showError(err);
    }
  };

  const unlink = async () => {
    try {
      await ReactNativeBlobUtil.fs.unlink(textFile);
      show("unlink success");
    } catch (err) {
      showError(err);
    }
  };

  const getConstants = () => {
    show(cacheDir);
  };

  const writeFile = async () => {
    try {
      await ReactNativeBlobUtil.fs.writeFile(textFile, "Try to write str", "utf8");
      show("writeFile success");
    } catch (err) {
      showError(err);
    }
  };

  const writeStream = async () => {
    try {
      const stream = await ReactNativeBlobUtil.fs.writeStream(textFile, "utf8", false);
      await stream.write("write stream data");
      await stream.close();
      show("writeStream success");
    } catch (err) {
      showError(err);
    }
  };

  const writeArrayChunk = async () => {
    try {
      const stream = await ReactNativeBlobUtil.fs.writeStream(textFile, "ascii", false);
      await stream.write([101, 32, 97]);
      await stream.close();
      show("writeArrayChunk success");
    } catch (err) {
      showError(err);
    }
  };

  const writeChunk = async () => {
    try {
      const stream = await ReactNativeBlobUtil.fs.writeStream(textFile, "utf8", false);
      await stream.write("Zm9vIChXcml0ZSBCYXNlNjQpMQ==");
      await stream.close();
      show("writeChunk success");
    } catch (err) {
      showError(err);
    }
  };

  const closeStream = async () => {
    try {
      const stream = await ReactNativeBlobUtil.fs.writeStream(textFile, "utf8", false);
      await stream.close();
      show("closeStream success");
    } catch (err) {
      showError(err);
    }
  };

  const readStream = async () => {
    try {
      const stream = await ReactNativeBlobUtil.fs.readStream(textFile, "utf8", 4000, 200);
      let data = "";
      stream.onData((chunk) => {
        data += chunk;
      });
      stream.onError((err) => {
        showError(err);
      });
      stream.onEnd(() => {
        show(data);
      });
      stream.open();
    } catch (err) {
      showError(err);
    }
  };

  const mkdir = async () => {
    try {
      const dir = ReactNativeBlobUtil.fs.dirs.DocumentDir + "/" + mkdirParam;
      await ReactNativeBlobUtil.fs.mkdir(dir);
      show("mkdir success: " + dir);
    } catch (err) {
      showError(err);
    }
  };

  const stat = async () => {
    try {
      const info = await ReactNativeBlobUtil.fs.stat(textFile);
      show(info);
    } catch (err) {
      showError(err);
    }
  };

  const copyFileToCache = async () => {
    try {
      await ReactNativeBlobUtil.fs.cp(textFile, textFileCopy);
      show("copyFileToCache success");
    } catch (err) {
      showError(err);
    }
  };

  const writeFileArray = async () => {
    try {
      await ReactNativeBlobUtil.fs.writeFile(textFile, [102, 111, 111], "ascii");
      show("writeFileArray success");
    } catch (err) {
      showError(err);
    }
  };

  const exists = async () => {
    try {
      const fileExists = await ReactNativeBlobUtil.fs.exists(textFile);
      show(String(fileExists));
    } catch (err) {
      showError(err);
    }
  };

  const lstat = async () => {
    try {
      const info = await ReactNativeBlobUtil.fs.lstat(textFile);
      show(info);
    } catch (err) {
      showError(err);
    }
  };

  const mv = async () => {
    try {
      await ReactNativeBlobUtil.fs.mv(textFile, textFileCopy);
      show("mv success");
    } catch (err) {
      showError(err);
    }
  };

  const hash = async () => {
    try {
      const digest = await ReactNativeBlobUtil.fs.hash(textFile, "md5");
      show(digest);
    } catch (err) {
      showError(err);
    }
  };

  const readFile = async () => {
    try {
      const content = await ReactNativeBlobUtil.fs.readFile(textFile, "utf8", 4000);
      show(content);
    } catch (err) {
      showError(err);
    }
  };

  const slice = async () => {
    try {
      const dest = await ReactNativeBlobUtil.fs.slice(textFile, textFileCopy, 2, 5);
      show(dest);
    } catch (err) {
      showError(err);
    }
  };

  const df = async () => {
    try {
      const space = await ReactNativeBlobUtil.fs.df();
      show(space);
    } catch (err) {
      showError(err);
    }
  };

  return (
    <View style={styles.container}>
      <View style={styles.titleArea}>
        <Text style={styles.title}>BlobUtil</Text>
      </View>
      <View style={styles.inputArea}>
        <Text style={styles.baseText} ellipsizeMode="tail" numberOfLines={2}>{result}</Text>
      </View>
      <ScrollView style={styles.scrollView}>
        <View style={{ flexDirection: "column" }}>
          <View style={styles.baseArea}>
            <Text style={{ flex: 1 }}>BlobUtilTurboModule.getConstants()</Text>
            <Button
              title="运行"
              color="#841584"
              onPress={getConstants}
            ></Button>
          </View>
          <View style={styles.baseArea}>
            <Text style={{ flex: 1 }}>BlobUtilTurboModule.createFile()</Text>
            <Button title="运行" color="#841584" onPress={createFile}></Button>
          </View>
          <View style={styles.baseArea}>
            <Text style={{ flex: 1 }}>BlobUtilTurboModule.unlink()</Text>
            <Button title="运行" color="#841584" onPress={unlink}></Button>
          </View>
          <View style={styles.baseArea}>
            <Text style={{ flex: 1 }}>
              BlobUtilTurboModule.copyFileToCache()
            </Text>
            <Button
              title="运行"
              color="#841584"
              onPress={copyFileToCache}
            ></Button>
          </View>
          <View style={styles.baseArea}>
            <Text style={{ flex: 1 }}>BlobUtilTurboModule.writeFile()</Text>
            <Button title="运行" color="#841584" onPress={writeFile}></Button>
          </View>
          <View style={styles.baseArea}>
            <Text style={{ flex: 1 }}>BlobUtilTurboModule.stat()</Text>
            <Button title="运行" color="#841584" onPress={stat}></Button>
          </View>
          <View style={styles.baseArea}>
            <Text style={{ flex: 1 }}>BlobUtilTurboModule.mkdir()</Text>
            <Button title="运行" color="#841584" onPress={mkdir}></Button>
          </View>
          <View style={styles.baseArea}>
            <Text style={{ flex: 1 }}>BlobUtilTurboModule.writeStream()</Text>
            <Button title="运行" color="#841584" onPress={writeStream}></Button>
          </View>
          <View style={styles.baseArea}>
            <Text style={{ flex: 1 }}>BlobUtilTurboModule.ls()</Text>
            <Button title="运行" color="#841584" onPress={ls}></Button>
          </View>
          <View style={styles.baseArea}>
            <Text style={{ flex: 1 }}>
              BlobUtilTurboModule.writeFileArray()
            </Text>
            <Button
              title="运行"
              color="#841584"
              onPress={writeFileArray}
            ></Button>
          </View>
          <View style={styles.baseArea}>
            <Text style={{ flex: 1 }}>BlobUtilTurboModule.exists()</Text>
            <Button title="运行" color="#841584" onPress={exists}></Button>
          </View>
          <View style={styles.baseArea}>
            <Text style={{ flex: 1 }}>BlobUtilTurboModule.lstat()</Text>
            <Button title="运行" color="#841584" onPress={lstat}></Button>
          </View>
          <View style={styles.baseArea}>
            <Text style={{ flex: 1 }}>BlobUtilTurboModule.hash()</Text>
            <Button title="运行" color="#841584" onPress={hash}></Button>
          </View>
          <View style={styles.baseArea}>
            <Text style={{ flex: 1 }}>BlobUtilTurboModule.readFile()</Text>
            <Button title="运行" color="#841584" onPress={readFile}></Button>
          </View>
          <View style={styles.baseArea}>
            <Text style={{ flex: 1 }}>BlobUtilTurboModule.slice()</Text>
            <Button title="运行" color="#841584" onPress={slice}></Button>
          </View>
          <View style={styles.baseArea}>
            <Text style={{ flex: 1 }}>BlobUtilTurboModule.df()</Text>
            <Button title="运行" color="#841584" onPress={df}></Button>
          </View>
          <View style={styles.baseArea}>
            <Text style={{ flex: 1 }}>BlobUtilTurboModule.closeStream()</Text>
            <Button title="运行" color="#841584" onPress={closeStream}></Button>
          </View>
          <View style={styles.baseArea}>
            <Text style={{ flex: 1 }}>
              BlobUtilTurboModule.writeArrayChunk()
            </Text>
            <Button
              title="运行"
              color="#841584"
              onPress={writeArrayChunk}
            ></Button>
          </View>
          <View style={styles.baseArea}>
            <Text style={{ flex: 1 }}>BlobUtilTurboModule.writeChunk()</Text>
            <Button title="运行" color="#841584" onPress={writeChunk}></Button>
          </View>
          <View style={styles.baseArea}>
            <Text style={{ flex: 1 }}>BlobUtilTurboModule.readStream()</Text>
            <Button title="运行" color="#841584" onPress={readStream}></Button>
          </View>
          <View style={styles.baseArea}>
            <Text style={{ flex: 1 }}>BlobUtilTurboModule.mv()</Text>
            <Button title="运行" color="#841584" onPress={mv}></Button>
          </View>
        </View>
      </ScrollView>
    </View>
  );
}

const styles = StyleSheet.create({
  container: {
    width: "100%",
    height: "100%",
    flexDirection: "column",
    alignItems: "center",
    backgroundColor: "#F1F3F5",
  },
  baseText: {
    width: "100%",
    height: "100%",
    fontWeight: "bold",
    textAlign: "center",
    fontSize: 16,
  },
  titleArea: {
    width: "90%",
    height: "8%",
    alignItems: "center",
    flexDirection: "row",
  },
  title: {
    width: "90%",
    color: "#000000",
    textAlign: "left",
    fontSize: 30,
  },
  scrollView: {
    width: "90%",
    marginHorizontal: 10,
  },

  inputArea: {
    width: "90%",
    height: "10%",
    borderWidth: 2,
    borderColor: "#000000",
    marginTop: 8,
    justifyContent: "center",
    alignItems: "center",
  },
  baseArea: {
    width: "100%",
    height: 60,
    borderRadius: 4,
    borderColor: "#000000",
    marginTop: 6,
    backgroundColor: "#FFFFFF",
    flexDirection: "row",
    alignItems: "center",
    paddingLeft: 8,
    paddingRight: 8,
  },
});

使用说明

下载

ReactNativeBlobUtil.config({
  timeout: 20000,
})
.fetch("GET", "https://example.com/file.zip")
.then((res) => {
  console.log("Downloaded to:", res.path());
})
.catch((err) => {
  console.error(err);
});

上传

const filePath = ReactNativeBlobUtil.fs.dirs.CacheDir + '/fetch.txt';
    ReactNativeBlobUtil.config({
      timeout: 20000
    })
      .fetch(
        "POST",
        "https://example.com/file.zip",
        {
          'Content-Type': 'multipart/form-data',
        },
        [{

          name: 'file',
          filename: 'fetch.txt',
          data: ReactNativeBlobUtil.wrap(filePath)
        }]
      )
      .then((res) => {
      if (res.data) {
       console.log("fetch ok");
      }
    })
    .catch((err) => {
      console.error(err);
    });

文件操作

const cacheDir = ReactNativeBlobUtil.fs.dirs.CacheDir;
const textFile = cacheDir + "/text.txt";
const textFileCopy = cacheDir + "/text1.txt";

// 获取缓存目录下的文件与文件夹列表
ReactNativeBlobUtil.fs.ls(cacheDir)
  .then((files) => {
    console.log("目录内容:", files);
  })
  .catch((err) => {
    console.error(err);
  });

// 删除指定文件 text.txt
ReactNativeBlobUtil.fs.unlink(textFile)
  .then(() => {
    console.log("unlink success");
  })
  .catch((err) => {
    console.error(err);
  });

// 以utf8编码向路径写入字符串
ReactNativeBlobUtil.fs.writeFile(textFile, "Try to write str", "utf8")
  .then(() => {
    console.log("writeFile success");
  })
  .catch((err) => {
    console.error(err);
  });

// 创建文件写入流，utf8编码，false = 不追加(覆盖模式)
ReactNativeBlobUtil.fs.writeStream(textFile, "utf8", false)
  .then((stream) => stream.write("write stream data").then(() => stream.close()))
  .then(() => {
    console.log("writeStream success");
  })
  .catch((err) => {
    console.error(err);
  });

// 创建ascii编码写入流
ReactNativeBlobUtil.fs.writeStream(textFile, "ascii", false)
  .then((stream) => stream.write([101, 32, 97]).then(() => stream.close()))
  .then(() => {
    console.log("writeArrayChunk success");
  })
  .catch((err) => {
    console.error(err);
  });

// 创建utf8覆盖写入流并关闭
ReactNativeBlobUtil.fs.writeStream(textFile, "utf8", false)
  .then((stream) => stream.close())
  .then(() => {
    console.log("closeStream success");
  })
  .catch((err) => {
    console.error(err);
  });

// 创建文件读取流，utf8编码，分片最大4000字节，间隔200ms
ReactNativeBlobUtil.fs.readStream(textFile, "utf8", 4000, 200)
  .then((stream) => {
    let data = "";
    stream.onData((chunk) => {
      data += chunk;
    });
    stream.onError((err) => {
      console.error(err);
    });
    stream.onEnd(() => {
      console.log("readStream:", data);
    });
    stream.open();
  })
  .catch((err) => {
    console.error(err);
  });

// 在Document目录下创建新文件夹
ReactNativeBlobUtil.fs.mkdir(ReactNativeBlobUtil.fs.dirs.DocumentDir + "/blobUtilDemo")
  .then(() => {
    console.log("mkdir success");
  })
  .catch((err) => {
    console.error(err);
  });

// 获取文件stat信息（跟随软链接，读取目标文件元数据）
ReactNativeBlobUtil.fs.stat(textFile)
  .then((info) => {
    console.log("stat:", info);
  })
  .catch((err) => {
    console.error(err);
  });

// 复制文件
ReactNativeBlobUtil.fs.cp(textFile, textFileCopy)
  .then(() => {
    console.log("cp success");
  })
  .catch((err) => {
    console.error(err);
  });

// ascii编码写入字节数组
ReactNativeBlobUtil.fs.writeFile(textFile, [102, 111, 111], "ascii")
  .then(() => {
    console.log("writeFileArray success");
  })
  .catch((err) => {
    console.error(err);
  });

// 判断文件/目录是否存在
ReactNativeBlobUtil.fs.exists(textFile)
  .then((fileExists) => {
    console.log("exists:", fileExists);
  })
  .catch((err) => {
    console.error(err);
  });

// 获取lstat信息（不跟随软链接，读取链接自身元数据）
ReactNativeBlobUtil.fs.lstat(textFile)
  .then((info) => {
    console.log("lstat:", info);
  })
  .catch((err) => {
    console.error(err);
  });

// 移动文件（重命名）
ReactNativeBlobUtil.fs.mv(textFile, textFileCopy)
  .then(() => {
    console.log("mv success");
  })
  .catch((err) => {
    console.error(err);
  });

// 对文件计算md5哈希值
ReactNativeBlobUtil.fs.hash(textFile, "md5")
  .then((digest) => {
    console.log("hash:", digest);
  })
  .catch((err) => {
    console.error(err);
  });

// utf8读取文件内容
ReactNativeBlobUtil.fs.readFile(textFile, "utf8", 4000)
  .then((content) => {
    console.log("readFile:", content);
  })
  .catch((err) => {
    console.error(err);
  });

// 文件切片
ReactNativeBlobUtil.fs.slice(textFile, textFileCopy, 2, 5)
  .then((dest) => {
    console.log("slice:", dest);
  })
  .catch((err) => {
    console.error(err);
  });

接口说明

组件

属性

Dirs

ReactNativeBlobUtilConfig

AddAndroidDownloads

AndroidDownloadOption

ReactNativeBlobUtilStat

RNFetchBlobDf

ReactNativeBlobUtilResponseInfo

Mediatype

filedescriptor

API

ReactNativeBlobUtilStatic

FS

ReactNativeBlobUtil.fs

ReactNativeBlobUtilReadStream

ReactNativeBlobUtilWriteStream

ReactNativeBlobUtilStream

StatefulPromise

FetchBlobResponse

Net

ReactNativeBlobUtil.net

IOSApi

ReactNativeBlobUtil.ios

AndroidApi

ReactNativeBlobUtil.android

MediaCollection

ReactNativeBlobUtil.MediaCollection

ReactNativeBlobUtilSession

ReactNativeBlobUtil.session

Polyfill

ReactNativeBlobUtil.polyfill

EventTarget

PolyfillBlob

PolyfillFile

PolyfillEvent

PolyfillProgressEvent

PolyfillFileReader

PolyfillXMLHttpRequestEventTarget

PolyfillXMLHttpRequest

PolyfillFetch

ReactNativeBlobUtilFetchPolyfill

ReactNativeBlobUtilFetchRepsonse

遗留问题

• blob-util 使用 getCookies、removeCookies 在 Android、iOS、Harmony OS 上均会报错：issue#381

其他

无

目录结构

/rntpc_react-native-blob-util                      # 项目根目录
├── harmony                                        # 鸿蒙平台适配代码
│   └── blobUtil.har                               # 编译产出HAR静态包
│   └── blobUtil                                   # 鸿蒙适配核心源码目录
│       └── Index.ets                               # 鸿蒙适配代码统一入口
│       └── ts.ets                                  # ArkTS 类型导出入口文件
│       └── src/main
│           └── ets                                 # ArkTS 业务实现层
│               └── BlobUtilTurboModule.ts          # 鸿蒙侧TurboModule实现类
│               └── BlobUtilPackage.ets              # RN原生模块Package注册类
                └── generated                       # Codegen自动生成桥接代码
│               └── Logger.ets                      # 日志打印工具类
│               └── ReactNativeBlobUtil             # 核心功能实现分组目录
│                   └── ReactNativeBlobUtilImpl.ts  # 顶层统一调度实现
│                   └── ReactNativeBlobUtilFS.ts    # 文件系统相关接口实现
│                   └── ReactNativeBlobUtilReq.ts   # 基础网络请求实现
│                   └── ReactNativeBlobUtilStream.ts# 文件流读写逻辑实现
│                   └── ReactNativeBlobUtilConfig.ts # 请求配置管理模块
│               └── turboModules                    # TurboModule 接口定义目录
│               └── down                            # 文件下载业务模块
│               └── upload                          # 文件上传业务模块
│               └── utils                           # 通用工具类目录
│               └── components                      # ArkUI页面组件目录
│           └── cpp                                 # C++胶水层代码（RNOH桥接层）
│               └── BlobUtilPackage.h               # C++层Package头文件
│               └── CMakeLists.txt                  # C++编译构建配置
│               └── generated                       # Codegen自动生成桥接代码（禁止手动修改）
├── example                                         # Demo演示工程目录
├── README.md                                       # 中文使用文档
└── README_en.md                                    # 英文使用文档

贡献代码

使用过程中发现任何问题，都可以提交 Issue。当然，也非常欢迎提交 PR。

开源协议

本项目基于 The MIT License (MIT)，请自由使用并参与开源。