Instalasi #

Sebelum bisa menulis satu baris kode Dart pun, kamu perlu memastikan environment-mu siap. Dart SDK adalah paket tunggal yang berisi compiler, runtime, package manager (dart pub), dan formatter — semuanya dalam satu instalasi. Artikel ini memandu proses instalasi dari awal hingga kamu bisa menjalankan program Dart pertamamu, mencakup tiga sistem operasi utama: Windows, macOS, dan Linux, beserta konfigurasi editor yang akan menemanimu sepanjang proses belajar.

Memahami Dart SDK #

Dart SDK bukan sekadar interpreter. Memahami apa yang kamu install akan membuat proses troubleshooting jauh lebih mudah ketika ada yang tidak berjalan sesuai harapan.

Ketika kamu menginstal Dart SDK, kamu mendapatkan beberapa binary yang langsung bisa digunakan dari terminal:

Semua binary ini tersimpan di dalam folder bin/ dalam direktori Dart SDK. Itulah mengapa langkah “tambahkan ke PATH” selalu muncul di setiap metode instalasi — tanpa PATH yang benar, terminal tidak tahu di mana mencari binary-binary ini.

flowchart LR
    A[Dart SDK] --> B[dart binary]
    B --> C[dart run]
    B --> D[dart compile]
    B --> E[dart pub]
    B --> F[dart analyze]
    B --> G[dart format]
    B --> H[dart test]

Instalasi di Windows #

Windows menawarkan dua jalur instalasi yang berbeda karakter: installer GUI untuk pengguna yang lebih visual, dan Chocolatey untuk kamu yang sudah terbiasa bekerja di terminal. Keduanya menghasilkan instalasi yang identik — perbedaannya hanya di cara dan pengalaman proses instalasinya.

Menggunakan Installer Resmi #

Cara paling langsung tanpa dependensi tambahan. Cocok jika ini adalah instalasi pertamamu di mesin tersebut.

1. Download Dart SDK

Buka dart.dev/get-dart dan pilih tab Windows. Dart menyediakan dua pilihan arsitektur: x64 untuk hampir semua komputer modern, dan ia32 untuk sistem 32-bit yang sudah sangat jarang ditemui. Jika ragu, pilih x64.

Selain itu, kamu bisa memilih channel:

Gunakan Stable untuk keperluan belajar.

2. Jalankan installer

Buka file .exe yang sudah diunduh. Wizard instalasi akan meminta direktori tujuan — defaultnya biasanya C:\Program Files\Dart\dart-sdk. Biarkan default kecuali ada alasan spesifik untuk mengubahnya.

Pastikan opsi “Add Dart to the system PATH” dicentang selama proses instalasi. Jika kamu melewatkan ini, kamu perlu menambahkan PATH secara manual setelah instalasi selesai.

3. Verifikasi di Command Prompt

Buka Command Prompt atau PowerShell baru (harus baru — terminal yang sudah terbuka sebelum instalasi belum memuat PATH yang baru), lalu jalankan:

dart --version

Output yang diharapkan:

Dart SDK version: 3.x.x (stable) (...)

Menggunakan Chocolatey #

Chocolatey adalah package manager untuk Windows yang memungkinkan instalasi dan update software lewat command line. Jika kamu belum punya Chocolatey, ini saat yang baik untuk menginstalnya — karena kamu akan sering menggunakannya untuk kebutuhan developer lainnya.

1. Install Chocolatey

Buka PowerShell sebagai Administrator (klik kanan → “Run as Administrator”), lalu jalankan:

Set-ExecutionPolicy Bypass -Scope Process -Force
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::Tls12
iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

Tutup PowerShell dan buka yang baru setelah instalasi selesai.

2. Install Dart SDK

choco install dart-sdk

Chocolatey akan mengunduh dan menginstal Dart SDK secara otomatis, termasuk konfigurasi PATH.

3. Update Dart di masa depan

Keunggulan menggunakan Chocolatey adalah update yang mudah:

choco upgrade dart-sdk

4. Verifikasi

dart --version

Konfigurasi PATH Manual (Jika Diperlukan) #

