Onboarding and dependency UX: five gaps from the owner's new-user test

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)"),

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"))
     }
 }