@capgo/capacitor-asset-cache

로컬 전용 표시 소스

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

영구 네이티브 저장소

캐시된 자산은 앱 소유의 영구 저장소에 저장되며 플랫폼 캐시 폴더가 시스템에 의해 압박으로 제거될 수 있습니다.

보호된 CDN 지원

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

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

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

개요

@capgo/capacitor-asset-cache title

대형 이미지, 비디오 및 기타 CDN 자산을 앱 소유의 영구 저장소에 저장하고 웹 앱에 로컬 소스 URL을 제공하여 표시합니다.

1. 일반 경로는:
2. CDN 기본 URL을 한 번만 구성하거나 asset당 절대 URL을 전달합니다. AssetCache.bind(element, path) 호출 AssetCache.src(path).
3. 원격 자산을 직접 가져오거나 재검증합니다.
4. 로컬 파일이 준비되면만 로컬 웹뷰 URL을 받습니다.

주의

성공적으로 표시되는 API는 로컬 전용입니다. 플러그인이 로컬 파일을 생성하거나 재사용할 수 없으면 src(...) 그리고 resolve(...) 거부하고 bind(...) 엘리먼트를 error.

사용 방법

Asset Cache를 사용하세요. 앱이 일반 저장 압박을 견딜 수 있는 중량의 원격 미디어를 표시할 때: 온보딩 또는 마케팅 비디오를 CDN에서 제공합니다.

• CDN에서 제공하는 온보딩 또는 마케팅 비디오를 표시할 때 앱이 중량의 원격 미디어를 표시할 때
• 세션을跨越하는 hero 이미지, 갤러리, 또는 이미지 시퀀스
• 요청 헤더가 필요한 보호된 미디어
• 이전으로 가져온 로컬 자산이 충분한 오프라인耐性 화면
• Capacitor 앱에서 <img> 및 <video> __CAPGO_KEEP_0__ 앱에서 직접 보호된 URL을 가져오지 않아야 함

Core API

• configure(options) 기본 CDN 및 재검증 동작을 설정합니다.
• bind(element, path, options?) 로컬 파일이 준비되면 이미지 또는 비디오 요소를 업데이트합니다.
• src(path, options?) 프레임워크 상태에 대한 로컬 소스 문자열을 반환합니다.
• resolve(path, options?) 로컬 소스와 캐시 메타데이터를 포함한 로컬 소스를 반환합니다.
• get(options) remote URL을 영구적인 네이티브 파일 메타데이터로 변환합니다.
• remove(options) 키 또는 URL로 하나의 캐시된 자산을 제거합니다.
• clear() 플러그인을 관리하는 모든 캐시된 자산을 제거합니다.
• list() 디스크에 아직 존재하는 캐시된 자산을 반환합니다.
• getCacheSize() 전체 캐시 바이트 수를 반환합니다.
• getPluginVersion() 네이티브 구현 버전 마커를 반환합니다.

재검증 모델

자산당으로 또는 기본값으로 캐시를 확인할 수 있습니다.

전략	기본값
never	파일이 존재할 때 사용할 수 있는 로컬 파일을 사용합니다.
ttl	__CAPGO_KEEP_0__/__CAPGO_KEEP_1__ 다시 다운로드 하세요. maxAgeSeconds.
always	__CAPGO_KEEP_0__/__CAPGO_KEEP_1__ 호출마다 재검증하고 알려진 검증자들을 보냅니다.
etag	__CAPGO_KEEP_0__/__CAPGO_KEEP_1__에 있는 알려진 HTTP ETag 검증자 사용할 때.
last-modified	__CAPGO_KEEP_0__/__CAPGO_KEEP_1__에 있는 알려진 HTTP Last-Modified 검증자 사용할 때.

저장 모델

iOS에서는 파일은 Application Support 아래에 저장되고 iCloud 백업에서 cache 루트를 제외합니다. Android에서는 파일은 앱 내부 파일 디렉토리 아래에 저장됩니다.

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

capgo/capacitor-asset-cache에서 계속 진행하세요.

__CAPGO_KEEP_0__/__CAPGO_KEEP_1__를 사용하고 있다면 @capgo/capacitor-asset-cache __targetLanguage__의 영구 미디어 로딩을 계획하기 위해 연결하세요. Getting Started implementation 세부 사항을 위해 @capgo/capacitor-downloader explicit 배경 다운로드를 위해 @capgo/capacitor-file 일반적인 로컬 파일 접근을 위해, 그리고 Using @capgo/capacitor-asset-cache 튜토리얼을 위해.