这个项目能做什么
# 🟡 社区浏览器 CDN 构建 – JavaScript SDK 客户端包
本仓库提供 npm 模块 `@aws-sdk/lib-storage` 的**社区维护、浏览器就绪发行版**。它属于一个更大的集合(`cloud-sdk-builds`),该集合提供各种 AWS SDK for JavaScript v3 包的预构建版本。
## 主要特性
- **零构建步骤**:包会自动构建并发布到 CDN。开发者可以直接在浏览器中使用 SDK 客户端,无需 Webpack、Vite 或其他打包器。
- **CDN 托管**:托管在 jsDelivr 上,可通过 HTML `<script type="importmap">` 轻松集成。
- **版本固定**:支持特定版本 URL,以确保生产环境的稳定性。
- **SRI 完整性**:提供 Subresource Integrity (SRI) 哈希,用于安全加载。
## 使用方法
### Import Map 设置
要使用该包,请在 HTML 中定义 import map:
```html
<script type="importmap">
{
"imports": {
"@aws-sdk/lib-storage": "https://cdn.jsdelivr.net/gh/cloud-sdk-builds/lib-storage@3.1131.0/index.min.mjs"
},
"integrity": {
"https://cdn.jsdelivr.net/gh/cloud-sdk-builds/lib-storage@3.1131.0/index.min.mjs": "sha384-nNlqFhRJ+qNESYQLM/aNxDE11EPiRpG+tqDNwmLQJ5AZuG6ZdxFUCm5mEXj/9F5a"
}
}
</script>
```
### 直接导入
配置完成后,你可以在 JavaScript 中导入该模块:
```javascript
import { ... } from "@aws-sdk/lib-storage";
```
## 可用包
任何在 npm 上发布的官方 `@aws-sdk/*` 模块都可以构建为浏览器 CDN 用途。URL 的模式为:
- **最新版本**:`https://cdn.jsdelivr.net/gh/cloud-sdk-builds/{aws_service_name}/index.min.mjs`
- **特定版本**:`https://cdn.jsdelivr.net/gh/cloud-sdk-builds/{aws_service_name}@{aws_version}/index.min.mjs`
将 `{aws_service_name}` 替换为服务名称(例如 `client-s3`、`lib-storage`),将 `{aws_version}` 替换为所需的版本标签。
## 安全与最佳实践
- **固定版本**:在生产环境中始终固定到特定版本(例如 `@3.1131.0`),以避免更新带来的意外破坏性变更。
- **避免使用最新版**:不要在生产环境中使用 `latest` URL。
- **验证 SRI**:使用提供的 SHA 完整性哈希,确保内容未被篡改。
## 免责声明
本项目是**社区运营的发行版**,**与** Amazon Web Services 或官方 SDK 维护者**无关联、未获其认可或赞助**。所有原始 SDK 源代码仍按其各自的上游许可证授权。
## 贡献
如果你需要支持更多浏览器就绪的 SDK 包,请在主组织的 issue 跟踪器上提交 issue:`https://github.com/cloud-sdk-builds/.github/issues`。
评论
0 评分人数达到10人后显示
登录后参与讨论。