Jika kamu melewatkan opsi PATH saat instalasi atau menggunakan metode ekstrak manual, tambahkan PATH secara manual:

1. Buka System Properties → Environment Variables
2. Di bagian “System variables”, cari variabel Path dan klik Edit
3. Klik New dan tambahkan path ke folder bin Dart SDK, contoh: C:\Program Files\Dart\dart-sdk\bin
4. Klik OK, tutup semua dialog, lalu buka terminal baru

flowchart TD
    A[Buka System Properties] --> B[Environment Variables]
    B --> C[Pilih variabel Path]
    C --> D[Edit → New]
    D --> E[Tambahkan path ke dart-sdk/bin]
    E --> F[OK dan restart terminal]
    F --> G{dart --version berhasil?}
    G -- Ya --> H[✓ Instalasi selesai]
    G -- Tidak --> I[Periksa path yang dimasukkan]
    I --> D

Instalasi di macOS #

macOS memberikan pengalaman instalasi yang paling mulus berkat Homebrew — package manager yang sudah menjadi standar de facto di ekosistem macOS developer. Namun, installer manual tetap tersedia jika kamu memilih kontrol penuh atas lokasi instalasi.

Menggunakan Homebrew #

Homebrew adalah cara yang paling direkomendasikan untuk menginstal Dart di macOS, karena pengelolaan update-nya sangat mudah dan terintegrasi dengan workflow developer macOS pada umumnya.

1. Install Homebrew (jika belum ada)

Buka Terminal dan jalankan:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Proses ini memerlukan koneksi internet dan beberapa menit. Homebrew akan meminta password admin untuk menyelesaikan instalasi.

2. Install Dart SDK

brew tap dart-lang/dart
brew install dart

Perintah brew tap menambahkan repository resmi Dart ke daftar sumber Homebrew, sehingga kamu mendapatkan Dart langsung dari tim Dart — bukan dari repository pihak ketiga.

3. Verifikasi

dart --version

4. Update Dart di masa depan

brew upgrade dart

Atau update semua package Homebrew sekaligus:

brew upgrade

Menggunakan Installer dari Situs Resmi #

Jika kamu tidak menggunakan Homebrew atau ingin menempatkan Dart SDK di lokasi spesifik:

1. Download Dart SDK

Kunjungi dart.dev/get-dart, pilih tab macOS, pilih arsitektur (x64 untuk Intel Mac, arm64 untuk Apple Silicon M1/M2/M3).

Jika kamu menggunakan Mac dengan chip Apple Silicon (M1, M2, M3), pastikan memilih arm64 untuk performa optimal. Versi x64 tetap bisa berjalan melalui Rosetta 2, tapi performa native lebih baik dengan arm64.

2. Ekstrak dan pindahkan ke direktori yang tepat

# Ekstrak archive
unzip dart-sdk-macos-x64-release.zip

# Pindahkan ke /usr/local (memerlukan sudo)
sudo mv dart-sdk /usr/local/dart-sdk

3. Tambahkan ke PATH

Edit file konfigurasi shell-mu. Jika menggunakan zsh (default di macOS Catalina ke atas):

echo 'export PATH="$PATH:/usr/local/dart-sdk/bin"' >> ~/.zshrc
source ~/.zshrc

Jika menggunakan bash:

echo 'export PATH="$PATH:/usr/local/dart-sdk/bin"' >> ~/.bashrc
source ~/.bashrc

4. Verifikasi

dart --version

Instalasi di Linux #

Linux adalah platform yang paling fleksibel untuk instalasi Dart. Ada tiga metode yang tersedia tergantung distribusi yang kamu gunakan: APT untuk sistem berbasis Debian/Ubuntu, instalasi manual untuk distribusi lain, dan snap sebagai alternatif universal.

Menggunakan APT (Debian/Ubuntu) #

Metode ini menambahkan repository resmi Dart ke sistem APT, sehingga kamu mendapatkan update Dart bersamaan dengan update sistem reguler.

1. Tambahkan repository Dart

# Install dependensi yang diperlukan
sudo apt-get update
sudo apt-get install apt-transport-https curl gnupg

