configuring-webapp-csp-trusted-sites

用途：当 Salesforce Web 应用引用尚未注册的外部域名时，使用本技能创建 CSP Trusted Site 元数据，防止浏览器因 Content Security Policy 拦截资源，导致图片不显示、API 调用失败或字体缺失。

适用场景：新增 CDN 图片、外部字体、第三方 API、地图瓦片、外部 iframe（如 YouTube、Vimeo）、外部样式或脚本等。

主要步骤：

1. 扫描代码中的外部 URL，提取源（scheme + host），例如 https://api.open-meteo.com/v1/forecast 取 https://api.open-meteo.com。
2. 检查现有内容：ls force-app/main/default/cspTrustedSites/，已注册则无需处理。
3. 根据资源类型设置对应的 isApplicableTo*Src 字段，如图片用 isApplicableToImgSrc，API 用 isApplicableToConnectSrc，字体用 isApplicableToFontSrc 等；通常还需始终将 isApplicableToConnectSrc 设为 true。
4. 参考 implementation/metadata-format.md 创建 .cspTrustedSite-meta.xml 文件，放入 force-app/main/default/cspTrustedSites/。
5. 验证 XML 有效、路径正确、只设置必要字段，并运行 cd force-app/main/default/webapplications/<appName> && npm run lint && npm run build，确保 lint 零错误且构建成功。

限制：具体字段映射与元数据格式以 implementation/metadata-format.md 为准；资料未提供更多收费、平台支持或版本信息。