안내서
__CAPGO_KEEP_0__에서 자산 캐시에 대한 튜토리얼
capgo/capacitor-asset-cache를 사용하여 @capgo
@capgo/capacitor-asset-cache Capacitor에서 자산 캐시를 사용하여 대형 CDN 이미지를 앱 소유의 영구 저장소에 저장하고, Capacitor 웹뷰에서 지역 소스 URL을 반환합니다.
설치
npm install @capgo/capacitor-asset-cache
npx cap sync
이 플러그인이 노출하는 것
bind- 지역 자산 소스에 이미지를 또는 비디오 요소를 연결하고 준비되면 업데이트합니다.src- 지역 자산이 존재할 때까지 지역 소스 문자열을 반환합니다.resolve- 로컬 소스와 캐시 메타데이터를 반환하십시오.configure- 기본 CDN 및 재검증 동작을 설정하십시오.get,list,remove,clear, 그리고getCacheSize- 필요한 경우 캐시를 명시적으로 관리하십시오.
예시 사용
CDN을 한 번 설정한 후 상대 경로로 요소를 바인딩하세요.
import { AssetCache } from '@capgo/capacitor-asset-cache';
AssetCache.configure({
cdnUrl: 'https://cdn.example.com/assets/',
revalidate: {
strategy: 'ttl',
maxAgeSeconds: 86400,
},
});
const hero = document.querySelector<HTMLImageElement>('#hero');
if (hero) {
AssetCache.bind(hero, 'images/hero.jpg');
}
요소는 data-asset-cache-state="loading" 자연스럽게 fetch가 실행되는 동안, 그리고 로컬 소스 URL을 받고 ready.
img[data-asset-cache-state='loading'],
video[data-asset-cache-state='loading'] {
opacity: 0.45;
}
보호된 자산
헤더는 플러그인이 원격 파일을 가져오거나 재검증하는 동안 전송됩니다. 웹 요소는 여전히 로컬 소스 URL만 받습니다.
const src = await AssetCache.src('private/videos/intro.mp4', {
cdnUrl: 'https://cdn.example.com/assets/',
headers: {
Authorization: `Bearer ${token}`,
},
});
CDN Base URL이 없는 경우
CDN Base URL을 설정하지 않으려면 절대 URL을 전달하세요. cdnUrl.
const src = await AssetCache.src('https://cdn.example.com/assets/videos/intro.mp4');
Relative paths는 __CAPGO_KEEP_0__이 구성되거나 __CAPGO_KEEP_0__이 호출될 때만 유효합니다. cdnUrl 또는 __CAPGO_KEEP_0__에 대한 __CAPGO_KEEP_0__ cdnUrl.
Storage Notes
iOS에서 파일은 iCloud 백업에서 제외된 Application Support 아래에 저장되며 Android에서는 앱 내부 파일 디렉토리 아래에 저장됩니다. 시스템은 이러한 파일을 임시 캐시 파일로 취급하지 않지만, 앱을 삭제하거나 앱 데이터를 지우거나 __CAPGO_KEEP_0__을 삭제하면 여전히 삭제됩니다. clear()Full Reference remove() __CAPGO_KEEP_0__:
https://__CAPGO_KEEP_0__.com/Cap-go/__CAPGO_KEEP_1__-asset-cache/
- GitHub: github를 사용하는 @github/capacitor-asset-cache에서 계속 진행하세요.
- __CAPGO_KEEP_0__을 사용 중입니다.
Keep going from Using @capgo/capacitor-asset-cache
__CAPGO_KEEP_0__ Using @capgo/capacitor-asset-cache persistent 미디어 로딩을 계획하기 위해 사용하세요. @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-asset-cache @capgo/capacitor-asset-cache persistent 미디어 로딩을 계획하기 위해 사용하세요. @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-asset-cache Getting Started implementation details background 다운로드를 명시적으로 수행하기 위해 @capgo/capacitor-downloader explicit background downloads, and local 파일에 대한 일반적인 접근을 위해 @capgo/capacitor-file Footer