로컬 전용 표시 소스
src, resolve, 그리고 bind 로컬 파일이 존재하는 후에 소스를 반환합니다. img 또는 video 태그는 로컬 웹뷰 URL을 받습니다.
영구 네이티브 저장소
캐시된 자산은 앱 소유의 영구 저장소에 존재하며, 플랫폼 캐시 폴더가 시스템에 의해 압박으로 제거될 수 있는 곳이 아닙니다.
보호된 CDN 지원
서명 또는 인증된 자산을 로드하는 동안 웹 요소는 로컬 파일만 로드합니다.
프레임워크 친화적인 바인딩
바인딩
개요
개요@capgo/capacitor-asset-cache 대용량 이미지를, 비디오 및 기타 CDN 자산을 앱 소유의 지속적 저장소에 캐시하고, 웹 앱에 로컬 소스 URL을 제공합니다.
일반적인 경로는 다음과 같습니다.
- CDN 기본 URL을 한 번만 구성하거나, 자산당 절대 URL을 전달합니다.
- 호출
AssetCache.bind(element, path)또는AssetCache.src(path). - 원격 자산을 직접 가져오거나 재검증합니다.
- 플러그인은 원격 자산을 네이티브로 가져오거나 재검증합니다.
온보딩 또는 마케팅 비디오가 CDN에서 제공되는 경우
- 히어로 이미지, 갤러리 또는 세션 간에 재사용되는 이미지 시퀀스
- 보호된 미디어가 요청 헤더가 필요할 때
- protected media that requires request headers
- offline-tolerant 화면에서 이전에 다운로드 한 로컬 자산이 충분합니다.
- Capacitor 앱에서
<img>and<video>직접 보호된 URL을 fetch하지 않아야 합니다.
Core API
Core APIconfigure(options)기본 CDN 및 재검증 동작을 설정합니다.bind(element, path, options?)이미지나 비디오 요소를 로컬 파일이 준비되면 업데이트합니다.src(path, options?)프레임워크 상태를 위한 로컬 소스 문자열을 반환합니다.resolve(path, options?)로컬 소스와 캐시 메타데이터를 포함한 로컬 소스를 반환합니다.get(options)원격 URL을 영구적인 네이티브 파일 메타데이터로 해결합니다.remove(options)캐시된 자산을 하나 제거합니다.clear()캐시된 모든 자산을 관리하는 플러그인에서 제거합니다.list()디스크에 아직 존재하는 캐시된 자산을 반환합니다.getCacheSize()캐시된 바이트의 총량을 반환합니다.getPluginVersion()자연적인 구현 버전 마커를 반환합니다.
재검증 모델
제목: 재검증 모델캐시를 확인하는 방법은 자산별로 다르게 할 수 있거나 기본값을 통해 할 수 있습니다.
| 전략 | 동작 |
|---|---|
never | 파일이 존재할 때 사용하는 파일을 사용합니다. |
ttl | 재다운로드 후 maxAgeSeconds. |
always | 모든 호출에서 재검증하고 알려진 검증자들을 전송합니다. |
etag | HTTP ETag validator를 사용하세요. |
last-modified | HTTP Last-Modified validator를 사용하세요. |
저장 모델
저장 모델iOS에서는 파일을 Application Support 폴더에 저장하고 iCloud 백업에서 캐시 루트를 제외합니다. Android에서는 앱 내부 파일 폴더에 파일을 저장합니다.
캐시는 앱 샌드박스 내부에 숨겨져 있으며 공공 사용자 미디어로 표시되지 않습니다. 앱이 삭제되면, 사용자가 앱 데이터를 삭제하거나 앱이 clear() 또는 remove().
capgo에서 capacitor까지 자산 캐시
@capgo/capacitor-자산 캐시에서 계속 진행앱플로우 @capgo/capacitor-자산 캐시 앱플로우 플러그인 또는 시작하기 implementation 세부 사항을 위해 @capgo/capacitor-다운로더 explicit 배경 다운로드를 위해 @capgo/capacitor-파일 일반적인 로컬 파일 접근을 위해, 그리고 Using @capgo/capacitor-어셋 캐시 튜토리얼을 위해