UD5工具箱
Manifest 文件
Manifest文件是一个JSON格式的配置文件，通常命名为manifest.json，用于向浏览器提供Web应用的元数据信息。它是PWA（渐进式Web应用）的核心组成部分，定义了应用的名称、图标、启动URL、显示模式等关键属性。通过Manifest文件，Web应用可以实现类似原生应用的安装体验，包括添加到设备主屏幕、全屏运行、自定义启动画面等功能。Manifest文件遵循W3C标准，目前得到所有主流浏览器的支持。
PWA（渐进式Web应用）
PWA是Progressive Web App的缩写，是一种使用现代Web技术构建的应用程序，能够提供类似原生应用的用户体验。PWA的核心特性包括：可安装性（可以添加到主屏幕）、离线可用性（通过Service Worker实现）、推送通知、快速加载等。Manifest文件是实现PWA可安装性的关键，它告诉浏览器如何展示和安装Web应用。PWA技术栈还包括Service Worker、HTTPS等技术，共同构成了完整的PWA解决方案。
Name 与 Short Name
Name（应用名称）是Manifest文件中的必填字段，用于指定应用的完整显示名称。这个名称会在安装确认弹窗、启动画面、应用管理设置等场景中显示，建议不超过45个字符。Short Name（短名称）是可选字段，用于在主屏幕图标下方显示。由于主屏幕空间有限，短名称通常需要控制在12个字符以内。如果未提供Short Name，浏览器会使用Name字段，但可能会进行截断处理。合理配置这两个字段可以确保应用在不同场景下都能正确显示名称。
Start URL 与 Scope
Start URL（起始URL）定义了用户点击主屏幕图标时打开的页面地址，通常是应用的首页路径。Scope（作用域）定义了PWA的导航范围，用户在应用窗口内只能导航到Scope包含的URL路径，超出范围的链接会在外部浏览器中打开。关键规则是Start URL必须在Scope范围内。例如，如果Scope设置为“/app/”，那么Start URL必须是“/app/”下的路径。如果未设置Scope，浏览器会自动使用Manifest文件所在的目录作为默认Scope。正确配置这两个字段对于确保PWA的导航行为符合预期至关重要。
Display 模式
Display模式决定了PWA应用的显示方式和与系统UI的交互方式。standalone（独立模式）是最常用的选项，应用在独立窗口中运行，隐藏浏览器地址栏和导航按钮，提供最接近原生应用的体验。fullscreen（全屏模式）完全隐藏所有系统UI，适合游戏和沉浸式应用场景。minimal-ui（最小化UI模式）保留最小化的浏览器控件（如后退/刷新按钮），同时提供更大的显示区域。browser（浏览器模式）在标准浏览器标签页中打开，没有特殊的PWA体验。选择合适的Display模式对于优化用户体验至关重要。
Theme Color 与 Background Color
Theme Color（主题颜色）影响浏览器工具栏、地址栏和PWA窗口标题栏的显示颜色，在Android Chrome中效果最为明显。它会在应用加载后立即生效，是品牌视觉识别的重要组成部分。Background Color（背景颜色）用于设置PWA启动画面（Splash Screen）的背景色，在应用完全加载前显示。合理的背景颜色配置可以减少启动时的视觉闪烁，提供更平滑的启动体验。建议选择与品牌主色协调的配色方案，两个颜色的配合使用可以打造一致的品牌视觉效果。
Maskable 图标
Maskable（可遮罩）是图标的一种用途模式，专门用于适配Android系统的圆形或圆角图标裁剪。Android系统会根据设备制造商和系统版本的不同，对应用图标应用不同形状的遮罩（如圆形、圆角方形等）。设置purpose为maskable的图标会预留安全区域，确保图标核心内容不被裁剪。建议同时为每个图标设置any和maskable两种用途，确保图标在所有设备上都能正确显示。图标设计时，核心内容应该位于图标中心约80%的区域内，四周留出足够的安全边距。
Service Worker
Service Worker是PWA技术栈的另一个核心组件，是一个运行在浏览器后台的JavaScript脚本。它独立于网页主线程，能够拦截和处理网络请求、实现离线缓存、后台同步、推送通知等功能。虽然Manifest文件本身不包含Service Worker的配置，但Service Worker是实现PWA完整功能的关键。通常需要在HTML页面中注册Service Worker脚本，并在脚本中实现缓存策略。Manifest文件与Service Worker配合使用，才能构建完整的PWA体验。