Ruddarr 开源项目教程

Ruddarr 开源项目教程

app A native iOS companion app for Radarr and Sonarr instances. 项目地址: https://gitcode.com/gh_mirrors/app154/app

1. 项目目录结构及介绍

Ruddarr 是一个为 Radarr 和 Sonarr 实例设计的优雅开源 iOS 应用，使用 SwiftUI 进行开发。以下是项目的目录结构及各部分的简要介绍：

Ruddarr/
├── .github/                # GitHub 工作流程和配置文件
├── .gitignore              # 指定 Git 忽略的文件和目录
├── .swiftlint.yml          # SwiftLint 配置文件
├── apps.apple.com.app/      # App Store 应用信息
├── ci_scripts/             # 持续集成脚本
├── Ruddarr.xcodeproj       # Xcode 项目文件
├── Ruddarr/                # Ruddarr 应用主体代码
│   ├── ...
├── NotificationService/    # 通知服务相关代码
│   ├── ...
├── Resources/              # 资源文件，如图标、图片等
├── Tests/                  # 单元测试和 UI 测试代码
│   ├── ...
└── ...

• .github/：包含 GitHub Actions 工作流程等配置。
• .gitignore：定义了在版本控制中应该忽略的文件和目录。
• .swiftlint.yml：SwiftLint 配置文件，用于代码风格检查。
• Ruddarr.xcodeproj：Xcode 项目文件，包含项目设置和构建配置。
• Ruddarr/：应用的主要代码目录，包含视图、模型、服务和其它相关代码。
• NotificationService/：通知服务代码，用于处理和发送通知。
• Resources/：包含应用所需的资源文件，如图片、图标等。
• Tests/：包含单元测试和 UI 测试代码，确保应用功能的正确性。

2. 项目的启动文件介绍

项目的启动文件是 Ruddarr.xcodeproj 中的 AppDelegate.swift 和 SceneDelegate.swift。

• AppDelegate.swift：管理应用的生命周期事件，如启动、关闭等。
• SceneDelegate.swift：管理应用场景的生命周期事件，如窗口的创建和销毁。

以下是 AppDelegate.swift 的基本结构：

import UIKit

@main
class AppDelegate: UIResponder, UIApplicationDelegate {

    var window: UIWindow?

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        // 配置代码
        return true
    }

    // 其他生命周期方法和配置
}

3. 项目的配置文件介绍

项目的配置文件包括 .swiftlint.yml 和 Info.plist。

• .swiftlint.yml：SwiftLint 配置文件，定义了代码风格和规则。例如：

disabled_rules:
  - force_unwrapping

• Info.plist：应用的信息和配置文件，包含应用的名称、版本、图标、隐私政策等。例如：

<key>CFBundleName</key>
<string>Ruddarr</string>
<key>CFBundleShortVersionString</key>
<string>1.5.0</string>
<key>NSAppTransportSecurity</key>
<dict>
    <key>NSExceptionDomains</key>
    <dict>
        ...
    </dict>
</dict>

这些配置文件确保应用按照预定的规则和设置运行。

app A native iOS companion app for Radarr and Sonarr instances. 项目地址: https://gitcode.com/gh_mirrors/app154/app