Aegis身份验证器中的图标包使用指南

Aegis身份验证器中的图标包使用指南

Aegis A free, secure and open source app for Android to manage your 2-step verification tokens. 项目地址: https://gitcode.com/gh_mirrors/ae/Aegis

图标包概述

Aegis身份验证器支持通过自定义图标包来美化和管理两步验证条目。图标包本质上是一个包含多个图标文件和配置文件的压缩包，允许用户为不同的服务提供商添加精美的图标。

图标包文件结构

图标包采用ZIP压缩格式，必须包含以下内容：

1. pack.json - 核心配置文件，定义图标包元数据和图标列表
2. 图标文件 - 支持SVG、PNG和JPEG格式的图片文件

pack.json文件详解

pack.json文件采用JSON格式，包含以下关键字段：

{
    "uuid": "c553f06f-2a17-46ca-87f5-56af90dd0500",
    "name": "示例图标包",
    "version": 1,
    "icons": [
        {
            "name": "Google",
            "filename": "services/Google.png",
            "category": "服务类",
            "issuer": ["google"]
        }
    ]
}

• uuid：唯一标识符，一旦生成不应更改
• name：图标包名称，显示给用户
• version：版本号，更新时递增
• icons：图标列表，每个图标包含：
  • name：可选，图标名称
  • filename：图标文件路径（相对路径）
  • category：分类信息
  • issuer：匹配字符串列表（不区分大小写）

图标文件格式支持

Aegis按以下优先级支持图标格式：

1. SVG（矢量图形，推荐使用）
   • MIME类型：image/svg+xml
   • 文件扩展名：.svg
2. PNG（无损位图）
   • MIME类型：image/png
   • 文件扩展名：.png
3. JPEG（有损压缩位图）
   • MIME类型：image/jpeg
   • 文件扩展名：.jpg

图标匹配机制

当用户在Aegis中添加新条目时，系统会自动匹配"issuer"字段与图标包中的issuer列表。匹配规则如下：

1. 不区分大小写
2. 支持多个匹配关键词（如["blizzard", "battle.net"]）
3. 按图标包导入顺序检查匹配

图标包导入流程

1. 用户下载图标包ZIP文件
2. 通过Aegis设置菜单导入
3. 系统解压并验证内容
4. 文件存储在内部目录：icons/{uuid}/{version}
5. 如果存在旧版本，自动替换为新版本

图标选择与使用

导入后，用户可以通过以下方式使用图标：

1. 自动匹配：添加新条目时自动建议匹配图标
2. 手动选择：从图标选择对话框浏览所有可用图标
3. 持久化存储：选定的图标会复制并存储在保险库文件中

最佳实践建议

1. 图标设计：

   • 优先使用SVG格式，确保清晰度
   • 保持一致的视觉风格
   • 推荐尺寸：至少128x128像素

2. 匹配规则：

   • 包含服务商常见名称变体
   • 考虑常见拼写错误
   • 为国际服务添加多语言关键词

3. 版本管理：

   • 内容更新时递增版本号
   • 保持uuid不变
   • 测试新旧版本兼容性

通过合理使用图标包功能，可以显著提升Aegis的视觉体验和使用便利性，让两步验证管理变得更加直观和个性化。

Aegis A free, secure and open source app for Android to manage your 2-step verification tokens. 项目地址: https://gitcode.com/gh_mirrors/ae/Aegis