Troubleshooting: Installation اور Build

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

macOS ڈیفالٹ میں App Store سے باہر سے download کردہ apps کو block کرتا ہے۔ یہ ایک Gatekeeper warning ہے، 1DevTool کے ساتھ کچھ غلط ہونے کی علامت نہیں۔

System Settings استعمال کر کے حل:

1. System Settings → Privacy & Security کھولیں
2. Security section تک scroll کریں
3. آپ کو "1DevTool was blocked from use because it is not from an identified developer" جیسا پیغام نظر آنا چاہیے
4. Open Anyway کلک کریں
5. ظاہر ہونے والے dialog میں تصدیق کریں

Terminal استعمال کر کے متبادل حل:

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

Terminal میں یہ command ایک بار چلائیں، پھر 1DevTool normally launch کریں۔ آپ کو دوبارہ prompt نہیں ہوگا۔

Windows: Antivirus Installation Block کر رہا ہے

کچھ antivirus programs نئے یا unsigned installers کو مشتبہ mark کرتے ہیں اور installation کے دوران انہیں block کر دیتے ہیں۔

حل:

1. اپنے antivirus software میں عارضی طور پر real-time protection disable کریں۔
2. 1DevTool installer چلائیں۔
3. Installation مکمل ہونے کے بعد real-time protection دوبارہ enable کریں۔

protection مکمل طور پر disable کرنے سے بچنے کے لیے، آپ 1DevTool installer file (عموماً 1DevTool-Setup.exe) یا installation directory (C:\Users\<you>\AppData\Local\1DevTool) کے لیے exception شامل کر سکتے ہیں۔ exact steps antivirus کے مطابق مختلف ہیں — اپنے antivirus settings میں "Exclusions" یا "Exceptions" تلاش کریں۔

Linux: AppImage Launch نہیں ہوتی

اگر AppImage double-click کرنے پر کچھ نہیں ہوتا، یا یہ فوری بند ہو جاتی ہے، تو یہ fixes ترتیب سے آزمائیں:

فائل کو executable بنائیں۔ AppImages چلانے سے پہلے execute permission چاہیے:

chmod +x 1DevTool-*.AppImage

FUSE install کریں۔ AppImages خود کو mount کرنے کے لیے FUSE (Filesystem in Userspace) استعمال کرتی ہیں۔ بہت سے minimal Linux installs میں یہ شامل نہیں ہوتا:

sudo apt install libfuse2

Fedora/RHEL پر: sudo dnf install fuse۔

Terminal سے چلائیں error output دیکھنے کے لیے۔ اگر پھر بھی ناکام ہو، تو terminal سے launch کریں تاکہ error message پڑھ سکیں:

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

--no-sandbox flag کچھ restricted environments جیسے corporate Linux setups یا containers میں sometimes required ہوتا ہے۔

App کھلتی ہے لیکن Blank رہتی ہے

علامت: 1DevTool launch ہوتی ہے اور window ظاہر ہوتی ہے، لیکن interface کبھی load نہیں ہوتا — بس white یا gray blank screen۔

وجہ: پچھلی installation یا failed update سے corrupted app cache files۔

حل — 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 خودکار طریقے سے دوبارہ build ہو جاتا ہے۔

Start پر tmux Not Found

1DevTool panels switch کرنے یا app minimize کرنے پر terminal sessions زندہ رکھنے کے لیے tmux استعمال کرتا ہے۔ اگر tmux install نہیں ہے، تو 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 مکمل طور پر بند کریں اور دوبارہ launch کریں۔ اگر آپ custom shell یا non-standard PATH استعمال کرتے ہیں، تو یقینی بنائیں کہ وہ directory جس میں tmux ہے (عموماً /usr/local/bin یا /usr/bin) آپ کے shell کے PATH variable میں شامل ہے۔