Windows のインストール手順

パソコンに合うインストールパッケージを選ぶ

まず、Hangrail 公式サイトのダウンロード欄を開きます。中国本土では Gitee を優先し、接続が不安定な場合は GitHub の予備リンクをご利用ください。一般的な Intel／AMD パソコンは x64、Windows ARM パソコンは ARM64 を選びます。「設定 → システム → バージョン情報」の「システムの種類」で確認できます。

初回インストールでは、対応するアーキテクチャの Setup.zipを選びます。完全に展開すると、フォルダには名前が -Setup.exe で終わるインストーラ、Hangrail-Development.cer の公開証明書と Windows-INSTALL.txt の説明書が入っています。これらのファイルを残したまま、先に証明書を確認し、その後インストーラを実行してください。

開発用証明書を確認する

次のファイルをダブルクリックします： Hangrail-Development.cer 。証明書を表示し、「詳細」でサブジェクトと拇印を確認します。現在の固定の識別情報は次のとおりです：

CER ファイルのハッシュ値は、展開先のフォルダで PowerShell を開き、 Get-FileHash .\Hangrail-Development.cer -Algorithm SHA256 を実行して確認できます。大文字と小文字は区別しません。公式サイトのダウンロード欄の「リリースノート」から、そのバージョンの SHA256SUMS.txtを確認できます。コマンド内のファイル名を、ダウンロードした ZIP のフルパスに置き換えると、パッケージのハッシュ値も確認できます。証明書のハッシュ値は、パッケージのハッシュ値の代わりにはなりません。

名前が同じでも、同じ証明書とは限りません。ハッシュ値や拇印が1つでも一致しない場合は、インストールを中止し、公式サイトのダウンロード欄で配布元を確認してください。

発行元を信頼するか決める

配布元と証明書の一致を確認し、この発行元を信頼する意思がある場合のみ、次の操作へ進んでください：

1. 公開 CER をダブルクリックし、「証明書のインストール」をクリックします。
2. 保存場所に「ローカル コンピューター」を選び、システムの案内に従って管理者権限を確認します。
3. 「証明書をすべて次のストアに配置する」を選び、参照から「信頼されたユーザー」を選択します。
4. 選択したストアを確認してインポートを完了し、同じフォルダで名前が -Setup.exe で終わるインストーラを起動します。

「信頼されたルート証明機関」は選ばないでください。 「ローカル コンピューター → 信頼されたユーザー」へのインポートにより、このパソコンはこの証明書で署名されたパッケージを信頼するようになります。対象は今回ダウンロードした1ファイルに限らず、このパソコンのほかのユーザーにも適用されます。Microsoft や公的な認証局の承認を得た証明書になるわけではありません。インストーラ自体が証明書をインポートしたり、システムの信頼設定を変更したりすることはありません。

インストーラとランタイム

Hangrail が動作中なら、先にメモを保存し、トレイメニューから通常の方法で終了します。インストーラを開いて「Hangrail をインストール（安装 Hangrail）」をクリックします。対応アーキテクチャの .NET デスクトップランタイムを確認し、不足していれば Microsoft 公式からダウンロードして、ハッシュ値と Microsoft のデジタル署名を検証し、インストールを案内します。管理者の確認が表示される場合があります。.NET SDK のインストールは不要です。

ネットワークエラーやキャンセルのあとも、後から再試行できます。ランタイムのインストールで再起動を求められたら、パソコンを再起動してから Hangrail のインストーラを再度実行してください。簡易 MSIX を直接インストールしてもランタイムは自動で準備されないため、初回は Setup の利用をおすすめします。

SmartScreen の警告

「Windows によって PC が保護されました」と表示され、認識されないアプリが阻止されたと説明されている場合は、ファイル名、配布元、パッケージのハッシュ値を先に確認してください。このインストーラを信頼すると確認できた場合のみ、「詳細情報」をクリックし、詳細を確認してから「実行」（表示される場合）を選んでください。これは今回の実行の確認であり、SmartScreen を無効にする必要はありません。関連する説明はこちら：Microsoft の初回配布ガイド。

マルウェアの検出、証明書の不一致、またはシステムポリシーによって続行できない旨が表示された場合は、インストールを中止してご報告ください。保護機能の無効化や除外設定の追加で実行しないでください。

更新とインストールが阻止された場合

通常の更新では、ライブラリ、グループ、設定は維持されます。重要な資料は、先に独立したバックアップを保存することをおすすめします。インストール済みの場合は「設定 → 更新（设置 → 更新）」で確認するか、通常の方法で終了してから公式サイトのインストーラで更新できます。

セキュリティ機能に阻止された場合は、配布元、アーキテクチャ、署名、証明書の信頼を確認してください。組織が管理するパソコンでは、インストールポリシーで制限される場合もあります。インストールに Defender の無効化、署名確認の無効化、テストモードの有効化は必要ありません。判断できない場合は、エラーの内容を次の窓口にお送りください：Hangrail サポート。

Microsoft の MSIX に関する署名・信頼の要件は、次のガイドをご覧ください：署名の概要およびMSIX の署名ガイド。