Delta模拟器实验性功能开发指南

幸桔伶

于 2025-06-08 09:02:53 发布

阅读量286

点赞数 3

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_01099/article/details/148505653

Delta模拟器实验性功能开发指南

Delta Delta is an all-in-one classic video game emulator for non-jailbroken iOS devices. 项目地址: https://gitcode.com/gh_mirrors/delt/Delta

实验性功能概述

Delta模拟器采用了一套完善的实验性功能管理机制，允许第三方开发者为模拟器贡献新功能，同时确保主程序的稳定性。这些功能在测试阶段被称为"实验性功能"，经过充分测试后可能会被正式纳入主程序。

实验性功能设计原则

隔离性原则

实验性功能应当完全独立于核心模拟逻辑，建议使用Swift扩展(extension)方式实现，例如GameViewController+ExperimentalFastForward.swift这样的命名方式。当功能被禁用时，它不应该对应用程序的其他部分产生任何可察觉的影响。

核心修改规范

如果必须修改DeltaCore或特定模拟核心，需要特别注意：

公共API的命名和结构应与现有约定保持一致
核心修改类功能的审核标准会更为严格

实现实验性功能

基础功能实现步骤

在ExperimentalFeatures.swift中添加新属性
使用@Feature属性包装器标注
在初始化器中指定功能名称和描述(可选)

示例代码：

struct ExperimentalFeatures {
    @Feature(name: "显示状态栏", description: "在游戏过程中显示状态栏")
    var showStatusBar
}

运行时检查

通过ExperimentalFeatures.shared.[feature].isEnabled检查功能是否启用，这是功能实现必须遵守的规则。

高级功能选项

选项类型设计

实验性功能可以包含多种配置选项，这些选项需要：

创建独立的结构体[功能名]Options
使用@Option属性包装器声明选项
非可选类型必须提供默认值

选项持久化

选项值变更时会自动保存到UserDefaults中，键名由功能名和选项名组合而成。

用户可见选项

选项可见性控制

默认情况下选项是隐藏的，通过以下方式可使其对用户可见：

在@Option初始化器中提供名称参数
可选添加描述文本
类型必须遵循LocalizedOptionValue协议

选项类型实现

布尔型选项

最简单的选项类型，自动显示为开关控件：

@Option(name: "保存到文件", description: "将截图保存到文件应用")
var saveToFiles: Bool = true

选择器型选项

适用于有限预设值的情况：

enum FastForwardSpeed: Double, CaseIterable {
    case x2 = 2, x3 = 3, x4 = 4
}

@Option(name: "快速前进速度", values: FastForwardSpeed.allCases)
var speed: FastForwardSpeed?

自定义型选项

提供最大灵活性，可自定义SwiftUI视图：

@Option(name: "最大速度", detailView: {
    TextField("", value: $0, formatter: NumberFormatter())
        .keyboardType(.numberPad)
})
var maxSpeed: Int?

功能变更通知

Delta会在以下情况发送Settings.didChangeNotification通知：

功能启用/禁用状态变化
选项值发生变化

通知中包含：

变更项的名称(SettingsUserInfoKey.name)
新值(SettingsUserInfoKey.value)

响应示例：

func settingsDidChange(_ notification: Notification) {
    guard let name = notification.userInfo?[SettingsUserInfoKey.name] else { return }
    
    switch name {
    case ExperimentalFeatures.shared.showStatusBar.settingsKey:
        setNeedsStatusBarAppearanceUpdate()
    default: break
    }
}