开源项目启动与配置教程

1. 项目的目录结构及介绍

开源项目 Chrome-App-Bound-Encryption-Decryption 的目录结构如下：

Chrome-App-Bound-Encryption-Decryption/
├── backgrounds/              # 后台脚本目录
│   ├── background.js         # 后台脚本文件
├── images/                   # 图片资源目录
├── manifest.json             # 项目配置文件
├── popup/                    # 弹窗界面相关文件
│   ├── popup.html            # 弹窗HTML文件
│   ├── popup.js              # 弹窗JavaScript文件
│   └── popup.css             # 弹窗CSS样式文件
├── scripts/                  # 脚本目录
│   ├── content.js            # 内容脚本文件
│   └── options.js            # 选项页面脚本文件
└── README.md                 # 项目说明文件

• backgrounds/: 存放后台运行的脚本文件。
• images/: 存放项目中用到的图片资源。
• manifest.json: Chrome扩展程序的配置文件，定义了扩展程序的基本信息和权限。
• popup/: 存放弹窗界面的相关文件。
• scripts/: 存放项目中的脚本文件。
• README.md: 项目的说明文件，包含了项目的介绍、使用方法和贡献指南。

2. 项目的启动文件介绍

项目的启动主要通过 manifest.json 文件来配置。以下是 manifest.json 的基本内容和说明：

{
  "manifest_version": 2,
  "name": "Chrome App Bound Encryption Decryption",
  "version": "1.0",
  "description": "An extension to encrypt and decrypt data bound to a Chrome App.",
  "permissions": ["storage", "activeTab"],
  "background": {
    "scripts": ["backgrounds/background.js"],
    "persistent": false
  },
  "browser_action": {
    "default_popup": "popup/popup.html",
    "default_icon": {
      "16": "images/icon16.png",
      "48": "images/icon48.png",
      "128": "images/icon128.png"
    }
  },
  "icons": {
    "16": "images/icon16.png",
    "48": "images/icon48.png",
    "128": "images/icon128.png"
  }
}

• manifest_version: 定义了manifest文件使用的版本。
• name: 扩展程序的名字。
• version: 扩展程序的版本号。
• description: 扩展程序的描述。
• permissions: 扩展程序请求的权限。
• background: 定义了后台脚本的路径和是否持久运行。
• browser_action: 定义了浏览器动作，例如弹窗和图标。
• icons: 定义了不同尺寸的图标。

3. 项目的配置文件介绍

manifest.json 文件不仅是启动文件，也是项目的配置文件。以下是一些主要的配置项：

• permissions: 用于声明扩展程序需要的权限，例如访问存储和当前标签页。
• background: 用于配置后台脚本，scripts 字段指定了后台脚本文件，persistent 字段指定了脚本是否在浏览器关闭后继续运行。
• browser_action: 用于定义浏览器工具栏上的扩展程序按钮，包括默认的弹窗页面和图标。
• icons: 定义了扩展程序的图标，用于工具栏、扩展页面等。

通过编辑 manifest.json 文件，可以调整扩展程序的权限、行为和外观。