Troubleshooting: Installation & Build

macOS: "Cannot Be Opened Because Developer Cannot Be Verified"

macOS default में App Store के बाहर से download किए apps block करता है। यह Gatekeeper warning है, 1DevTool में कुछ गलत का sign नहीं।

System Settings से fix:

1. System Settings → Privacy & Security खोलें
2. Security section तक scroll करें
3. एक message दिखेगा "1DevTool was blocked from use because it is not from an identified developer"
4. Open Anyway click करें
5. आए dialog में confirm करें

Terminal से alternative fix:

xattr -d com.apple.quarantine /Applications/1DevTool.app

Terminal में एक बार यह command चलाएं, फिर normally 1DevTool launch करें। दोबारा prompt नहीं आएगा।

Windows: Antivirus Installation Block कर रहा है

कुछ antivirus programs नए या unsigned installers को suspicious मानकर installation के दौरान block करते हैं।

Fix:

1. Antivirus software में real-time protection temporarily disable करें।
2. 1DevTool installer चलाएं।
3. Installation complete होने के बाद real-time protection re-enable करें।

Protection पूरी disable करने की बजाय, 1DevTool installer file (usually 1DevTool-Setup.exe) या installation directory (C:\Users\<you>\AppData\Local\1DevTool) के लिए exception add कर सकते हैं। Exact steps antivirus के हिसाब से vary करते हैं — antivirus settings में "Exclusions" या "Exceptions" देखें।

Linux: AppImage Launch नहीं हो रहा

AppImage double-click करने पर कुछ नहीं होता, या तुरंत बंद हो जाता है, तो ये fixes order में try करें:

File को executable बनाएं। AppImages को run होने से पहले execute permission चाहिए:

chmod +x 1DevTool-*.AppImage

FUSE install करें। AppImages खुद को mount करने के लिए FUSE (Filesystem in Userspace) use करते हैं। कई minimal Linux installs में यह नहीं होता:

sudo apt install libfuse2

Fedora/RHEL पर: sudo dnf install fuse।

Error output देखने के लिए Terminal से चलाएं। अभी भी fail हो तो terminal से launch करें error message पढ़ने के लिए:

./1DevTool-*.AppImage --no-sandbox

--no-sandbox flag कभी-कभी restricted environments में ज़रूरी होता है।

App खुलता है पर Blank रहता है

Symptom: 1DevTool launch होता है और window appear करती है, पर interface कभी load नहीं होता — बस white या gray blank screen।

Cause: पिछले installation या failed update से corrupted app cache files।

Fix — cache delete करें:

• macOS:
  bash

  rm -rf ~/Library/Application\ Support/1DevTool/Cache
  

• Windows: File Explorer में %APPDATA%\1DevTool\Cache navigate करें और Cache folder delete करें।
• Linux: rm -rf ~/.config/1DevTool/Cache

Cache delete करने के बाद 1DevTool restart करें। Cache automatically rebuild होता है।

Start पर tmux Not Found

1DevTool tmux use करता है panels switch करने या app minimize करने पर terminal sessions alive रखने के लिए। tmux installed नहीं है तो startup पर warning दिखेगी और terminals persist नहीं करेंगे।

tmux install करें:

• macOS: brew install tmux
• Linux (Debian/Ubuntu): sudo apt install tmux
• Linux (Fedora/RHEL): sudo yum install tmux या sudo dnf install tmux

Install करने के बाद 1DevTool completely quit करके relaunch करें। Custom shell या non-standard PATH use करते हैं तो ensure करें कि tmux containing directory (usually /usr/local/bin या /usr/bin) shell के PATH variable में include है।