본문으로 건너뛰기

다운로드 (Download)

파일 및 이미지를 기기에 다운로드하거나 갤러리에 저장하는 모듈입니다.

개요​

appify.download는 원격 URL의 파일을 기기에 내려받는 기능을 제공합니다. URL의 MIME 타입에 따라 자동으로 처리 방식이 결정됩니다.

  • 이미지 (image/*): 기기 갤러리(사진 보관함)에 저장
  • 그 외 파일: 기기 저장소(다운로드 폴더)에 저장

API​

download(options: DownloadOptions): Promise<boolean>​

URL에서 파일을 다운로드합니다. 파일 타입은 URL 확장자를 기반으로 자동 판별됩니다.

매개변수

이름타입필수설명
optionsDownloadOptions예다운로드 옵션 객체
options.urlstring예다운로드할 파일의 URL
options.namestring아니오저장할 파일 이름 (미지정 시 URL에서 자동 추출)

반환값: Promise<boolean> - 다운로드 성공 여부

예제

import { appify } from '@nolraunsoft/appify-sdk';

// 기본 파일 다운로드 (파일명 자동 추출)
await appify.download.download({ url: 'https://example.com/document.pdf' });

// 파일명 지정
await appify.download.download({
  url: 'https://example.com/report.pdf',
  name: '월간보고서.pdf',
});

// 이미지 → 자동으로 갤러리에 저장
await appify.download.download({ url: 'https://example.com/photo.jpg' });

// 이미지 + 파일명 지정
await appify.download.download({
  url: 'https://example.com/profile.jpg',
  name: 'profile_image.jpg',
});

타입 정의​

interface DownloadOptions {
  url: string;
  name?: string;
}

자동 판별 기준​

URL 확장자를 기반으로 MIME 타입을 추론하며, image/*에 해당하면 갤러리에 저장됩니다.

확장자저장 위치
.jpg, .jpeg, .png, .webp, .gif, .bmp, .heic, .heif갤러리
.svg갤러리
.pdf, .zip, .txt, .csv, .mp4 등다운로드 폴더

플랫폼별 참고사항​

  • 이미지 저장 시 iOS에서는 사진 라이브러리 접근 권한이 필요합니다.
  • Android에서는 OS 버전에 따라 외부 저장소 쓰기 권한이 필요할 수 있습니다.

관련 문서​