Play your own Switch games on iPhone/iPad — one-click macOS app, no terminal. | 把 Switch 游戏装进 iPhone:图形界面一键构建,不用命令行。Bring your own game.
Swift apple-siliconcustom-formathomebrewiosipaipadipadosiphonemetalnative-portnintendo-switchnxnativeromfsswitch-games
import XCTest
/// Screens for visual review. With TEST_RUNNER_SHOT_DIR set, each capture is also written there as a PNG.
@MainActor final class ShellCaptureTests: XCTestCase {
private let app = XCUIApplication()
private var directory: String? { ProcessInfo.processInfo.environment["SHOT_DIR"] }
private var prefix: String { ProcessInfo.processInfo.environment["SHOT_PREFIX"] ?? (UIDevice.current.userInterfaceIdiom == .pad ? "ipad" : "phone") }
private let screens = ["library", "settings", "needs-data", "needs-update", "broken", "empty", "controllers", "controllers-empty", "focus"]
private func shot(_ name: String) {
let screenshot = XCUIScreen.main.screenshot()
let attachment = XCTAttachment(screenshot: screenshot)
attachment.name = name
attachment.lifetime = .keepAlways
add(attachment)
if let directory {
try? screenshot.pngRepresentation.write(to: URL(fileURLWithPath: directory).appendingPathComponent("\(prefix)-\(name).png"))
}
}
private func launch(_ arguments: [String]) {
app.terminate()
// TEST_RUNNER_SHOT_REAL_ART=1: the demo reads real game art from the host (see RealArt.swift).
let language = ProcessInfo.processInfo.environment["SHOT_LANG"] ?? "" // TEST_RUNNER_SHOT_LANG=zh-Hans
app.launchArguments = arguments + (language.isEmpty ? [] : ["-AppleLanguages", "(\(language))"]) + ((ProcessInfo.processInfo.environment["SHOT_REAL_ART"] ?? "").isEmpty ? [] : ["--real-art"])
app.launch()
_ = app.buttons["controllers.open"].firstMatch.waitForExistence(timeout: 10)
|| app.buttons["controllers.close"].waitForExistence(timeout: 2)
sleep(1)
}
/// The settings with the language row collapsed, its open list, and the settings scrolled under the top bar.
func testCaptureChoiceAndTopBar() {
XCUIDevice.shared.orientation = .landscapeLeft
launch(["--screen", "settings", "--input-test"])
func appShot(_ name: String) { shot(name) }
for _ in 0..<5 { app.buttons["qa.input.down"].tap() }
sleep(1)
appShot("settings-language-collapsed")
app.buttons["qa.input.activate"].tap()
sleep(1)
appShot("settings-language-list")
app.buttons["qa.input.back"].tap()
sleep(1)
app.scrollViews.element(boundBy: app.scrollViews.count - 1).swipeUp()
sleep(1)
appShot("settings-scrolled-top-bar")
}
/// The shell's own settings page (the game-data and cloud-saves folders), opened from the library.
func testShellSettings() {
launch(["--screen", "library"])
let open = app.buttons["shellSettings.open"].firstMatch
XCTAssertTrue(open.waitForExistence(timeout: 5))
open.tap()
XCTAssertTrue(app.buttons["shellSettings.data"].waitForExistence(timeout: 5))
sleep(1)
shot("shell-settings")
}
/// The mapping rows in Controllers and in a game's settings, the card each opens, a button's options and the test.
func testCapturePadMapping() {
XCUIDevice.shared.orientation = .portrait
func reveal(_ element: XCUIElement) {
XCTAssertTrue(element.waitForExistence(timeout: 5))
for _ in 0..<5 where !element.isHittable { app.scrollViews.element(boundBy: app.scrollViews.count - 1).swipeUp() }
XCTAssertTrue(element.isHittable)
}
launch(["--screen", "controllers"])
let open = app.descendants(matching: .any).matching(identifier: "padMapping.open").firstMatch
reveal(open)
shot("controllers-button-mapping")
open.tap()
XCTAssertTrue(app.descendants(matching: .any).matching(identifier: "padMapping.card").firstMatch.waitForExistence(timeout: 5))
sleep(1)
shot("controllers-button-mapping-card")
app.buttons["padMapping.row.A"].tap()
XCTAssertTrue(app.buttons["padMapping.option.B"].waitForExistence(timeout: 5))
sleep(1)
shot("controllers-button-mapping-options")
launch(["--screen", "controllers-test"])
XCTAssertTrue(app.descendants(matching: .any).matching(identifier: "buttonTest").firstMatch.waitForExistence(timeout: 5))
shot("controllers-button-test")
launch(["--host", "--screen", "settings", "--select", "0100000000010000"])
let game = app.descendants(matching: .any).matching(identifier: "padMapping.open").firstMatch
reveal(game)
shot("game-controller-mapping")
game.tap()
XCTAssertTrue(app.buttons["padMapping.row.pad.swapAB"].waitForExistence(timeout: 5))
sleep(1)
shot("game-controller-mapping-card")
}
func testCaptureMatrix() {
for orientation in [UIDeviceOrientation.portrait, .landscapeLeft] {
XCUIDevice.shared.orientation = orientation
let suffix = orientation == .portrait ? "portrait" : "landscape"
for screen in screens {
launch(["--screen", screen])
shot("\(screen)-\(suffix)")
if screen == "settings" {
for index in 1...2 {
app.scrollViews.element(boundBy: app.scrollViews.count - 1).swipeUp()
shot("settings-scroll\(index)-\(suffix)")
}
}
}
launch(["--screen", "library", "--games", "3", "--select", "tide"])
shot("three-games-\(suffix)")
launch(["--screen", "library", "--select", "drift"])
shot("library-drift-\(suffix)")
for (screen, name) in [("broken", "help-broken"), ("needs-update", "help-update")] {
launch(["--screen", screen])
app.buttons.matching(identifier: "state.action").allElementsBoundByIndex.first { $0.isHittable }?.tap()
sleep(1)
shot("\(name)-\(suffix)")
}
}
XCUIDevice.shared.orientation = .portrait
}
/// Run with the Simulator's text size at its largest (xcrun simctl ui <id> content_size accessibility-extra-extra-extra-large).
func testCaptureLargeText() {
for orientation in [UIDeviceOrientation.portrait, .landscapeLeft] {
XCUIDevice.shared.orientation = orientation
let suffix = orientation == .portrait ? "portrait" : "landscape"
for screen in ["library", "settings", "broken", "controllers"] {
launch(["--screen", screen])
shot("large-\(screen)-\(suffix)")
}
}
XCUIDevice.shared.orientation = .portrait
}
/// Every sample game's settings header: banners, square icons and the drawn placeholder.
func testCaptureSettingsHeaders() {
for orientation in [UIDeviceOrientation.landscapeLeft, .portrait] {
XCUIDevice.shared.orientation = orientation
let suffix = orientation == .portrait ? "portrait" : "landscape"
for id in ["orbit", "tide", "paper", "moon", "wild", "drift", "amber"] {
launch(["--screen", "settings", "--select", id])
shot("header-\(id)-\(suffix)")
}
launch(["--screen", "library", "--select", "drift"])
shot("library-short-title-\(suffix)")
launch(["--screen", "library", "--select", "paper"])
shot("library-long-title-\(suffix)")
}
XCUIDevice.shared.orientation = .portrait
}
/// The fold stand-in: one running shell resized between a folded and an unfolded screen.
func testCaptureFold() throws {
try XCTSkipUnless(UIDevice.current.userInterfaceIdiom == .pad, "The fold stand-in needs an iPad canvas")
for orientation in [UIDeviceOrientation.portrait, .landscapeLeft] {
XCUIDevice.shared.orientation = orientation
let suffix = orientation == .portrait ? "portrait" : "landscape"
for screen in ["library", "settings", "needs-data", "controllers"] {
launch(["--screen", screen, "--fold-test"])
shot("fold-\(screen)-folded-\(suffix)")
launch(["--screen", screen, "--fold-test", "--unfolded"])
shot("fold-\(screen)-unfolded-\(suffix)")
}
}
XCUIDevice.shared.orientation = .portrait
}
}