feat: Filesに出る.knitの種類名を日本語にする

[K0mork]

変更内容

iOS版で、Filesの「情報を見る」の「種類」や共有シートに出る.knitの種類名を日本語にした（これまでは英語のKnitting Editor backup）。

• ios/App/Info.plist: UTTypeDescriptionとCFBundleTypeNameを棒針編み図バックアップにした。InfoPlist.stringsでは、この値がそのまま訳のキーになる。
• ios/App/InfoPlist.xcstrings（新規）: 日本語棒針編み図バックアップと英語Knitting Chart Backupを持つ文字列カタログ。ビルドすると、アプリにja.lproj・en.lprojのInfoPlist.stringsが入る。
• ios/knittingEditor.xcodeproj: xcodegen generateで作り直した。差分は、カタログ、テストファイル、knownRegionsのenだけである。
• 種類の識別子com.k0mork.knitting-editor.knitと拡張子knitは変えていない。
• テスト:
  • ios/Tests/KnittingEditorAppTests/KnittingEditorUTTypeTests.swiftを足した。識別子が変わっていないこと、Info.plistの値と訳のキーが一致すること、日本語と英語の訳を確かめる。訳は各言語のInfoPlist.stringsをファイルとして直接読んで比べるので、Simulatorの表示言語に依存せずCIでも英訳を確かめられる。システムが返すlocalizedDescriptionがアプリの表示言語の訳になることも確かめる（実行したSimulatorの表示言語の経路だけで、その言語をログに出す）。
  • ios/scripts/check-app-bundle.shに、ビルドしたアプリの識別子、種類名、ja.lproj・en.lprojの訳の検査を足した。CIのios（Debug）とrelease_archive（Release）で実行される。
• 開発ログ: docs/dev-log/2026-10-06-japanese-knit-type-name.md

決めたこと

• 日本語名: Issueの例どおり棒針編み図バックアップにした。アプリ名「棒針編み図」と、編集画面の「バックアップ」の見出しに合わせている。
• 英語名: Knitting Chart Backupにした。旧名のKnitting Editor backupはアプリ名を英訳したものである。英語版（[P2] 複数言語 #34）でも、ファイルの中身を表す名前のほうが分かりやすいと考えた。
• ファイル形式: InfoPlist.stringsではなく文字列カタログ（InfoPlist.xcstrings）にした。1ファイルで両言語を管理でき、XcodeGen 2.46.0（CIと同じ版）がリソースとして扱える。
• 英語を今から同梱する: 次の理由で、en.lprojも同梱した。
  • これまでアプリには.lprojが1つも無かった。Info.plistにCFBundleDevelopmentRegionも無いので、Foundationは日本語の端末でもアプリの言語をenと判定していた。macOSのFoundationでBundle.preferredLocalizationsを使って確かめた。
  • jaとenを両方持つと、日本語の端末はja、それ以外の端末は今までどおりenになる。日本語だけを持つと、英語の端末でもシステムの文言まで日本語に変わる。
• Quick Lookの拡張: 今回は作らず、Issueも作らなかった。プレビューを出すには、.knitを展開して盤面を描く処理を、拡張の中にもう1つ持つ必要がある。完全オフラインのまま保守する負担に比べて、得られるものが小さいと判断した。必要になったらpriority:P2・platform:iosで起票する。

実行した確認

手元のXcodeは27.0で、CIの26.6とは異なる。

• xcodegen generate --spec ios/project.ymlを実行した。
• xcodebuild build ... -destination 'generic/platform=iOS Simulator' CODE_SIGNING_ALLOWED=NOが成功した。アプリ内のja.lproj／en.lprojのInfoPlist.stringsに、それぞれの訳が入っていることを確かめた。
• そのアプリにios/scripts/check-app-bundle.shを実行して通った。わざと壊したコピーでは失敗することも確かめた。壊し方は、英訳の書き換え、ja.lprojの削除、Info.plistの種類名を英語へ戻す変更、識別子の書き換えの4通りである。
• iPad Pro 11-inch (M5)（iOS 27.0）のSimulatorで、KnittingEditorUTTypeTestsの4件が通った。このSimulatorの表示言語は日本語なので、localizedDescriptionは日本語の経路だけを確かめた。英語の表示は、下のFilesの確認（-AppleLanguages (en)）で確かめた。
• 同じSimulatorのFilesで確かめた。.knitを「このiPad内」に置き、コミットしない一時的なXCUITestで操作した。
  • 日本語（-AppleLanguages (ja)）では、「情報を見る」の「種類」が棒針編み図バックアップだった。共有シートの見出しは棒針編み図バックアップ · 243 バイトだった。
  • 英語（-AppleLanguages (en)）では、「種類」がKnitting Chart Backupだった。
  • 変更前のビルドでは、英語の言語設定でKnitting Editor backupと出た。
  • スクリーンショットは手元に保存した（コミットしない）。ghではPRに画像を添付できないため、添付は利用者に任せた。
