← ホームに戻る

インストールガイド

kazahana は現在コード署名を行っていないため、OS のセキュリティ機能により警告が表示されます。
以下の手順に従ってインストールしてください。

desktop_windows Windows

1. インストーラーのダウンロード

GitHub Releases ページから最新版のインストーラーをダウンロードします。

ファイル名形式対象
kazahana_x.x.x_x64-setup.exeNSIS インストーラーWindows 10 / 11（64bit）
kazahana_x.x.x_x64_en-US.msiMSI インストーラーWindows 10 / 11（64bit）

2. SmartScreen 警告の対処

インストーラーを実行すると、Microsoft Defender SmartScreen により以下の警告が表示されます。

Windows によって PC が保護されました
Microsoft Defender SmartScreen は認識されないアプリの起動を停止しました。このアプリを実行すると、PC に問題が起こる可能性があります。

これはコード署名が行われていないアプリに対して表示される標準的な警告です。kazahana はオープンソースソフトウェアであり、ソースコードは GitHub 上で公開されています。

  1. 警告ダイアログの「詳細情報」をクリックします
  2. アプリ名と発行元の情報が表示されます
  3. 「実行」ボタンをクリックします

3. インストール

SmartScreen を通過すると、通常のインストールウィザードが開始します。

  1. インストール先フォルダを確認します（デフォルトのままで問題ありません）
  2. 「インストール」をクリックします
  3. インストールが完了したら「完了」をクリックします

4. 起動

スタートメニューまたはデスクトップのショートカットから kazahana を起動します。初回起動以降は SmartScreen の警告は表示されません。

補足：ブラウザのダウンロード警告

  • Microsoft Edge:「一般的にダウンロードされていません」と表示されることがあります。… メニュー → 「保持する」を選択してください。
  • Google Chrome:「危険なファイルの可能性があります」と表示されることがあります。∧ アイコン → 「保持する」を選択してください。

laptop_mac macOS

1. インストーラーのダウンロード

GitHub Releases ページから最新版のインストーラーをダウンロードします。

ファイル名対象
kazahana_x.x.x_x64.dmgmacOS（Intel）
kazahana_x.x.x_aarch64.dmgmacOS（Apple Silicon：M1 / M2 / M3 / M4）

お使いの Mac のチップを確認するには：画面左上の Apple メニュー → 「この Mac について」を開いてください。

2. アプリのインストール

  1. ダウンロードした .dmg ファイルを開きます
  2. kazahana アイコンを Applications フォルダにドラッグ＆ドロップします
  3. .dmg ウィンドウを閉じ、ディスクイメージを取り出します

3. Gatekeeper 警告の対処

初回起動時に、macOS の Gatekeeper により以下の警告が表示されます。

「"kazahana" は、開発元を検証できないため開けません。」

これはコード署名・公証が行われていないアプリに対して表示される標準的な警告です。

方法 A：システム設定から許可する（推奨）

  1. 上記の警告が表示されたら、「OK」をクリックしてダイアログを閉じます
  2. システム設定 → 「プライバシーとセキュリティ」を開きます
  3. 画面下部に「"kazahana" は開発元を確認できないため、使用がブロックされました」と表示されています
  4. 「このまま開く」をクリックします
  5. 管理者パスワードまたは Touch ID で認証します
  6. 確認ダイアログが表示されたら「開く」をクリックします

方法 B：右クリックから開く

  1. Finder でアプリケーションフォルダを開きます
  2. kazahana を右クリック（または Control + クリック）します
  3. メニューから「開く」を選択します
  4. 「開発元を検証できません。開いてもよろしいですか？」と表示されたら「開く」をクリックします

macOS のバージョンによっては、方法 B が機能しない場合があります。その場合は方法 A をお試しください。

方法 C：ターミナルから quarantine 属性を削除する（上級者向け）

ターミナルを開き、以下のコマンドを実行します。

xattr -cr /Applications/kazahana.app

このコマンドにより、ダウンロードファイルに付与される隔離属性（com.apple.quarantine）が削除され、Gatekeeper の検証をスキップして起動できるようになります。

4. 起動

Launchpad またはアプリケーションフォルダから kazahana を起動します。初回の許可操作以降は、通常どおり起動できます。

delete アンインストール

Windows

設定 → アプリ → インストールされているアプリから kazahana を選択し、「アンインストール」をクリックします。

macOS

アプリケーションフォルダから kazahana をゴミ箱にドラッグします。

build トラブルシューティング

アプリが起動しない場合

  • OS が最新バージョンに更新されていることを確認してください
  • Windows：Windows 10 以降が必要です
  • macOS：macOS 12 (Monterey) 以降が必要です

「破損しているため開けません」と表示される場合（macOS）

ターミナルで以下のコマンドを実行してください。

xattr -cr /Applications/kazahana.app

その他の問題

問題が解決しない場合は、以下からお問い合わせください。

shield セキュリティについて

kazahana はオープンソースソフトウェア（MIT ライセンス）です。ソースコードは GitHub 上で公開されており、どなたでも内容を確認できます。

現在、コード署名は行っていないため、OS のセキュリティ警告が表示されます。これはアプリが危険であることを意味するものではなく、発行元の電子的な検証ができないことを示しています。将来的にはコード署名の導入を予定しています。

menu_book 次のステップ

インストールが完了したら、操作マニュアルで kazahana の使い方をスクリーンショット付きで確認できます。