Skip to content

Play your own Switch games on iPhone/iPad — one-click macOS app, no terminal. | 把 Switch 游戏装进 iPhone:图形界面一键构建,不用命令行。Bring your own game.

Onboarding and dependency UX: five gaps from the owner's new-user test (issue #178)

LNPANDYc556980c129f
diff --git a/frontend/Sources/NSPortBuilder/Localization.swift b/frontend/Sources/NSPortBuilder/Localization.swift
index 7cf0220a..305e5536 100644
--- a/frontend/Sources/NSPortBuilder/Localization.swift
+++ b/frontend/Sources/NSPortBuilder/Localization.swift
@@ -90,7 +90,7 @@ enum L10n {
"onboarding.xcode.checking": ("\u{6b63}\u{5728}\u{68c0}\u{67e5} Xcode\u{2026}", "Checking Xcode\u{2026}"),
"onboarding.xcode.checkingNote": ("\u{6b63}\u{5728}\u{67e5}\u{627e}\u{6e38}\u{620f}\u{6240}\u{9700}\u{7684}\u{5de5}\u{5177}\u{3002}", "Looking for the tools your games need."),
"onboarding.xcode.missing": ("\u{5148}\u{83b7}\u{53d6} Xcode\u{3002}", "First, get Xcode."),
- "onboarding.xcode.missingNote": ("\u{4ece} App Store \u{4e0b}\u{8f7d} Xcode\u{3002}\u{8fd9}\u{662f}\u{8bbe}\u{7f6e}\u{4e2d}\u{6700}\u{5927}\u{7684}\u{4e0b}\u{8f7d}\u{9879}\u{76ee}\u{3002}", "Download Xcode from the App Store. This is the largest part of setup."),
+ "onboarding.xcode.missingNote": ("从 App Store 下载 Xcode(免费)——这是设置中最大的下载项。下载完成后我们会自动继续。首次打开 Xcode 会提示安装 iOS SDK——让它装完。", "Download Xcode from the App Store (free) — this is the largest part of setup. We will continue automatically when it is installed. The first launch of Xcode will prompt to install the iOS SDK — let it finish."),
"onboarding.xcode.downloading": ("\u{6b63}\u{5728}\u{7b49}\u{5f85} Xcode\u{2026}", "Waiting for Xcode\u{2026}"),
"onboarding.xcode.downloadNote": ("\u{8bf7}\u{8ba9} App Store \u{7ee7}\u{7eed}\u{4e0b}\u{8f7d}\u{3002}Xcode \u{5b89}\u{88c5}\u{5b8c}\u{6210}\u{540e}\u{ff0c}\u{6211}\u{4eec}\u{4f1a}\u{81ea}\u{52a8}\u{7ee7}\u{7eed}\u{3002}", "Leave the App Store download running. We will continue automatically when Xcode is installed."),
"onboarding.xcode.needsSetup": ("\u{5b8c}\u{6210} Xcode \u{7684}\u{6700}\u{540e}\u{4e00}\u{6b65}\u{3002}", "One last step for Xcode."),
@@ -104,6 +104,7 @@ enum L10n {
"onboarding.setup.ios": ("iOS \u{5e73}\u{53f0}", "iOS platform"),
"onboarding.background.title": ("\u{6b63}\u{5728}\u{540e}\u{53f0}\u{51c6}\u{5907}", "Preparing in the background"),
"onboarding.background.note": ("\u{8fd9}\u{4e9b}\u{5de5}\u{5177}\u{5c06}\u{5728}\u{8bbe}\u{7f6e} Xcode \u{65f6}\u{51c6}\u{5907}\u{5c31}\u{7eea}\u{3002}", "These tools get ready while you set up Xcode."),
+ "onboarding.background.installing": ("正在安装…", "Installing…"),
"onboarding.background.python": ("Python", "Python"),
"onboarding.background.dotnet": (".NET", ".NET"),
"onboarding.background.tools": ("\u{6784}\u{5efa}\u{5de5}\u{5177}", "Build tools"),
@@ -155,8 +156,8 @@ enum L10n {
"dev.noDevices": ("\u{6ca1}\u{6709}\u{4e0e}\u{8fd9}\u{53f0} Mac \u{914d}\u{5bf9}\u{7684} iPhone \u{6216} iPad\u{ff08}\u{9700}\u{8981} Xcode\u{ff09}\u{3002}", "No iPhone or iPad paired with this Mac (needs Xcode)."),
"dev.refresh": ("\u{5237}\u{65b0}", "Refresh"),
"dev.team": ("\u{7b7e}\u{540d}\u{56e2}\u{961f}", "Signing team"),
- "dev.noTeam": ("Xcode 里没有 Apple ID,也没有开发证书。请在 Xcode → 设置 → 账户中登录。",
- "No Apple ID in Xcode and no development certificate. Sign in to Xcode → Settings → Accounts."),
+ "dev.noTeam": ("Xcode 里没有 Apple ID,也没有开发证书。打开 Xcode → Settings → Apple Accounts(Xcode 菜单没有中文),登录 Apple ID 后选 Personal Team → Download Manual Profiles。证书不会立刻出现——等 30 秒左右再按「重新检测」。如果等了还没有,在 Manage Certificates 里点 + 手动创建一个 Apple Development 证书。",
+ "No Apple ID in Xcode and no development certificate. Open Xcode → Settings → Apple Accounts (Xcode menus are English-only), sign in with your Apple ID, select Personal Team → Download Manual Profiles. The certificate does not appear immediately — wait ~30 seconds and press Check again. If it still does not appear, click + in Manage Certificates to create an Apple Development certificate manually."),
"dev.teamNoCert": ("这个团队还没有开发证书:第一次安装时 Xcode 会自动创建(Mac 需要联网)。",
"This team has no development certificate yet: Xcode creates it at the first install (the Mac needs to be online)."),
"dev.personalTeam": ("个人团队", "Personal team"),
@@ -573,7 +574,7 @@ enum L10n {
"dep.xcode.notSelected": ("Xcode 已安装,但 xcode-select 还指向 CommandLineTools——点「修复」会切换到 Xcode 并完成首次启动(会要管理员密码)。",
"Xcode is installed, but xcode-select still points at CommandLineTools — Fix switches to Xcode and finishes its first launch (asks for your admin password)."),
"dep.xcode.fix": ("修复", "Fix"),
- "dep.xcode.hint": ("App Store 安装(Beta 版也行,用 xcode-select 指向它),约 12 GB",
+ "dep.xcode.hint": ("App Store 安装(Beta 版也行,用 xcode-select 指向它),约 12 GB。首次打开会提示装 iOS SDK——让它装完。不需要 iOS Simulator(约 8 GB),Xcode 如果自动下载请取消。",
"from the App Store (a beta works too — point xcode-select at it), about 12 GB"),
"dep.xcode.noSDK": ("Xcode 已装,但 iOS SDK 未下载(Xcode 15 起 iOS 平台是单独下载的)",
"Xcode is installed but the iOS SDK is not downloaded (a separate download since Xcode 15)"),
diff --git a/frontend/Tests/NSPortBuilderTests/XcodeTeamsTests.swift b/frontend/Tests/NSPortBuilderTests/XcodeTeamsTests.swift
index 6a8c2eef..5a5384ca 100644
--- a/frontend/Tests/NSPortBuilderTests/XcodeTeamsTests.swift
+++ b/frontend/Tests/NSPortBuilderTests/XcodeTeamsTests.swift
@@ -98,8 +98,10 @@ final class XcodeTeamsTests: XCTestCase {
XCTAssertNotEqual(m.t("dev.personalTeam"), "dev.personalTeam")
}
let m = BuildModel(); m.lang = .en
- XCTAssertTrue(m.t("dev.noTeam").contains("Settings → Accounts"))
+ XCTAssertTrue(m.t("dev.noTeam").contains("Settings → Apple Accounts"))
XCTAssertTrue(m.t("dev.noTeam").contains("no development certificate"))
+ XCTAssertTrue(m.t("dev.noTeam").contains("Download Manual Profiles"))
+ XCTAssertFalse(m.t("dev.noTeam").contains("(null)"))
XCTAssertTrue(m.t("dev.teamNoCert").contains("first install"))
}
}