• Simulatorのテスト一式（iPhone・iPad）、アプリ更新テスト、Release Archive、iOS WebはPRのCIに任せた。Webのソースとpackages/は変えていないので、Webの検査一式は手元で実行していない。

レビュー後の修正

• check-app-bundle.sh: 「値に.を含むキーはplutil -extractで引けない」というコメントは事実と合っていなかった。訳のキーには.が無く、plutil -extractでバイナリの.stringsから読めることを確かめたので、jqをやめてplutil -extractで読むようにし、コメントを直した。ビルドしたアプリで通り、わざと壊したコピー6通り（英訳の書き換え、ja.lprojの訳のキーの削除、ja.lproj／en.lprojの削除、Info.plistの種類名、識別子）ではそれぞれ失敗した。
• testKnitTypeNameIsTranslatedIntoJapaneseAndEnglish: localizedString(forKey:)はキーが無いとキーそのものを返すため、日本語の訳が欠けても通ってしまっていた。Bundle.main.path(forResource: "InfoPlist", ofType: "strings", inDirectory: nil, forLocalization:)で各言語のファイルを直接読んで比べるようにした。
• testSystemDescribesKnitTypeInTheAppLanguage: 表示言語をログに出すようにした。CIのログにはapp language = enと出た。CIのSimulatorは英語なので、システムが英訳を返す経路はCIで確かめられた（iPhone・iPadの両方）。
• 手元ではxcodebuild build-for-testing（Xcode 27.0）とcheck-app-bundle.shを実行した。Simulatorでのテストは手元の負荷のためPRのCIに任せた。

できなかった確認

• AirDropの受信画面: SimulatorではAirDropを使えないため、確かめていない。実機（TestFlight）で確かめる必要がある。
• スクリーンショットのPRへの添付: 上の理由で行っていない。
• アプリ内のシステムの文言: 日本語の端末では、ファイル選択のボタンなども日本語で出るはずである。ただし、アプリ内では確かめていない。

そのため、このPRでは#82を閉じず、残りをIssueにコメントする。

懸念

• App Storeの「言語」には、日本語に加えて英語が出る見込みである。アプリの画面は日本語だけなので、気になる場合は#34までenを外すかどうかを判断してほしい。外すと、英語の端末ではアプリ内のシステムの文言が日本語になる。

Refs #82

🤖 Generated with Claude Code

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[K0mork]

レビュー結果

CI

CI and deploy Pagesの必須ジョブはすべて成功し、ci-gateも通った。web・deploy・smokeはiOSだけの変更なのでスキップされた。CodeQLも成功した。

• ios (iPhone 17)・ios (iPad (A16)): 成功。KnittingEditorUTTypeTestsの4件が両方の端末で通り、Verify generated app bundle（Debugのアプリへのcheck-app-bundle.sh）も成功した。
• release_archive: 成功。check-release-assets.sh経由で、Releaseのアーカイブにも新しい検査が通った。
• app_update (iPhone 17)・app_update (iPad (A16))・ios_web・app_store_docs・changes: 成功。

CIのXcode 26.6でも、文字列カタログからja.lprojとen.lprojのInfoPlist.stringsが作られることを確かめられた。

確かめたこと（問題なし）

• 識別子com.k0mork.knitting-editor.knitと拡張子knitは変わっていない。KnittingEditorUTType.swiftのexportedAsとも一致し、テストとバンドル検査の両方で固定されている。
• project.pbxprojは、XcodeGen 2.46.0でこのブランチのproject.ymlから生成し直したものと一致した。
• 開発ログはdocs/dev-log/README.mdの書式どおりで、PR本文の確認内容と食い違いはない。
• 差分・PR本文・コミットメッセージに機密情報は見当たらない。Refs #82がある。

