Submariner开源项目安装与配置指南

Submariner开源项目安装与配置指南

1. 项目基础介绍

Submariner是一个用于Mac操作系统的Subsonic客户端。它旨在提供一个用户友好的界面来访问Subsonic音乐库，允许用户播放、管理和发现音乐。Submariner最初由Rafaël Warnault开发，后来Calvin Buckley接手维护，修复了兼容性问题，并添加了新功能。该项目采用BSD-3-Clause许可证开源。

主要编程语言：Swift（用于macOS应用开发）

2. 关键技术和框架

• Swift：作为主要的编程语言，用于构建用户界面和业务逻辑。
• Core Data：用于在本地存储和管理数据。
• ** networking libraries**：用于与Subsonic服务器进行网络通信。
• UI Kit：Mac应用的用户界面框架。

3. 安装和配置准备工作

在开始安装之前，请确保您满足以下要求：

• 操作系统：macOS 12或更高版本。
• Subsonic服务器：API版本1.16.1或更高。
• 开发环境：Xcode（推荐版本与项目兼容）。

详细安装步骤

1. 克隆项目

   打开终端（Terminal），使用以下命令克隆项目：

   git clone --recursive https://github.com/SubmarinerApp/Submariner.git
   

   如果克隆过程中遇到问题，可以尝试：

   git submodule update --init --recursive
   

2. 设置开发团队ID

   在项目目录中创建一个名为Submariner/DEVELOPMENT_TEAM.xcconfig的文件，并添加以下内容，将AAAAAAAAA替换为您从钥匙串中获取的开发者ID：

   DEVELOPMENT_TEAM = AAAAAAAAAA
   

   若不确定如何获取开发者ID，可以在终端运行：

   security find-identity -v -p codesigning
   

3. 配置Git钩子（可选）

   若要避免提交开发ID，可以在项目根目录下运行以下命令来设置Git钩子：

   git config core.hooksPath .githooks
   

4. 构建项目

   使用Xcode打开项目，或者使用xcbuild工具构建项目。确保选择正确的目标设备和配置。

   • Xcode：打开Submariner.xcodeproj文件，然后点击Xcode的构建按钮。
   • xcbuild：在终端运行xcbuild -project Submariner.xcodeproj -scheme Submariner -configuration Debug BUILD_ACTIVE_ARCH_ONLY=NO。

按照上述步骤，您可以成功安装和配置Submariner项目，并进行进一步的开发或使用。