Harmony 项目启动与配置教程

Harmony 项目启动与配置教程

Harmony Music App | SwiftUI + TCA + SharingGRDB 项目地址: https://gitcode.com/gh_mirrors/harmony30/Harmony

1. 项目的目录结构及介绍

Harmony 项目是一个基于 SwiftUI 和 TCA (Composable Architecture) 的音乐应用，以下是项目的目录结构及其简要介绍：

Harmony/
├── Harmony.xcodeproj          # Xcode 项目文件
├── HarmonyTests/              # 单元测试文件
├── HarmonyUITests/            # UI 测试文件
├── .gitignore                 # Git 忽略文件
├── LICENSE                    # 项目许可证文件
├── LaunchScreen.storyboard    # 启动屏幕故事板
├── README.md                  # 项目说明文件
└── harmonyBanner.png          # 项目横幅图片

• Harmony.xcodeproj: Xcode 项目文件，用于在 Xcode 中打开和编辑项目。
• HarmonyTests/: 包含项目的单元测试代码。
• HarmonyUITests/: 包含项目的 UI 测试代码。
• .gitignore: 指定 Git 忽略的文件和目录。
• LICENSE: 项目使用的许可证信息，本项目采用 MIT 许可证。
• LaunchScreen.storyboard: 应用的启动屏幕界面设计。
• README.md: 项目说明文件，包含项目信息、功能和许可证等信息。
• harmonyBanner.png: 项目宣传横幅图片。

2. 项目的启动文件介绍

项目的启动文件主要包含 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 {
        // 初始化窗口和根视图控制器
        window = UIWindow(frame: UIScreen.main.bounds)
        window?.rootViewController = MainViewController()
        window?.makeKeyAndVisible()
        return true
    }
}

• SceneDelegate.swift: 场景代理，用于管理应用的场景和视图控制器。

import UIKit

class SceneDelegate: UIResponder, UIWindowSceneDelegate {

    var window: UIWindow?

    func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options options: UIScene.ConnectionOptions) {
        // 配置窗口和根视图控制器
        guard let windowScene = scene as? UIWindowScene else { return }
        window = UIWindow(windowScene: windowScene)
        window?.rootViewController = MainViewController()
        window?.makeKeyAndVisible()
    }
}

3. 项目的配置文件介绍

项目的配置文件主要包括 Info.plist，该文件用于存储应用的配置信息和元数据。

• Info.plist: 应用配置文件，包含应用的名称、版本、图标等信息。

以下是一些常见的配置项：

<key>CFBundleName</key>             <string>Harmony</string>         <!-- 应用名称 -->
<key>CFBundleVersion</key>          <string>1.0.0</string>            <!-- 应用版本 -->
<key>CFBundleShortVersionString</key> <string>1.0</string>             <!-- 应用短版本 -->
<key>UIApplicationSupportsIndirectInputEvents</key> <true/>             <!-- 支持多点触控 -->

通过以上介绍，您可以快速了解 Harmony 项目的结构、启动文件和配置文件。接下来，您可以开始自己的开发工作，祝您开发愉快！

Harmony Music App | SwiftUI + TCA + SharingGRDB 项目地址: https://gitcode.com/gh_mirrors/harmony30/Harmony