メインコンテンツにスキップ
プラグインに戻る
@capgo/capacitor-ファイルシェア
チュートリアル
by github.com/Cap-go

ファイルシェア

Android、iOS、Webを対象に、base64データまたはローカルパスからファイルを共有して保存する

ガイド

ファイルシェアのチュートリアル

「@capgo/capacitor-file-sharer」を使用

base64データ、データURL、ローカルファイルパス、URL、Android、URI、__CAPGO_KEEP_0__からファイルを共有して保存する file:// URL、 content:// URIs, and Capacitor _capacitor_file_ インストール

このプラグインが公開するもの

bun add @capgo/capacitor-file-sharer
bunx cap sync

- AndroidとiOSでネイティブシェアシートを開く、またはWebでファイルをダウンロードする

  • share - Androidのパブリックコレクションに保存、iOSの保存/共有シートを開く、またはWebでダウンロードする
  • save - プラットフォーム実装バージョンを返す
  • getPluginVersion 使用例

生成されたファイルを共有する

ローカルファイルを共有する

import { FileSharer } from '@capgo/capacitor-file-sharer';

await FileSharer.share({
  filename: 'report.pdf',
  contentType: 'application/pdf',
  base64Data: reportBase64,
  title: 'Quarterly report',
  text: 'Attached report',
});

Install Capgo to start using this plugin.

await FileSharer.share({
  filename: 'export.zip',
  contentType: 'application/zip',
  path: fileUri,
});

Android に保存

const result = await FileSharer.save({
  filename: 'backup.zip',
  contentType: 'application/zip',
  base64Data: zipBase64,
  android: {
    saveDirectory: 'downloads',
    relativePath: 'Download/My App',
  },
});

console.log(result.uri);

Platform Notes

  • Android の共有は、 FileProvider, ClipDataと URI の許可により、ファイルのプレビューとサムネールが読み取ることができます。
  • Android の保存は、Android 10 以降では MediaStore を使用し、Android 9 以下ではパブリック ディレクトリを使用します。
  • iOS の共有は、base64 でバックアップされた一時ファイルと直接ローカルパスを共有する両方をサポートします。
  • Web の共有とダウンロードはファイルをダウンロードし、大きなファイルの場合に分割された base64 の変換を使用します。

Full Reference