Troubleshooting: Instalasi & Build

Perbaiki masalah instalasi 1DevTool atau peluncuran pertama kali.

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

macOS memblokir aplikasi yang diunduh dari luar App Store secara default. Ini adalah peringatan Gatekeeper, bukan tanda ada yang salah dengan 1DevTool.

Perbaiki menggunakan System Settings:

  1. Buka System Settings → Privacy & Security
  2. Scroll ke bagian Security
  3. Anda akan melihat pesan yang mengatakan "1DevTool was blocked from use because it is not from an identified developer"
  4. Klik Open Anyway
  5. Konfirmasi di dialog yang muncul

Perbaikan alternatif menggunakan Terminal:

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

Jalankan command ini sekali di Terminal, lalu luncurkan 1DevTool secara normal. Anda tidak akan diminta lagi.

Windows: Antivirus Memblokir Instalasi

Beberapa program antivirus menandai installer baru atau yang belum ditandatangani sebagai mencurigakan dan memblokirnya saat instalasi.

Perbaikan:

  1. Nonaktifkan sementara real-time protection di software antivirus Anda.
  2. Jalankan installer 1DevTool.
  3. Aktifkan kembali real-time protection setelah instalasi selesai.

Untuk menghindari menonaktifkan protection sepenuhnya, Anda bisa menambahkan pengecualian untuk file installer 1DevTool (biasanya 1DevTool-Setup.exe) atau untuk direktori instalasi (C:\Users\<you>\AppData\Local\1DevTool). Langkah pasti bervariasi berdasarkan antivirus — cari "Exclusions" atau "Exceptions" di pengaturan antivirus Anda.

Linux: AppImage Tidak Mau Diluncurkan

Jika double-click AppImage tidak melakukan apa-apa, atau menutup segera, coba perbaikan ini secara berurutan:

Buat file executable. AppImage memerlukan izin execute sebelum bisa berjalan:

bash
chmod +x 1DevTool-*.AppImage

Instal FUSE. AppImage menggunakan FUSE (Filesystem in Userspace) untuk mount diri mereka. Banyak instalasi Linux minimal tidak menyertakannya:

bash
sudo apt install libfuse2

Di Fedora/RHEL: sudo dnf install fuse.

Jalankan dari Terminal untuk melihat output error. Jika masih gagal, luncurkan dari terminal sehingga Anda bisa membaca pesan error:

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

Flag --no-sandbox kadang diperlukan di lingkungan terbatas seperti beberapa setup Linux korporat atau container.

Aplikasi Terbuka Tapi Tetap Kosong

Gejala: 1DevTool diluncurkan dan jendela muncul, tapi antarmuka tidak pernah dimuat — hanya layar kosong putih atau abu-abu.

Penyebab: file cache aplikasi yang korup dari instalasi sebelumnya atau update yang gagal.

Perbaikan — hapus cache:

  • macOS:
    bash
    rm -rf ~/Library/Application\ Support/1DevTool/Cache
  • Windows: navigasi ke %APPDATA%\1DevTool\Cache di File Explorer dan hapus folder Cache.
  • Linux: rm -rf ~/.config/1DevTool/Cache

Setelah menghapus cache, restart 1DevTool. Cache membangun ulang secara otomatis.

tmux Tidak Ditemukan Saat Start

1DevTool menggunakan tmux untuk menjaga session terminal tetap hidup saat Anda beralih panel atau minimize aplikasi. Jika tmux tidak terinstal, Anda akan melihat peringatan saat startup dan terminal tidak akan persist.

Instal tmux:

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

Setelah menginstal, quit 1DevTool sepenuhnya dan luncurkan ulang. Jika Anda menggunakan shell kustom atau PATH non-standar, pastikan direktori yang berisi tmux (biasanya /usr/local/bin atau /usr/bin) termasuk dalam variabel PATH shell Anda.