主题包结构
了解导出主题包中包含的文件,以及 Chrome 安装后可能生成的缓存文件。
用创作器导出 ZIP 并解压后,常见结构大致是:
my-theme/
|-- manifest.json ← 主题配置(名称、颜色、图片路径、图标等)
|-- images/ ← 背景图、外框图等
`-- icons/
`-- icon-128.png ← 商店 / 扩展管理页图标(始终会有)创作器会在导出时写入 128×128 的 icons/icon-128.png,并在 manifest.json 里声明 icons["128"]。你可以在「Chrome 商店上架」里上传自定义商店图标;不填时会优先使用背景图生成,没有背景图时再按主题色和名称首字母生成。
安装后多出来的文件:Cached Theme.pak
把主题加载到 Chrome 之后,主题文件夹里通常还会出现:
my-theme/
|-- manifest.json
|-- images/
|-- icons/
`-- Cached Theme.pak ← Chrome 自动生成的缓存包Cached Theme.pak 是 Chrome 安装主题时自动生成的缓存文件,用于提高加载速度。无需手动创建或编辑,创作器导出的 ZIP 通常也不会包含该文件。
使用时请注意:
- 不用自己创建或编辑这个文件
- 检查其他已安装主题的文件时,看到该文件属于正常现象
- 若你在本地改了图片或
manifest.json后外观没更新,可删掉Cached Theme.pak,再重新加载主题,让 Chrome 按新文件重新生成缓存;仍无效时,到 设置 → 外观 → 重置为默认 后再加载一次(详见 常见问题)
使用时需要注意的内容
大多数时候,用创作器导出即可,不必手改这些文件。
手动检查主题包时,请确认以下三点:
- 解压后的根目录里要有配置文件
manifest.json - 图片要放在包里,路径要能对上(不能写网上的外链图片)
- 包内应有
icons/icon-128.png(上架 Chrome 网上应用店需要;创作器导出时会自动生成)
配置文件包含的内容
- 主题名称、版本、简介
- 商店图标路径(
icons) - 颜色、图片、布局等外观设置
更细的每一项说明见 可调样式一览。