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

파일 픽커 Capacitor 플러그인

__CAPGO_KEEP_0__ 플러그인을 사용하여 iOS 및 Android에서 HEIC 변환을 포함한 모든 네이티브 지원으로 파일, 이미지, 비디오 및 디렉토리를 선택하세요.

설치

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

가이드

How to use File Picker in Capacitor

@capgo/capacitor-file-picker을 사용하는 방법

Capacitor 파일 픽커 플러그인: 파일, 이미지, 비디오 및 디렉토리를 선택하기 위한 인터페이스

설치

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

bunx cap sync code의 네이티브 코드를 프로젝트에 복사합니다. 플러그인 업그레이드 후 다시 실행하세요.

import

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

API의 기능을 한눈에

메서드 Description
pickFiles 갤러리에서 하나 이상의 이미지를 선택합니다. (안드로이드/아이오스 전용)
pickImages 갤러리에서 하나 이상의 비디오를 선택합니다. (안드로이드/아이오스 전용)
pickVideos __CAPGO_KEEP_0__
pickMedia 갤러리에서 하나 이상의 이미지 또는 비디오를 선택하세요. Android/iOS만.
pickDirectory 장치에서 폴더를 선택하세요. Android/iOS만.
convertHeicToJpeg iOS에서 HEIC 이미지 형식을 JPEG 형식으로 변환하세요.
copyFile 파일을 새로운 위치로 복사하세요.
checkPermissions Android 13 이상에서 광범위한 저장소 또는 미디어 권한 상태를 확인하세요. 픽커 전용 흐름은 이 권한에 의존해서는 안 됩니다. pickFiles(), pickImages(), pickVideos()또는 pickMedia() 안드로이드 13+에서 이 권한을 사용합니다. 안드로이드 전용.
requestPermissions or READ_MEDIA_IMAGES or READ_MEDIA_VIDEO or @capgo/capacitor-file-picker or

예시

pickFiles()

장치에서 하나 이상의 파일을 선택하세요.

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

const result = await CapgoFilePicker.pickFiles({
  types: ['application/pdf', 'image/*'],
  limit: 5,
  readData: false
});
console.log('Picked files:', result.files);

pickImages()

갤러리에서 하나 이상의 이미지를 선택하세요. (Android, iOS만)

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

const result = await CapgoFilePicker.pickImages({
  limit: 10,
  readData: false
});
console.log('Picked images:', result.files);

pickVideos()

갤러리에서 하나 이상의 비디오를 선택하세요. (Android, iOS만)

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

const result = await CapgoFilePicker.pickVideos({
  limit: 3,
  skipTranscoding: true
});
console.log('Picked videos:', result.files);

pickMedia()

갤러리에서 하나 이상의 이미지를 또는 비디오를 선택하세요. (Android, iOS만)

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

const result = await CapgoFilePicker.pickMedia({
  limit: 5,
  readData: true
});
console.log('Picked media:', result.files);

pickDirectory()

장치에서 하나의 폴더를 선택하세요. (Android, iOS만)

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

const result = await CapgoFilePicker.pickDirectory();
console.log('Selected directory:', result.path);

convertHeicToJpeg()

iOS에서 HEIC 이미지를 JPEG 형식으로 변환하세요.

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

const result = await CapgoFilePicker.convertHeicToJpeg({
  path: '/path/to/image.heic',
  quality: 0.9
});
console.log('Converted file:', result.path);

위 표에는 9개의 핵심 메서드가 나열되어 있습니다. 리스너 및 버전 헬퍼, 각 메서드의 전체 계약은 __CAPGO_KEEP_0__ 저장소에서 문서화되어 있습니다. GitHub 저장소.

핸들 반환. 화면이 언마운트되면 또는

addListener 모든 리스너를 해제하세요. handle.remove() 화면이 언마운트되면 또는 CapgoFilePicker.removeAllListeners() 모든 리스너를 해제하세요.

전체 참조

@capgo/capacitor-파일 선택기에서 계속 사용하세요

Using @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-file-picker @capgo/capacitor-파일 선택기 storage 및 파일 처리를 계획하고 연결하려면 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-file-picker @capgo/capacitor-파일 선택기 @capgo/capacitor-file-picker Getting Started Getting Started @capgo/capacitor-SQLite 데이터 저장소 @capgo/capacitor-data-storage-sqlite Capacitor @capgo/capacitor-data-storage-sqlite Capacitor @capgo/capacitor-data-storage-sqlite @capgo/capacitor-파일 @capgo/capacitor-파일 구현 세부 사항을 위해

FAQ

파일 픽커 플러그인 FAQ

파일 픽커 플러그인을 Capacitor 앱에 설치하는 방법은?

Run "bun add @capgo/capacitor-file-picker" (or "npm install @capgo/capacitor-file-picker"), then run "bunx cap sync" so the iOS and Android projects pick up the native code. Import it from "@capgo/capacitor-file-picker" in your app code.

React, Vue 및 Angular과 함께 @capgo/capacitor-file-picker가 작동하는가?

네. 파일 픽커는 Capacitor 패키지이므로 Ionic, React, Vue, Angular, Svelte 및 일반 JavaScript와 같은 웹 프레임워크가 Capacitor 내부에서 작동하는 경우에 작동합니다.

Which Capacitor version does @capgo/capacitor-file-picker support?

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-파일 선택기 는 무료이며 오픈 소스인가요?

네. 소스 code는 GitHub 에서 https://github.com/Cap-go/capacitor-파일 선택기/ 에 공개되어 있으며 npm 에서 무료로 설치할 수 있습니다. 버그 리포트와 풀 리퀘스트는 환영합니다.

code가 File Picker를 사용하는 경우 App Store 리뷰 없이 업데이트가 가능한가요?

code를 설치하거나 업그레이드하면 네이티브 code이 변경되므로 새로운 스토어 빌드를 필요로 합니다. 그 후에 JavaScript, HTML 및 CSS 변경 사항이 플러그인을 호출하는 경우 Capgo 라이브 업데이트와 함께 즉시 배포할 수 있습니다.

앱 리뷰 기다리지 않고 파일 픽커 변경을 배포하세요.

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

Capgo로 시작하세요.