ゲームのインポート

Sakuraは、NScripterおよびONScripterゲーム（Umineko等のONScripter-RUゲームを含む）をデバイス上で直接インポートできます — コンピュータは不要です。ここではアプリ内インポートフローの全体を説明します。コンピュータのブラウザからインポートしたい場合は、代わりにWeb転送を参照してください。

• ライブラリからゲームをインポートカード（.zip, .7z, .rar, .tar, .gz, .bz2, .exe）をタップします。
• ライブラリが空の場合、ゲームが見つかりません画面にも独自のインポートボタンがあります。

これによりONScripterゲームのインポートポップアップが開き、対応ファイル形式が一覧表示され、ONScripterゲームのルートフォルダが自動検出される旨が説明されます。アーカイブを選択をタップするとシステムのファイルピッカーが開き、単一のアーカイブを選択できます。

• zip — ZIPFoundationで展開（パスワード保護がある場合はSSZipArchive）
• 7z — PLzmaSDKで展開
• rar — UnrarKitで展開
• tar / gz / bz2 / tgz — 内蔵のストリーミングtar/gzip/bzip2リーダー
• lzh / lha — ネイティブのLHA展開機
• exe（インストーラー・自己解凍形式のみ） — 次の順で検出：NSISインストーラー、Inno Setupインストーラー、その後先頭16MBを埋め込みの7z/zip自己解凍ペイロードとしてスキャン、最後にLHA-SFX

1. ステージング。 アーカイブがiCloud Driveにある場合、Sakuraはまずローカルにダウンロードします。その後、空き容量を確認します — コピーをステージングする必要がある場合はアーカイブサイズの約3倍、ファイルが既にローカルにある場合は2倍の空き容量が必要です。空き容量が足りない場合は**「ディスクの空き容量が不足しています」**：*「このアーカイブを展開するための空き容量が足りません。ストレージの空きを確保してから再試行してください。」*と表示されます。

2. パスワードの確認。 アーカイブが暗号化されている場合（zip/rar/7zのみ）、「このアーカイブはパスワードで保護されています。続行するにはパスワードを入力してください。」というプロンプトが表示されます。パスワードが間違っている場合は「パスワードが正しくありません。もう一度お試しください。」と表示されます。

3. 事前スキャン。 展開前に、Sakuraはエントリ名をスキャンして認識可能なNScripter/ONScripterのマーカーを探します — 0.txt、00.txt、nscript.dat、nscr_sec.dat、nscript.___、0.utf、00.utf、pscript.datなどのブートスクリプトや、Umineko等のONScripter-RUゲームで使われるパック済みスクリプト形式script.file、さらにarc*.nsa、*.ns2、*.sarのようなパック済みアーカイブです。tarなど事前スキャンできない形式は、展開直後に代わりにチェックされます。

   一致するものがなければ、「このアーカイブはONScripterゲームのようには見えません。0.txt、nscript.dat、またはarc.nsaパックを含むアーカイブを探してください。」と表示されます。

4. 展開。 展開が始まる前に短いカウントダウン（「開始中…」）が実行され、その後はリアルタイムのパーセンテージとキャンセルオプションが表示されます。形式ごとの詳細がいくつかあります。

   • Zipのファイル名はまずUTF-8としてデコードされ、失敗した場合はShift-JISにフォールバックします — これにより日本語アーカイブの文字化けが修正されます。
   • RARの展開では、展開後にブートに必須のファイルの整合性チェックが行われます。欠落または破損しているファイルがあれば、「RARの展開が不完全です：N個の必須ファイルが欠落または破損しています（例：{sample}）。ゲームをZIPまたは7zとして再パックしてインポートし直してください。」と表示されます。
   • __MACOSXフォルダは自動的に削除されます。

5. ゲームルートの検出。 Sakuraは（最大6階層まで）範囲を限定した検索を行い、上記のNScripterマーカーのいずれかを含む最も浅いフォルダを探します — そのためTitle 1.0/Title 1.0/game files…のようにネストしたアーカイブでも正しく解決されます。

6. インストール。 ゲームはライブラリ内の独自フォルダにインストールされ、Mod用や翻訳パッチ用の空のPatchesフォルダも一緒に作成されます。同名のアーカイブが既にインポートされている場合は、数字の接尾辞が追加されます。

展開がキャンセルされた場合はキャンセルしましたとともに閉じる/再起動が表示されます。何か問題が発生した場合は、致命的なエラーポップアップが閉じるまたは**別のものをインポートしますか？**を提示します。

インポートに成功すると、カスタマイズステップでゲーム名（検出された名前が事前入力されています）を設定し、アイコンを選べます — アイコン候補がどのように見つかるかについてはゲームアイコンを参照してください。選択を保持するには保存を、デフォルトのままにするにはスキップをタップします。

最終画面では、ゲーム名とともに「ONScripterゲームをインポートしました」が確認表示され、閉じるまたはゲームに移動しますか？（すぐにゲームを開く）が提示されます。

• **「非対応の形式」または「非対応のアーカイブ形式」**が表示される場合は、上記の形式に関する注意事項を確認してください — 特にCAB形式の.exeインストーラーは、コンピュータ上で展開してから再パックする必要があります。
• 「このアーカイブはONScripterゲームのようには見えません」が表示される場合は、アーカイブに実際にゲームのスクリプトファイルが含まれているか（インストーラーのラッパーや無関係なファイルのフォルダだけになっていないか）を再確認してください。
• より一般的なインポートの問題については、インポートの問題を参照してください。