上传

GitHub npm crates.io

API 参考

通过 HTTP 将文件从磁盘上传到远程服务器。 从远程 HTTP 服务器下载文件到磁盘。

支持的平台

此插件需要至少 1.77.2 的 Rust 版本

平台	级别	注释
windows
linux
macos
android
ios

设置

自动

使用您的项目包管理器添加依赖项

npm

npm run tauri add upload

yarn

yarn run tauri add upload

pnpm

pnpm tauri add upload

deno

deno task tauri add upload

bun

bun tauri add upload

cargo

cargo tauri add upload

手动

1. 在 src-tauri 文件夹中运行以下命令，将插件添加到 Cargo.toml 项目的依赖项中

   cargo add tauri-plugin-upload

2. 修改 lib.rs 以初始化插件

   src-tauri/src/lib.rs

   #[cfg_attr(mobile, tauri::mobile_entry_point)]
   pub fn run() {
     tauri::Builder::default()
       .plugin(tauri_plugin_upload::init())
         .run(tauri::generate_context!())
         .expect("error while running tauri application");
   }

3. 使用您首选的 JavaScript 包管理器安装 JavaScript Guest 绑定

   npm

   npm install @tauri-apps/plugin-upload

   yarn

   yarn add @tauri-apps/plugin-upload

   pnpm

   pnpm add @tauri-apps/plugin-upload

   deno

   deno add npm:@tauri-apps/plugin-upload

   bun

   bun add @tauri-apps/plugin-upload

用法

一旦您完成了插件的注册和设置过程，您就可以通过 JavaScript guest 绑定访问其所有 API。

以下是如何使用插件上传和下载文件的示例

import { upload } from '@tauri-apps/plugin-upload';
// when using `"withGlobalTauri": true`, you may use
// const { upload } = window.__TAURI__.upload;

upload(
  'https://example.com/file-upload',
  './path/to/my/file.txt',
  ({ progress, total }) =>
    console.log(`Uploaded ${progress} of ${total} bytes`), // a callback that will be called with the upload progress
  { 'Content-Type': 'text/plain' } // optional headers to send with the request
);

import { download } from '@tauri-apps/plugin-upload';
// when using `"withGlobalTauri": true`, you may use
// const { download } = window.__TAURI__.upload;

download(
  'https://example.com/file-download-link',
  './path/to/save/my/file.txt',
  ({ progress, total }) =>
    console.log(`Downloaded ${progress} of ${total} bytes`), // a callback that will be called with the download progress
  { 'Content-Type': 'text/plain' } // optional headers to send with the request
);

权限

默认情况下，所有潜在危险的插件命令和作用域都被阻止且无法访问。您必须修改 capabilities 配置中的权限才能启用这些。

有关更多信息，请参阅功能概述，以及使用插件权限的分步指南。

src-tauri/capabilities/default.json

{
  "permissions": [
    ...,
    "upload:default",
  ]
}

默认权限

此权限集配置了从上传插件可以执行的操作类型。

已授予的权限

默认情况下，所有操作均已启用。

此默认权限集包括以下内容

• allow-upload
• allow-download

权限表

标识符	描述
upload:allow-download	启用下载命令，无需任何预配置的作用域。
upload:deny-download	拒绝下载命令，无需任何预配置的作用域。
upload:allow-upload	启用上传命令，无需任何预配置的作用域。
upload:deny-upload	拒绝上传命令，无需任何预配置的作用域。