AdGuardForSafari 开源项目常见问题解决方案

AdGuardForSafari 开源项目常见问题解决方案

AdGuardForSafari AdGuard for Safari app extension 项目地址: https://gitcode.com/gh_mirrors/ad/AdGuardForSafari

1. 项目基础介绍和主要编程语言

AdGuardForSafari 是由 AdguardTeam 开发的一款针对 Safari 浏览器的广告拦截扩展。该扩展基于 Safari 的原生内容拦截 API，提供了高效且高度可定制的广告拦截功能。它允许用户选择流行的过滤器订阅、创建自定义过滤规则、手动屏蔽网站以及将网站加入白名单等。AdGuardForSafari 使用的主要编程语言包括 JavaScript、Swift 以及一些原生脚本语言。

2. 新手在使用这个项目时需要特别注意的3个问题及解决步骤

问题一：如何配置开发环境

问题描述： 新手在使用 AdGuardForSafari 项目时，可能会遇到不知道如何配置开发环境的问题。

解决步骤：

1. 确保你的操作系统为 MacOS 13.1 或以上版本。

2. 安装 Xcode 14.3 或以上版本的 IDE。

3. 安装 Xcode 命令行工具。

4. 安装 Node.js v18.17.1 或更高版本。

5. 安装 Yarn 包管理工具。

6. 全局安装以下工具：electron-packager、node-gyp、electron-osx-sign。

   执行以下命令进行安装：

   yarn global add electron-packager
   yarn global add node-gyp
   yarn global add electron-osx-sign
   

问题二：如何运行项目

问题描述： 新手可能不清楚如何启动 AdGuardForSafari 项目。

解决步骤：

1. 切换到项目中的 ElectronMainApp 目录下。
2. 使用以下命令安装本地依赖：

   yarn install
   

3. 运行以下命令启动应用程序：

   cd ElectronMainApp
   npm start
   

问题三：如何在项目中调试

问题描述： 初学者在开发过程中可能会遇到不知道如何在 AdGuardForSafari 项目中进行调试的问题。

解决步骤：

1. 在项目目录中找到并打开调试窗口。
2. 使用以下命令启动调试模式：

   npm run debug
   

3. 在调试窗口中，你可以设置断点、查看变量值以及执行其他调试操作。

AdGuardForSafari AdGuard for Safari app extension 项目地址: https://gitcode.com/gh_mirrors/ad/AdGuardForSafari