06. Persiapan

Sebelum bisa menulis kode Lua, ada empat hal yang perlu ada di komputer:

  1. File-file buku ini (bab-babnya beserta contoh kodenya).
  2. Interpreter Lua (program yang menjalankan file .lua).
  3. Sebuah editor kode.
  4. Sebuah terminal untuk mengetik perintah.

Bab ini akan menyiapkan keempat hal tersebut di Windows 10 atau 11.

1. Dapatkan file buku

Setiap bab punya kode yang sesuai di folder exercises/, dan mini-proyek ada di projects/. Untuk menjalankan kodenya, seluruh folder harus ada di komputer.

Ada dua cara untuk mendapatkannya. Gunakan cara yang sudah disiapkan orang tua kamu.

Cara A: salin dari USB atau folder cloud bersama

Orang tua kamu memberikan folder bernama Learning-Lua-Book-101 melalui USB, OneDrive, atau folder bersama lainnya.

  1. Salin seluruh folder ke Documents. Path akhirnya harus terlihat seperti C:\Users\<nama-kamu>\Documents\Learning-Lua-Book-101.
  2. Buka di File Explorer dan pastikan folder tersebut berisi folder book, folder book-src, folder exercises, dan file README.md.

Cara B: clone dari GitHub dengan Git

Jika orang tua kamu menaruh buku ini di GitHub dan memberimu URL-nya:

  1. Install Git for Windows dari https://git-scm.com/download/win, terima semua pilihan default.

  2. Buka PowerShell (tekan tombol Windows, ketik PowerShell, tekan Enter).

  3. Pindah ke folder Documents kamu:

     cd $HOME\Documents

  4. Clone repositorinya (gunakan URL yang diberikan orang tua kamu):

     git clone <url-yang-diberikan-orang-tuamu>

  5. Sekarang file-file buku sudah ada di sebuah folder di dalam Documents.

Bagaimanapun caranya, ketika bab ini menyebut "buka folder buku", yang dimaksud adalah folder yang baru saja kamu taruh di Documents tadi.

2. Install interpreter Lua

Ada lebih dari satu cara untuk install Lua di Windows. Pilih salah satu dari dua cara di bawah. Kalau cara pertama gagal, coba cara kedua.

Cara A: winget (disarankan)

Windows 10 dan 11 sudah dilengkapi dengan winget, sebuah alat untuk menginstall software lewat command line. Cara menggunakannya:

  1. Tekan tombol Windows, ketik PowerShell, dan buka.

  2. Ketik:

     winget search lua

    Sebuah tabel akan muncul berisi daftar paket yang nama atau deskripsinya mengandung kata "lua". Cari paket bernama Lua yang diterbitkan oleh Lua.org atau DEVCOM. Salin nilai di kolom Id untuk baris tersebut.

  3. Install dengan perintah:

     winget install --id <tempel-id-nya-di-sini>

    Misalnya, jika Id-nya adalah DEVCOM.Lua, perintahnya adalah winget install --id DEVCOM.Lua.

  4. Tutup PowerShell dan buka jendela baru. Ini penting: jendela baru akan membaca perubahan PATH yang dibuat oleh installer.

  5. Verifikasi instalasinya:

     lua -v

    Kamu seharusnya melihat baris yang diawali dengan Lua 5. diikuti nomor versi. Kalau sudah muncul, Lua sudah terinstall. Lanjut ke langkah 3.

Jika lua -v menampilkan 'lua' is not recognised as the name of a cmdlet, function, script file, or operable program, berarti installer tidak menambahkan Lua ke PATH. Gunakan Cara B sebagai gantinya.

Cara B: Lua portable dari LuaBinaries

Jika winget tidak berhasil, install Lua secara manual:

  1. Cari di web LuaBinaries Windows x64 dan buka halaman SourceForge-nya.
  2. Unduh file untuk Lua 5.4 yang berakhiran Win64_bin.zip.
  3. Buat folder bernama C:\lua dan ekstrak zip tersebut ke dalamnya. Sekarang folder itu seharusnya berisi lua54.exe.
  4. Ganti nama lua54.exe menjadi lua.exe (atau biarkan tetap bernama lua54.exe dan sesuaikan perintah-perintah berikutnya).
  5. Tambahkan C:\lua ke PATH kamu:
    • Tekan tombol Windows, ketik environment variables, dan buka Edit the system environment variables.
    • Klik Environment Variables....
    • Di bagian User variables, pilih Path dan klik Edit....
    • Klik New, ketik C:\lua, klik OK di setiap jendela.
  6. Buka jendela PowerShell baru dan jalankan lua -v. Kamu seharusnya melihat versi Lua.