# Tambahkan signing key Google
curl https://dl-ssl.google.com/linux/linux_signing_key.pub \
  | sudo gpg --dearmor -o /usr/share/keyrings/dart.gpg

# Tambahkan repository Dart
echo 'deb [signed-by=/usr/share/keyrings/dart.gpg arch=amd64] \
  https://storage.googleapis.com/download.dartlang.org/linux/debian stable main' \
  | sudo tee /etc/apt/sources.list.d/dart_stable.list

2. Install Dart SDK

sudo apt-get update
sudo apt-get install dart

3. Tambahkan Dart ke PATH

Dart yang diinstal melalui APT biasanya tersimpan di /usr/lib/dart/bin. Tambahkan ke PATH:

echo 'export PATH="$PATH:/usr/lib/dart/bin"' >> ~/.bashrc
source ~/.bashrc

Jika menggunakan zsh:

echo 'export PATH="$PATH:/usr/lib/dart/bin"' >> ~/.zshrc
source ~/.zshrc

4. Verifikasi

dart --version

Menggunakan Snap #

Snap adalah package manager universal yang tersedia di banyak distribusi Linux modern. Jika sistem kamu sudah memiliki snapd:

sudo snap install dart --classic

Flag --classic diperlukan karena Dart membutuhkan akses penuh ke sistem file, yang tidak diizinkan oleh sandbox Snap standar.

Instalasi Manual (Semua Distribusi) #

Untuk distribusi Linux yang tidak menggunakan APT atau snap — seperti Arch Linux, Fedora, openSUSE, atau Alpine:

1. Download Dart SDK

# Ganti VERSION dengan versi Dart terbaru, contoh: 3.4.0
VERSION=3.4.0
curl -O https://storage.googleapis.com/dart-archive/channels/stable/release/${VERSION}/sdk/dartsdk-linux-x64-release.zip

Atau unduh langsung dari dart.dev/get-dart dan transfer ke server Linux-mu.

2. Ekstrak dan tempatkan SDK

# Ekstrak
unzip dartsdk-linux-x64-release.zip

# Pindahkan ke /usr/local
sudo mv dart-sdk /usr/local/dart-sdk

3. Tambahkan ke PATH secara permanen

echo 'export PATH="$PATH:/usr/local/dart-sdk/bin"' >> ~/.bashrc
source ~/.bashrc

4. Verifikasi

dart --version

Perbandingan Metode Instalasi Linux #

Verifikasi Environment #

Setelah instalasi berhasil di sistem operasi apapun, lakukan verifikasi lengkap sebelum lanjut ke pengaturan editor.

Cek Versi Dart #

dart --version

Output yang diharapkan (versi bisa berbeda):

Dart SDK version: 3.4.0 (stable) (Mon May 20 16:00:00 2024 +0000) on "macos_arm64"

Cek Info Environment Lengkap #

dart info

Perintah ini menampilkan informasi lebih detail: platform, versi SDK, dan lokasi instalasi. Berguna untuk troubleshooting dan ketika melaporkan bug.

Buat dan Jalankan Program Pertama #

Cara terbaik untuk memastikan instalasi berjalan sempurna adalah menjalankan kode Dart sungguhan. Buat file baru bernama hello.dart:

void main() {
  print('Halo, Dart!');
  
  // Cek versi runtime
  print('Platform: ${Platform.operatingSystem}');
}

Jalankan dengan:

dart run hello.dart

Jika output-nya Halo, Dart! muncul di terminal, instalasi kamu berjalan sempurna.

Inisialisasi Project Dart #

Untuk project yang lebih terstruktur, gunakan template project bawaan Dart:

# Buat project console application baru
dart create hello_project

# Masuk ke direktori project
cd hello_project

# Lihat struktur yang dibuat

Struktur project yang dihasilkan:

hello_project/
  ├── bin/
  │   └── hello_project.dart   ← entry point
  ├── lib/
  │   └── hello_project.dart   ← library utama
  ├── test/
  │   └── hello_project_test.dart
  ├── pubspec.yaml              ← konfigurasi project & dependensi
  ├── pubspec.lock
  ├── analysis_options.yaml     ← konfigurasi analyzer
  └── README.md

