@capgo/capacitor-asset-cache

__CAPGO_KEEP_0__의 중대한 미디어를 앱 소유의 영구 저장소에 캐시하고 이미지나 비디오를 로컬 웹뷰 URL로 바인딩합니다.

시작하기 GitHub

로컬 전용 표시 소스

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

영구 네이티브 저장소

캐시된 자산은 플랫폼 캐시 폴더가 아니라 시스템이 압박하에 삭제할 수 있는 영구 저장소에 저장됩니다.

보호된 CDN 지원

__CAPGO_KEEP_0__ 헤더를 네이티브 fetch에 전달하여 서명된 또는 인증된 자산을 로드하는 동안 웹 요소는 로컬 파일만 로드합니다.

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

__CAPGO_KEEP_0__ native 캐시 해결을 일반 HTML, React refs, Vue refs, 또는 img 또는 video src를 할당할 수 있는 프레임워크와 같은 것과 결합합니다.

__CAPGO_KEEP_0__

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

__CAPGO_KEEP_0__ 경로는 다음과 같습니다.

__CAPGO_KEEP_0__ CDN 기본 URL을 한 번만 구성하거나, 각 자산에 대해 절대 URL을 전달합니다.
__CAPGO_KEEP_0__ AssetCache.bind(element, path) __CAPGO_KEEP_0__ AssetCache.src(path).
__CAPGO_KEEP_0__ 플러그인은 원격 자산을 네이티브로 가져오거나 재검증합니다.
__CAPGO_KEEP_0__ 요소는 로컬 파일이 준비되면만 로컬 웹뷰 URL만을 받습니다.

사용할 때

Asset Cache를 사용하여 앱이 일반 저장 압력을 견디는 중대형 원격 미디어를 표시할 때:

CDN에서 제공하는 온보딩 또는 마케팅 비디오
세션을跨越하는 hero 이미지, 갤러리 또는 이미지 시퀀스
요청 헤더가 필요한 보호된 미디어
이전에 가져온 지역 자산이 충분한 이전에 가져온 지역 자산이 충분한 오프라인 내성 화면
Capacitor 앱 <img> 그리고 직접 보호된 URL을 가져오지 않아야 합니다. <video> 보호된 URL을 직접 가져오지 않아야 합니다.

Core API

configure(options) 기본 CDN 및 재검증 동작을 설정합니다.
bind(element, path, options?) 로컬 파일이 준비되면 이미지 또는 비디오 요소를 업데이트합니다.
src(path, options?) 프레임워크 상태를 위한 로컬 소스 문자열을 반환합니다.
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 검증자를 사용합니다.

Storage Model

iOS에서는 애플리케이션 지원 하위 디렉토리에서 파일을 저장하고 iCloud 백업에서 캐시 루트를 제외합니다. Android에서는 앱 내부 파일 디렉토리에서 파일을 저장합니다.

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

capgo/capacitor-asset-cache에서 계속하기

__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-asset-cache를 사용하는 경우 capgo/capacitor-asset-cache __CAPGO_KEEP_0__/__CAPGO_KEEP_1__-asset-cache를 사용하여 지속적인 미디어 로딩을 계획하고자 할 때, 이를 Getting Started 에 연결하여 구현 세부 사항을 확인하세요. @capgo/capacitor-다운로드기능 백그라운드 다운로드를 명시적으로 수행하기 위해 @capgo/capacitor-파일 일반적인 로컬 파일 접근을 위해, 그리고 @capgo/capacitor-애셋 캐시 튜토리얼을 위해