指摘

1. （低）check-app-bundle.shのコメントが実際と合っていない。 「値に.を含むキーはplutil -extractで引けない」とあるが、棒針編み図バックアップには.が入らず、plutil -extract '棒針編み図バックアップ' rawでバイナリの.stringsからも値を読めた。将来.を含むキーに備えてjqで読むのなら、コメントもその理由に直すとよい。
2. （低）英語の経路がCIで実際に通ったかは、ログからは分からない。 testSystemDescribesKnitTypeInTheAppLanguageはpreferredLocalizations.firstから期待値を選ぶので、jaとenのどちらでも通る。CIのSimulatorの言語はログに出ていないので、PR本文と開発ログの「英語の経路はCIで確かめる」は、まだ裏づけられていない。言語をログに出すか、enでの確認を別の形で残すとよい。

利用者の判断が必要な点

• en.lprojを入れることの影響。 App Storeの「言語」に英語が出る。また、日本語の端末ではアプリの言語がenからjaに変わるので、ファイル選択の画面やWKWebViewの編集メニューなど、システムの文言も日本語になる見込みである（改善と考えられるが、アプリ内では確かめていない）。Webのコードにはnavigator.languageやIntlを使う処理は無い。#34までenを外すかどうかは判断が要る。
• Info.plistにCFBundleDevelopmentRegionが無いので、日本語でも英語でもない端末ではenになる。後でこのキーを$(DEVELOPMENT_LANGUAGE)（ja）で足すと、そうした端末の挙動が変わる点に注意する。
• PRのタイトルはfix:だが、ラベルはenhancementである。リリースノートでどちらの区分に入れるかを決めてほしい。
• #82の完了条件のうち、AirDropの受信画面は実機でしか確かめられない。#82にneeds-deviceラベルを付けるとよい。FilesのスクリーンショットもまだPRに付いていない。

修正が必須の問題は見つからなかった。マージの判断は利用者に任せる。

[K0mork]

レビューの指摘（低）を直した。

• check-app-bundle.sh: 訳のキー棒針編み図バックアップは.を含まず、plutil -extractでバイナリの.stringsから読めることを確かめた（.を含むキーはキーパスの区切りになるため引けない）。jqをやめてplutil -extractで読むようにし、コメントを事実に合わせた。ビルドしたアプリで通り、わざと壊したコピー6通りではそれぞれ失敗した。
• testKnitTypeNameIsTranslatedIntoJapaneseAndEnglish: Bundle.main.path(forResource: "InfoPlist", ofType: "strings", inDirectory: nil, forLocalization:)でja・enのファイルを直接読んで比べるようにした。これまでのlocalizedString(forKey:)は、キーが無いとキーそのものを返すので、日本語の訳が欠けても通ってしまっていた。
• testSystemDescribesKnitTypeInTheAppLanguage: 表示言語をログに出すようにした。CIのログにはapp language = enと出た。システムが英訳を返す経路も、CIで確かめられた。
• PRタイトルをfeat:にして、ラベルenhancementに合わせた。開発ログとPR本文も直した。

CI（4893112）: ios (iPhone 17)・ios (iPad (A16))でKnittingEditorUTTypeTestsの4件が通り、Verify generated app bundleも成功した。release_archive（Releaseのcheck-app-bundle.sh）、app_updateの2件、ios_web、app_store_docs、CodeQL、ci-gateも成功した。web・deploy・smokeはiOSだけの変更なのでスキップされた。マージの判断は任せる。

[K0mork]

main での確認

main の a906905（このPRのマージ）の CI and deploy Pages（run 37561464640）が成功しました。

• iOS のジョブ（ios（iPhone 17・iPad (A16)）、app_update（両端末）、release_archive）はすべて成功し、ios_web と app_store_docs も成功しました。
• ci-gate: 成功
• web・deploy・smoke はスキップされました。このPRは iOS だけの変更なので、Pages の配信には影響しません。本番には、直前の e1a2001 の run（37560031792）で配信された版が出ています。

AirDrop の受信画面と Files での種類名の表示は、実機（TestFlight）での確認がまだ残っています。