Jalankan project:

dart run

Pengaturan Editor #

Dart SDK yang sudah terpasang di terminal sudah cukup untuk menjalankan kode, tapi untuk pengalaman menulis kode yang nyaman, kamu perlu editor yang terintegrasi dengan Dart. Dua editor yang paling populer dan memiliki dukungan Dart terbaik adalah Visual Studio Code dan IntelliJ IDEA.

Visual Studio Code #

VS Code adalah pilihan paling umum untuk developer Dart, terutama yang juga menggunakan Flutter. Ringan, cepat, dan memiliki ekosistem ekstensi yang kaya.

1. Install VS Code

Download dari code.visualstudio.com dan install seperti biasa.

2. Install ekstensi Dart

Buka VS Code, tekan Ctrl+Shift+X (Windows/Linux) atau Cmd+Shift+X (macOS) untuk membuka panel Extensions. Cari “Dart” dan install ekstensi Dart dari publisher Dart Code.

Alternatifnya, install dari command line:

code --install-extension Dart-Code.dart-code

3. Fitur yang langsung aktif setelah install ekstensi

Setelah ekstensi Dart terpasang, VS Code langsung mendukung:

• IntelliSense — autocomplete yang memahami tipe data Dart
• Inline error — error ditampilkan langsung di editor, bukan hanya saat compile
• Go to definition — Ctrl+Click untuk lompat ke definisi fungsi atau kelas
• Refactoring — rename variabel, extract method, dan lainnya
• Dart DevTools — debugging visual yang terintegrasi
• Format on save — otomatis memformat kode saat menyimpan file

4. Konfigurasi format on save (opsional tapi direkomendasikan)

Buka Settings (Ctrl+,), cari “format on save”, dan aktifkan. Ini memastikan kode kamu selalu mengikuti Dart style guide tanpa perlu menjalankan dart format secara manual.

Atau tambahkan ke file .vscode/settings.json di project:

{
  "[dart]": {
    "editor.formatOnSave": true,
    "editor.formatOnType": true,
    "editor.selectionHighlight": false,
    "editor.suggest.snippetsPreventQuickSuggestions": false,
    "editor.suggestSelection": "first",
    "editor.tabCompletion": "onlySnippets",
    "editor.wordBasedSuggestions": "off"
  }
}

IntelliJ IDEA #

IntelliJ IDEA (dan Android Studio yang berbasis IntelliJ) memberikan pengalaman IDE penuh dengan fitur refactoring yang lebih canggih. Cocok jika kamu sudah terbiasa dengan ekosistem JetBrains.

1. Install plugin Dart

Buka IntelliJ IDEA, masuk ke Preferences (macOS) atau Settings (Windows/Linux) → Plugins. Cari “Dart” di Marketplace dan klik Install.

2. Konfigurasi SDK path

Setelah plugin terpasang, buka Preferences → Languages & Frameworks → Dart. Isi field “Dart SDK path” dengan lokasi instalasi Dart SDK:

• Windows: C:\Program Files\Dart\dart-sdk
• macOS (Homebrew): /opt/homebrew/opt/dart/libexec
• Linux: /usr/lib/dart atau /usr/local/dart-sdk

3. Verifikasi di IDE

Buka atau buat file .dart. Jika IntelliJ menampilkan syntax highlighting dan autocomplete berjalan, konfigurasi berhasil.

Perbandingan Editor #

Untuk pemula yang baru belajar Dart, VS Code dengan ekstensi Dart adalah pilihan yang paling direkomendasikan. Setup-nya cepat, antarmukanya bersih, dan fiturnya sudah lebih dari cukup untuk belajar hingga membangun aplikasi production.

Troubleshooting Umum #

Beberapa masalah yang sering ditemui setelah instalasi, dan cara mengatasinya.

dart: command not found #

Ini adalah masalah PATH. Terminal tidak bisa menemukan binary dart.

# ANTI-PATTERN: langsung panik dan reinstall
# Reinstall tidak akan membantu jika masalahnya adalah PATH

# BENAR: periksa dulu apakah dart ada di sistem
which dart          # macOS/Linux
where dart          # Windows

