Skip to content

@capgo/capacitor-자산 캐시

앱 소유의 영구 저장소에서 캐시 하중 있는 CDN 미디어를 저장하고, 이미지 또는 비디오를 로컬 웹뷰 URL로 바인딩합니다.

로컬 전용 표시 소스

src, resolve, 그리고 bind 로컬 파일이 존재하는 경우에만 원본을 반환합니다. img 또는 video 태그는 로컬 웹뷰 URL을 받습니다.

영구 저장소

캐시된 자산은 앱 소유의 영구 저장소에 저장되며, 시스템이 압박을 받을 때 플랫폼 캐시 폴더를 삭제할 수 있습니다.

보호된 CDN 지원

인증된 자산이나 서명된 자산을 로드하는 동안 네이티브 fetch에 헤더를 전달합니다.

프레임워크 친화적인 바인딩

plain HTML, React refs, Vue refs, 또는 img 또는 video src를 할당할 수 있는 프레임워크와 같은 네이티브 캐시 해제를 바인딩합니다.

개요

개요

@capgo/capacitor-asset-cache 대형 이미지, 비디오 및 기타 CDN 자산을 앱 소유의 영구 저장소에 캐시하고, 웹 앱에 로컬 소스 URL을 제공합니다.

일반적인 경로는 다음과 같습니다.

  1. CDN 기본 URL을 한 번만 설정하거나, 각 자산에 대해 절대 URL을 전달합니다.
  2. Call AssetCache.bind(element, path) or AssetCache.src(path).
  3. Appflow 플러그인은 원격 자산을 직접 가져오거나 다시 유효성을 검사합니다.
  4. 요소는 로컬 파일이 준비되기까지 로컬 웹뷰 URL만 받습니다.

사용할 때

사용 방법

__CAPGO_KEEP_0__

  • 온보딩 또는 마케팅 비디오
  • hero 이미지, 갤러리 또는 이미지 시퀀스
  • 보호된 미디어
  • 오프라인에 내장된 화면
  • Capacitor <img> 그리고 <video> 직접 보호된 URL을 가져오지 않도록
  • configure(options) 이미지 또는 비디오 요소를 로컬 파일이 준비되면 업데이트합니다.
  • bind(element, path, options?) __CAPGO_KEEP_0__
  • src(path, options?) framework 상태를 위한 지역 소스 문자열을 반환합니다.
  • resolve(path, options?) 캐시 메타데이터를 포함한 지역 소스 문자열을 반환합니다.
  • get(options) 원격 URL을 영구 네이티브 파일 메타데이터로 해결합니다.
  • remove(options) 키 또는 URL로 캐시된 자산을 하나 제거합니다.
  • clear() 플러그인이 관리하는 모든 캐시된 자산을 제거합니다.
  • list() 디스크에 아직 존재하는 캐시된 자산을 반환합니다.
  • getCacheSize() 총 캐시 바이트를 반환합니다.
  • getPluginVersion() 네이티브 구현 버전 마커를 반환합니다.

재검증 모델

재검증 모델

캐시를 확인하는 방법은 자산별로 다르게 할 수 있거나 기본값을 통해 할 수 있습니다.

전략동작
never파일이 존재할 때 사용하는 로컬 파일을 사용합니다.
ttl재다운로드 후 maxAgeSeconds.
always모든 호출에서 재검증하고 알려진 검증자들을 전송합니다.
etag알려진 HTTP ETag 검증자 사용할 때.
last-modified알려진 HTTP Last-Modified 검증자 사용할 때.

캐시는 앱 샌드박스 내부에 숨겨져 있으며 공공 사용자 미디어로 표시되지 않습니다. 앱이 삭제되면, 사용자가 앱 데이터를 삭제하거나, 또는 앱이

또는 clear() 앱플로우 remove().

만약 __CAPGO_KEEP_0__/__CAPGO_KEEP_1__-asset-cache을 사용 중이라면 capgo/capacitor-asset-cache __CAPGO_KEEP_0__/__CAPGO_KEEP_1__-asset-cache을 사용하여 지속적인 미디어 로딩을 계획하고자 한다면 Getting Started implementation 방법에 대한 자세한 내용은 capgo/capacitor-downloader explicit 배경 다운로드를 위해 capgo/capacitor-file 일반적인 로컬 파일 접근을 위해 capgo/capacitor-asset-cache 사용자 가이드