3. Install editor kode

Gunakan Visual Studio Code (disingkat VS Code). Gratis, bisa dipakai di Windows, dan merupakan editor yang sama dengan yang digunakan kebanyakan programmer profesional.

  1. Buka https://code.visualstudio.com dan unduh installernya.
  2. Jalankan. Di layar Select Additional Tasks, centang Add to PATH dan Register Code as an editor for supported file types.
  3. Buka VS Code setelah instalasinya selesai.
  4. Install ekstensi bahasa Lua:
    • Klik ikon Extensions di bilah kiri (atau tekan Ctrl + Shift + X).
    • Ketik lua di kotak pencarian.
    • Temukan ekstensi dari sumneko (nama penerbitnya tertulis di bawah judul; kadang tercantum sebagai Lua Language Server).
    • Klik Install.

Ini menambahkan pewarnaan sintaks, autocomplete, dan petunjuk error langsung di file .lua.

4. Terminal

VS Code punya terminal bawaan. Buka dengan **Ctrl + ** (tombol backtick, biasanya ada di bawah Esc`).

Di sinilah kamu mengetik lua nama-file.lua untuk menjalankan sebuah skrip; keluarannya akan muncul di terminal yang sama.

5. Verifikasi semuanya berjalan

Buka VS Code. Pilih File → Open Folder... dan pilih folder tempat kamu menyimpan buku ini. Pohon folder akan muncul di sebelah kiri.

Di pohon tersebut, buka exercises/07/ dan klik 01-hello.lua. Isinya akan tampil di editor.

Buka terminal (Ctrl + `) dan ketik:

lua exercises/07/01-hello.lua

Kamu seharusnya melihat baris ini di terminal:

Hello, world!

Kalau sudah muncul, berarti seluruh persiapan sudah berjalan. Lanjut ke Bab 7.

Jika kamu melihat cannot open exercises/07/01-hello.lua, berarti terminal terbuka di folder yang salah. Terminal seharusnya terbuka di dalam folder buku. Jika belum, tutup terminal dan buka ulang foldernya dengan File → Open Folder....

Cara kode contoh diorganisir

Mulai dari sini, bab-bab akan meminta kamu untuk "membuka file exercises/...", jadi ada baiknya tahu dulu bagaimana folder tersebut disusun.

Setiap bab yang punya kode mendapat folder tersendiri di dalam exercises/, dengan nomor yang sesuai dengan nomor babnya: kode Bab 7 ada di exercises/07/, kode Bab 20 ada di exercises/20/, dan seterusnya. (Bagian 1 semuanya di atas kertas, jadi kode dimulai dari Bab 7.) Mini-proyek ada terpisah, di projects/.

Setiap folder bab berisi tiga jenis file:

  • File contoh di tingkat teratas, seperti exercises/08/01-comment-styles.lua. Ini adalah program-program kecil yang diminta untuk dijalankan oleh kotak Try this di bab tersebut.
  • Folder homework/ berisi file starter untuk setiap soal PR, seperti exercises/08/homework/01-annotate.lua.
  • Folder homework/solutions/ berisi jawaban lengkap untuk setiap soal PR. Coba kerjakan PR-nya sendiri dulu — jawabannya ada di sana untuk digunakan ketika kamu mentok atau ingin memeriksa hasil kerjaanmu.

Jadi ketika Bab 8 menyebut "Buka exercises/08/homework/01-annotate.lua", itulah file yang ada tepat di path tersebut di dalam folder buku yang sudah kamu buka.

Yang tidak dibahas di bab ini

  • Roblox Studio. Roblox menggunakan Lua versinya sendiri, yang disebut Luau, dan skrip-skripnya berjalan di dalam Studio, bukan di terminal. Bab terakhir akan membahas Studio. Untuk sekarang, semuanya dijalankan dengan interpreter lua biasa.
  • Editor lain. Editor lain juga bisa dipakai (Notepad++, Sublime Text, ZeroBrane Studio), tapi buku ini mengasumsikan VS Code mulai dari sini. Dengan editor berbeda, pintasan keyboardnya akan berubah, tapi kodenya tetap sama persis.