トラブルシューティング：インストール＆ビルド
1DevToolのインストールまたは初回起動の問題を修正。
macOS：「開発元を検証できないため開けません」
macOSはデフォルトでApp Store外からダウンロードされたアプリをブロックします。これはGatekeeperの警告であり、1DevToolに問題があるという兆候ではありません。
システム設定で修正：
- システム設定 → プライバシーとセキュリティを開く
- セキュリティセクションまでスクロール
- 「1DevToolは確認された開発元のアプリではないため、使用がブロックされました」というメッセージが表示される
- それでも開くをクリック
- 表示されるダイアログで確認
Terminalを使用した代替修正：
xattr -d com.apple.quarantine /Applications/1DevTool.app
このコマンドをTerminalで1回実行し、その後通常どおり1DevToolを起動します。再度プロンプトが表示されることはありません。
Windows：アンチウイルスがインストールをブロック
一部のアンチウイルスプログラムは、新しい、または署名されていないインストーラーを疑わしいものとしてフラグを立て、インストール中にブロックします。
修正：
- アンチウイルスソフトウェアでリアルタイム保護を一時的に無効にする。
- 1DevToolインストーラーを実行。
- インストールが完了した後、リアルタイム保護を再度有効にする。
保護を完全に無効にする代わりに、1DevToolインストーラーファイル（通常1DevTool-Setup.exe）またはインストールディレクトリ（C:\Users\<you>\AppData\Local\1DevTool）に例外を追加することもできます。正確な手順はアンチウイルスによって異なります — アンチウイルス設定で「除外」または「例外」を探す。
Linux：AppImageが起動しない
AppImageをダブルクリックしても何も起こらない、またはすぐに閉じる場合、以下の修正を順番に試す：
ファイルを実行可能にする。 AppImageは実行前に実行権限が必要：
chmod +x 1DevTool-*.AppImage
FUSEをインストール。 AppImageはFUSE（Filesystem in Userspace）を使用して自身をマウント。多くの最小限のLinuxインストールには含まれていない：
sudo apt install libfuse2
Fedora/RHELの場合：sudo dnf install fuse。
Terminalから実行してエラー出力を確認。 それでも失敗する場合、ターミナルから起動してエラーメッセージを読む：
./1DevTool-*.AppImage --no-sandbox
--no-sandboxフラグは、一部の企業Linuxセットアップやコンテナなどの制限された環境で必要な場合があります。
アプリは開くが空白のまま
症状： 1DevToolが起動し、ウィンドウが表示されるが、インターフェースがロードされない — 白または灰色の空白画面。
原因： 以前のインストールまたは失敗したアップデートからの破損したアプリキャッシュファイル。
修正 — キャッシュを削除：
- macOS：
bash
rm -rf ~/Library/Application\ Support/1DevTool/Cache - Windows： ファイルエクスプローラーで
%APPDATA%\1DevTool\Cacheに移動し、Cacheフォルダを削除。 - Linux：
rm -rf ~/.config/1DevTool/Cache
キャッシュを削除した後、1DevToolを再起動。キャッシュは自動的に再構築されます。
起動時にtmuxが見つからない
1DevToolはtmuxを使用して、パネルを切り替えたりアプリを最小化したりしたときにターミナルセッションを存続させます。tmuxがインストールされていない場合、起動時に警告が表示され、ターミナルは永続化されません。
tmuxをインストール：
- macOS：
brew install tmux - Linux（Debian/Ubuntu）：
sudo apt install tmux - Linux（Fedora/RHEL）：
sudo yum install tmuxまたはsudo dnf install tmux
インストール後、1DevToolを完全に終了し、再起動します。カスタムシェルまたは非標準のPATHを使用している場合、tmuxを含むディレクトリ（通常/usr/local/binまたは/usr/bin）がシェルのPATH変数に含まれていることを確認。