拦截100开源项目指南
block100项目地址:https://gitcode.com/gh_mirrors/bl/block100
欢迎来到拦截100(Block 100)的使用和安装教程。本指南将详细解读此开源项目的主要结构、关键文件及其功能,以便您能够更好地理解和使用这个专为提升Safari浏览器用户体验设计的工具。
1. 项目目录结构及介绍
拦截100项目基于Git管理,其主要目录结构如下:
-
根目录:
README.md
: 项目的核心说明文档,提供了项目简介、安装步骤和基本用法。LICENSE
: 指定了该项目遵循的GPL-2.0开源许可协议。.gitignore
: 列出了Git应忽略的文件或目录类型。Resources
: 这是项目的核心资源目录,其中包含两个子目录——jumpapp
和domain
,对拦截逻辑至关重要。
-
Resources目录:
- jumpapp: 子目录用于存放阻止特定应用跳转的脚本,每一个可能的App跳转行为可以通过独立的文件夹进行管理和配置,通过JavaScript实现。
- domain: 匹配不同网站并提供相应处理策略的目录,分为两部分操作:全文展开(
read.js
)和广告去除(call.js
),每个文件夹以其目标网站的域名命名。
2. 项目的启动文件介绍
对于开发者来说,实际的启动并非直接从项目内部某单一“启动文件”进行,而是需要通过Xcode环境来编译和部署Safari Extension。具体步骤包括:
- 在Xcode中新建一个Safari Extension App项目。
- 替换项目中的SafariWebExtension扩展文件夹下的
Resources
文件夹为本项目提供的Resources
目录。 - 编译并运行项目,在Safari浏览器中启用并管理该扩展来启动拦截功能。
3. 项目的配置文件介绍
拦截100的配置分散在Resources
目录中:
- 跳转拦截配置位于
jumpapp
目录,通过对不同网站的针对性JavaScript脚本管理来实现。 - 网站特化配置在于
domain
目录,每一个子目录对应一种网站,通过call.js
和read.js
文件定义了具体的广告移除和全文展开逻辑,这些构成了项目的动态配置核心。
综上所述,拦截100项目通过其精细的资源组织和自定义逻辑,实现了高效的网页内容优化和用户隐私保护功能。开发者可以根据需要调整和增补配置,以适应不同的浏览器环境和网站特性。记得在进行任何改动前仔细阅读项目文档,并遵守GPL-2.0许可协议。