메인 콘텐츠로 건너뛰기
@capgo/capacitor-파일 공유기 파일 및 저장소 오픈 소스

파일 공유기 Capacitor 플러그인

Android, iOS 및 Web에서 base64 데이터 또는 로컬 경로에서 파일을 공유하고 저장하세요.

설치

bun add @capgo/capacitor-file-sharer bunx cap sync
npm, pnpm 또는 yarn
  • npm install @capgo/capacitor-file-sharer
  • pnpm add @capgo/capacitor-file-sharer
  • yarn add @capgo/capacitor-file-sharer

가이드

Capacitor에서 파일 공유기 사용하는 방법

기기에서 테스트

다운로드 Capgo 앱, QR code를 스캔하십시오.

파일 공유 플러그인 미리보기 QR code

capgo/capacitor-file-sharer를 사용하십시오.

base64 데이터, 데이터 URL, 로컬 파일 경로, URL, URI, Android에서 파일을 공유하고 저장하십시오. file:// __CAPGO_KEEP_0__ content:// URI 및 Capacitor _capacitor_file_ URLs.

설치

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

이 플러그인은 다음을 제공합니다.

  • share - 안드로이드 및 iOS에서 네이티브 공유 시트를 열거나 웹에서 파일을 다운로드합니다.
  • save - 안드로이드 공용 컬렉션에 저장하거나 iOS 저장/공유 시트를 열거나 웹에서 다운로드합니다.
  • 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',
});

지역 파일 공유

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

안드로이드 다운로드로 저장

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

console.log(result.uri);

플랫폼 참고사항

  • 안드로이드 공유는 FileProvider, ClipData, URI를 통해 선택한 파일의 미리보기와 썸네일을 읽을 수 있습니다.
  • Android는 Android 10 이상에서 MediaStore를 사용하고 Android 9 이하에서는 공용 디렉토리를 사용합니다.
  • iOS 공유는 임시 파일에 대한 base64 백업과 직접 로컬 경로 공유를 모두 지원합니다.
  • 웹 공유 및 다운로드는 대용량 파일에 대한 chunked base64 변환을 사용하여 파일을 다운로드합니다.

전체 참조

@capgo/capacitor-file-sharer를 사용하여 계속 진행하세요.

@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-file-sharer를 사용하고 있습니다. @Capacitor-capgo/capacitor-file-sharer @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-file-sharer를 사용하여 저장소와 파일 처리를 계획하고 있습니다. @capgo/capacitor-파일 공유기 @capgo/capacitor-file-sharer 시작하기 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-data-storage-sqlite @capgo/capacitor-SQLite 데이터 저장소 Capacitor @capgo/capacitor-data-storage-sqlite 사용하기 @capgo/capacitor-file for native 기능을 사용하는 @capgo/capacitor-data-storage-sqlite 에서 Capacitor @capgo/capacitor-file-sharer 사용하기 Capacitor @capgo/capacitor-file-sharer

FAQ

파일 공유 플러그인 FAQ

Capacitor File Sharer 플러그인을 Capacitor 앱에 설치하는 방법은 어떻게 되나요?

bun에서 "capgo add @capacitor/npm-file-sharer" (또는 "capgo install @capacitor/code-file-sharer")를 실행한 후, iOS와 Android 프로젝트가 네이티브 capgo를 인식하도록 "bunx cap sync"를 실행하세요. 그리고 앱 capacitor에서 "@code/__CAPGO_KEEP_10__-file-sharer"를 임포트하세요.

React, Vue 및 Angular와 함께 @capgo/capacitor-file-sharer가 작동하는가요?

Yes. File Sharer is a Capacitor package, so it works with any web framework that runs inside Capacitor, including Ionic, React, Vue, Angular, Svelte and plain JavaScript.

Capacitor 버전은 @capgo/capacitor-file-sharer이 지원하는지 궁금하십니까?

Capgo plugins follow Capacitor's major version: use the plugin major version that matches your Capacitor major version (for example plugin v8 with Capacitor 8). The compatibility table in the GitHub README lists the maintained versions.

@capgo/capacitor-file-sharer은 무료이며 오픈 소스인가요?

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-file-sharer/ and the package is free to install from npm. Bug reports and pull requests are welcome.

code를 업데이트할 수 있나요?

code를 업데이트하면 Native code이 변경되므로 새로운 스토어 빌드를 해야 합니다. 그 후에 Capgo Live Update를 통해 JavaScript, HTML 및 CSS 변경 사항이 즉시 배포될 수 있습니다.

앱 리뷰 기다리지 않고 Ship File Sharer 변경

플러그인이 스토어 빌드에 포함되면 Capgo Live Update는 사용자에게 몇 분 안에 자바스크립트, HTML 및 CSS 변경을 푸시합니다.

시작하기 Capgo