AdGuard for Safari 项目教程

AdGuard for Safari 项目教程

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

1. 项目目录结构及介绍

AdGuard for Safari 项目的目录结构如下：

AdGuardForSafari/
├── AdGuard.xcworkspace
├── AdGuardResources
├── ElectronMainApp
├── MediaResources
├── Scripts
├── Shared
├── bamboo-specs
├── fastlane
├── .gitattributes
├── .gitignore
├── twosky.json
├── CHANGELOG.md
├── Gemfile
├── Gemfile.lock
├── LICENSE
├── README.md
├── build.sh
└── configure.sh

目录介绍

• AdGuard.xcworkspace: Xcode 工作区文件，用于管理和构建项目。
• AdGuardResources: 包含项目所需的资源文件，如图片、样式表等。
• ElectronMainApp: Electron 应用程序的主目录，包含应用程序的主要逻辑和界面。
• MediaResources: 媒体资源文件，如视频、音频等。
• Scripts: 包含项目构建和配置的脚本文件。
• Shared: 共享代码和资源文件，可能在多个模块中使用。
• bamboo-specs: Bamboo CI/CD 配置文件。
• fastlane: 自动化构建和发布工具的配置文件。
• .gitattributes: Git 属性配置文件。
• .gitignore: Git 忽略文件配置。
• twosky.json: 多语言翻译配置文件。
• CHANGELOG.md: 项目变更日志。
• Gemfile: Ruby 依赖管理文件。
• Gemfile.lock: Ruby 依赖锁定文件。
• LICENSE: 项目许可证文件。
• README.md: 项目说明文档。
• build.sh: 构建脚本。
• configure.sh: 配置脚本。

2. 项目启动文件介绍

启动文件

• ElectronMainApp/main.js: Electron 应用程序的主入口文件，负责启动和管理应用程序的主进程。
• AdGuard.xcworkspace: Xcode 工作区文件，双击此文件可以启动 Xcode 并加载项目。

启动步骤

1. 启动 Xcode: 双击 AdGuard.xcworkspace 文件，启动 Xcode。
2. 运行项目: 在 Xcode 中选择目标设备或模拟器，点击运行按钮（或按 Cmd + R）启动应用程序。

3. 项目配置文件介绍

配置文件

• Gemfile: 定义了项目所需的 Ruby 依赖包。
• twosky.json: 配置多语言翻译工具 Twosky 的参数。
• .gitattributes: 配置 Git 属性，如文件的换行符处理等。
• .gitignore: 定义了 Git 忽略的文件和目录。
• build.sh: 构建脚本，用于编译和打包项目。
• configure.sh: 配置脚本，用于设置项目环境。

配置步骤

1. 安装 Ruby 依赖: 在项目根目录下运行 bundle install 安装 Gemfile 中定义的依赖。
2. 配置多语言: 根据 twosky.json 文件配置多语言翻译工具。
3. 设置 Git 属性: 根据 .gitattributes 文件配置 Git 属性。
4. 忽略文件: 根据 .gitignore 文件配置 Git 忽略的文件和目录。
5. 构建项目: 运行 ./build.sh 脚本进行项目构建。
6. 配置环境: 运行 ./configure.sh 脚本设置项目环境。

通过以上步骤，您可以顺利启动和配置 AdGuard for Safari 项目。

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