# インストール PlayGuard のインストール、アップデート、削除の方法と、PlayGuard が SD カードに書き込むファイルについて説明します。インストールしたら、[はじめに](https://guard.boreale.dev/ja/docs/getting-started.md)へ。 ## 入手方法 次のどれかを選んでください。 - **Homebrew App Store** / **sphaira の App Store**（同じカタログ） — *PlayGuard* を検索してインストールしてください。新しいリリースは審査のあとに自動で取り込まれます（多くは GitHub の数日後です）。PlayGuard はそこからインストールされたことを認識し、ストアでのアップデートをおすすめします。 - **手動** — [最新リリース](https://github.com/JigSawFr/PlayGuard/releases/latest)から `playguard.zip` をダウンロードし、SD カードの**ルート**に展開します。アプリは `sd:/switch/playguard/` に、アプリのファイルは `sd:/config/playguard/` に入ります。 - **sphaira › GitHub** — リリースの zip にはエントリー（`/config/sphaira/github/playguard.json`）が入っています。一度インストールしたあとは、sphaira の *GitHub* からアップデートできます。 オプションの**リカバリー sysmodule** は、PlayGuard からインストールするか（*本体 › 追加モジュール*、または *セキュリティ › ロックされて入れない？*）、専用のダウンロード（`playguard-rescue.zip`）から手動でインストールします。手動の場合は、これも SD カードのルートに展開し、本体を再起動してください。`atmosphere/contents/4200000000505247/` に入り、`RESCUE` ファイルで求められたときにだけ動きます。[ロックされて入れない？](https://guard.boreale.dev/ja/docs/troubleshooting.md#ロックされて入れない)を参照してください。 そのあと、PlayGuard を**ゲームの上から**、保護者のユーザーで開きます（[理由](https://guard.boreale.dev/ja/docs/compatibility.md#ランチャー)）。 ## アップデート - **PlayGuard で：** *オプション › アップデート方法* で方法を選びます。PlayGuard 内で（リリースをダウンロードして確認し、自分を置き換えて再起動します）、sphaira、Homebrew App Store、手動のどれかです。*毎日アップデートを確認* がオンなら、新しいリリースがあるとき、PlayGuard はそのリリースの画面で開きます。 - **リカバリー sysmodule** は PlayGuard のバージョンに合わせます。アップデートのたびに、そのリリースの `playguard-rescue.zip` を展開し直し（またはベルの *リカバリー sysmodule が最新ではありません* で *更新*、または *本体 › 追加モジュール* で）、本体を再起動してください。 - **リモート接続のエージェント** は、インストールしてあれば、PlayGuard がより新しいものを含むとき、次の起動時に提案されます（[Home Assistant](https://github.com/JigSawFr/PlayGuard/blob/main/docs/home-assistant.md#keep-the-link-up-when-playguard-is-closed)、英語）。 - 設定、履歴、プリセット、バックアップはそのまま残ります。アプリの隣ではなく、`sd:/config/playguard/` にあるからです。 ## 削除 `sd:/switch/playguard/`（アプリ）を削除します。アプリのファイルも消すなら `sd:/config/playguard/` も、オプションの sysmodule を入れていれば `sd:/atmosphere/contents/4200000000505247/`（リカバリー）と `sd:/atmosphere/contents/4200000000504741/`（エージェント）も削除します。先に *本体 › 追加モジュール* で削除することもできます。上限、暗証番号、制限は本体自身のものなので、**本体に残ります**。それらも消すには、先に *セキュリティ › みまもり設定をすべて削除* を使ってください。 ## SD カード上のファイル すべて `sd:/config/playguard/` にあります（アプリ自体は `sd:/switch/playguard/` にあるので、アプリを削除・再インストールしてもこれらのファイルは残ります）。これらのファイルをアプリと同じ場所に置いていた以前のバージョンでは、最初の起動時にここへ移動しました。 - **`config.json`** — オプション（言語、テーマ、NTP サーバー、*PlayGuardを暗証番号で保護* …）。すべてのキーは [config.md](https://guard.boreale.dev/ja/docs/config.md)（英語）にあります。読み込めないファイルは `config.json.bad` として残され（その前のものは `.bad.1`）、設定は初期値に戻ります。PlayGuard は起動時に一度そのことを知らせます - **`profiles/`** — 保存したプレイ時間のプリセット - **`exports/`** — プレイ記録のエクスポート - **`nand//`** — システムごとのデータです。システムはそれぞれ独自のみまもり設定を持っています。sysMMC は `sysmmc/`、emuMMC は `emummc/` です。中身は次のとおりです。`history.json`：変更履歴（新しいものから 500 件。本体が拒否した変更も含みます。読み込めないファイルは上書きせずに `history.json.bad`、その前のものは `.bad.1` として残し、PlayGuard が一度知らせます）。`state.json`：*すべてのソフトをブロック*、延長、保留中の再ロック、ファームウェアの選択のために覚えておく内容（[config.md](https://guard.boreale.dev/ja/docs/config.md#state-kept-between-launches)、英語）。`forwarders.json`：PlayGuard が作成したフォワーダー。`watch.json`：PlayGuard が最後に見た本体の状態で、PlayGuard の外で変わったことを知らせるために使います（[config.md](https://guard.boreale.dev/ja/docs/config.md#watchjson)、英語。削除しても問題ありません）。`backups/`：設定のバックアップ（暗証番号は含みません）。`cache/`：最後に読み込んだプレイ記録（すべてのユーザーと、表示した各ユーザー）。次の起動時、記録を読み直している間にすぐ表示されます。これらのフォルダーができる前のバージョンのファイルは、PlayGuard が最初に起動したシステムに移されます - **`cache/`** — ゲームのアイコン（`icons/`、最大 16 MB、本体の言語が変わると空になります）。すべてのシステムで共有し、起動のたびに各ゲームから名前とアイコンを読み直さずに済むようにします。Atmosphère、hekate、sys-patch、ファームウェアのリリースノート（`sys_notes.json`、*本体* 用）と、PlayGuard 自身のリリースノート（*情報* 用）。開発者モードでは、*別のビルドをインストール* の一覧（`dev_builds.json`） - **`github_token`** — *レポートを送信…* と、開発者モードでは *別のビルドをインストール* で使う GitHub のログイン情報です。ログアウトすると削除されます（*情報 › ヘルプと診断 › GitHub アカウント*、ログイン中に表示されます） - **`gate.nro`**、**`gate-.nro`**、**`gate_*.txt`** — 保護されたフォワーダーのゲート（*本体 › フォワーダー*）です。そのプログラム、暗証番号なしの時間帯、利用不可の時間、拒否後の一時停止、PlayGuard が読み込むまでの試行の記録、起動画面の表示時間（`gate_wait.txt`。起動のたびに読み込まれます） - **`previous_build.json`**、**`boot_check.json`** — ビルドをその場でインストールしたあとに使います。置き換えたビルドの名前（そのビルドは `.nro` の隣に `playguard.nro.previous` として残ります）と、次回の起動のチェック（最初の画面が表示されると削除されます） - **`rescue_report.txt`** — リカバリー sysmodule が動作したあとに残すファイルです。PlayGuard が起動時に表示するまで残ります（PlayGuard が読み込めない場合は削除され、そのことを知らせます） - **`rescue_nonce`** — リカバリー sysmodule がレポートの中で答えるランダムなチャレンジです。これで PlayGuard は、sysmodule が書いたレポートと手で書かれたレポートを見分けられます（[sysmodule/rescue/README.md](https://github.com/JigSawFr/PlayGuard/blob/main/sysmodule/rescue/README.md)、英語）。起動のたびに新しくなります - **`sync.conf`** — *リモートアクセス* を設定したあとにだけ作られます。接続の設定で、ブローカーのパスワードも含みます（レポートやアップロードには決して含まれません） - **`sync/`** — *リモートアクセス* を使うときだけ作られます。オプションのエージェント用に保存したプリセット（`profiles.txt`）。エージェントが 1 つのシステムについて読み書きするものは、そのシステムの `nand//sync/` にあります（記録、ゲーム名、変更した内容、イベント）。sysMMC と emuMMC は `sync.conf` を共有しますが、Home Assistant では 2 つのデバイスになります - **`logs/`** — `reports/`：保存した診断レポート（暗証番号やシリアル番号は含みません）。`crashes/`：クラッシュごとに 1 ファイル（PlayGuard が止まった原因）。`uploads/`：オンラインで送信したレポートごとのインターネットショートカット（`.url`）。`play_timer/`：開発者ツールのプレイ時間記録ファイル。レポート、クラッシュファイル、リンクをいくつ残すかは *情報 › ヘルプと診断* で設定します（件数、日数、容量で指定。最新のものは必ず残ります） 詳しくは [packaging/README.md](https://github.com/JigSawFr/PlayGuard/blob/main/packaging/README.md)（英語）をご覧ください。