# Jika tidak ditemukan, periksa apakah PATH sudah dikonfigurasi dengan benar
echo $PATH          # macOS/Linux
$env:PATH           # Windows PowerShell

Jika dart ada di sistem tapi tetap tidak ditemukan, kemungkinan terminal yang kamu gunakan belum memuat ulang konfigurasi PATH. Tutup terminal dan buka yang baru.

Error saat menjalankan dart run #

# ANTI-PATTERN: abaikan pesan error dan coba jalankan ulang
dart run hello.dart  # kalau error, jalankan lagi berharap error hilang

# BENAR: baca pesan error dengan teliti
dart analyze hello.dart  # analisis kode sebelum menjalankan

Sebagian besar error saat dart run adalah error sintaks yang bisa dideteksi sebelum eksekusi dengan dart analyze.

Versi Dart Tidak Sesuai Ekspektasi #

# Cek versi yang aktif
dart --version

# Jika menggunakan Homebrew di macOS dan versinya masih lama
brew update
brew upgrade dart

# Jika menggunakan Chocolatey di Windows
choco upgrade dart-sdk

# Jika menggunakan APT di Linux
sudo apt-get update
sudo apt-get upgrade dart

Jika kamu memiliki lebih dari satu instalasi Dart di sistem (misalnya satu dari Flutter SDK dan satu instalasi mandiri), perintah dart mungkin menunjuk ke versi yang berbeda dari yang kamu ekspektasikan. Gunakan which dart (macOS/Linux) atau where dart (Windows) untuk memastikan path mana yang aktif.

Memahami Dart SDK vs Flutter SDK #

Satu poin penting yang sering membingungkan pemula: apa hubungan Dart SDK dengan Flutter SDK?

Flutter SDK sudah menyertakan Dart SDK di dalamnya. Jika kamu sudah menginstal Flutter untuk pengembangan mobile/web, kamu sudah punya Dart.

Flutter SDK/
  ├── bin/
  │   └── flutter         ← Flutter CLI
  └── dart-sdk/
      └── bin/
          └── dart         ← Dart yang disertakan Flutter

Namun ada perbedaan penting dalam penggunaannya:

flowchart TD
    A{Apa tujuan utamamu?} -- Belajar Dart / server-side / CLI --> B[Install Dart SDK mandiri]
    A -- Pengembangan mobile/web dengan Flutter --> C[Install Flutter SDK]
    C --> D[Dart SDK sudah termasuk di dalamnya]
    B --> E[Dart SDK siap pakai]
    D --> E
    E --> F[dart --version]

Ringkasan #

• Dart SDK adalah satu paket lengkap — berisi dart run, dart compile, dart pub, dart analyze, dan dart format dalam satu instalasi.
• Windows: gunakan installer resmi dari dart.dev atau Chocolatey (choco install dart-sdk). Pastikan opsi PATH dicentang saat instalasi.
• macOS: Homebrew adalah cara paling mudah — brew tap dart-lang/dart && brew install dart. Pilih arm64 untuk Apple Silicon.
• Linux: APT untuk Debian/Ubuntu (sudo apt-get install dart setelah menambahkan repository), snap untuk distribusi lain, atau ekstrak manual untuk Arch/Fedora dan sejenisnya.
• PATH adalah kunci — jika dart: command not found, masalahnya hampir selalu PATH yang belum dikonfigurasi atau terminal yang belum dimuat ulang.
• Verifikasi instalasi selalu dengan dart --version dan menjalankan file .dart sederhana sebelum lanjut ke pengaturan editor.
• Editor: VS Code dengan ekstensi Dart adalah pilihan yang paling direkomendasikan untuk pemula — ringan, gratis, dan fiturnya lengkap.
• Flutter SDK sudah menyertakan Dart — jika kamu menginstal Flutter, kamu tidak perlu menginstal Dart SDK secara terpisah.
• Update rutin penting karena Dart merilis versi baru secara reguler dengan perbaikan performa dan fitur bahasa baru.

← Sebelumnya: Pengenalan   Berikutnya: Sintaks Utama →