为什么值得关注

它解决了在没有模拟器的情况下在 iOS 上原生游玩《时之笛》的长期需求，并提供了官方品质的触控操作和可复现构建。

适合谁使用

拥有合法《时之笛》ROM 的 iOS 玩家
对将 PC 游戏移植到 iOS 感兴趣的开发者
寻求现代移动设备上 N64 游戏体验的爱好者
自制软件和模拟器社区成员

典型使用场景

在 iPad 上使用触控或手柄游玩《时之笛》
测试和开发基于 Ship of Harkinian 引擎的 iOS 游戏移植
了解如何将 C++ 游戏引擎与 Metal 和 iOS 框架集成
评估现代 iOS 硬件上 Metal 渲染对 N64 游戏的表现

项目优势

原生 Metal 渲染在支持的设备上提供流畅性能
专为横屏 iPad 设计的完整触控布局
可复现的构建脚本保证了透明性且不捆绑游戏数据
支持多种输入方式：触控、键盘、鼠标和 iOS 游戏手柄

使用前须知

未上架 App Store 或 TestFlight，需要通过 AltStore 手动侧载
触控摇杆仅为八方向，缺乏真正的模拟精度
音频和控制器重新连接测试不完整，部分硬件组合可能存在问题
项目缺乏顶层许可证，可能限制再分发和贡献

README 快速开始

HarkinianPad

Ocarina of Time via Ship of Harkinian, rebuilt for iPhone and iPad. Native Metal rendering, touch controls, Files-based setup, and support for keyboards, pointing devices, and iOS game controllers.

HarkinianPad packages the full Ship of Harkinian source port as a native iOS/iPadOS app. It renders through Metal, imports a user-provided supported Ocarina of Time ROM through Files, and includes a landscape touch controller that can be hidden whenever a physical controller is connected.

This repository contains the mobile integration and reproducible build scripts. It does not contain Ocarina of Time, a ROM, or a playable ROM-derived archive.

Install status

Option	Status	What to do
Developer-preview `.ipa`	Available now	Download preview 0.1.0, then re-sign it with your Apple ID by following the AltStore Classic guide.
Local iPad build	Available now	Build and sign with your Apple development team using the instructions below.
Simulator	Available now	Best for development and UI testing; it is not a substitute for physical-device testing.
App Store / TestFlight	Not announced	No listing or public TestFlight currently exists.

The current development build has been signed, installed, and played on a 12.9-inch iPad Pro (6th generation) running iPadOS 26.5.2. Files import, on-device archive loading, touch gameplay, save loading, the settings menu, and in-place app updates have all been exercised on that hardware.

Audio has been heard during repeated physical-iPad playtests. Headphone, Bluetooth, and interruption recovery still need a complete device matrix. The iOS controller path is present, but physical controller reconnect, rumble, and motion testing is also incomplete.

Get started

You need:

a Mac with Xcode and its command-line tools;
Homebrew;
an Apple ID configured in Xcode for physical-device signing; and
your own legally acquired, supported Ocarina of Time ROM.

Install the build dependencies:

brew install cmake ninja pkgconf sdl2 glew nlohmann-json libpng libzip \
  tinyxml2 libogg libvorbis opus opu

项目描述

Ocarina of Time native on iOS and iPadOS via Ship of Harkinian with Metal rendering, touch controls, controller support, and ROM-free reproducible builds.

harkinianpad