Penyiapan

Topik ini menyiapkan lingkungan kerja Erlang dari awal: memilih cara pemasangan Erlang/OTP 29, memeriksa hasil pemasangan, memasang alat build rebar3, dan membuat proyek pertama dengan struktur bawaan rebar3. Seluruh perintah pada topik ini dieksekusi nyata dan keluarannya disalin apa adanya.

Pilihan pemasangan Erlang/OTP#

Halaman unduhan resmi di erlang.org/downloads mencantumkan rilis terkini, yaitu Erlang/OTP 29.1.2 per 14 Oktober 2026, beserta jalur-jalur pemasangan yang disarankan. Jalur pertama adalah paket prabuat (prebuilt) yang paling cepat dipakai: manajer paket sistem operasi menyediakannya dengan perintah brew install erlang pada macOS dengan Homebrew, apt-get install erlang pada Ubuntu dan Debian, dnf install erlang pada Fedora, atau pacman -S erlang pada Arch Linux dan Manjaro. Jalur kedua adalah kompilasi dari kode sumber dengan ./configure, make, dan make install, yang dipilih bila perlu opsi khusus atau bila paket untuk sistem operasi tidak tersedia.

Paket dari manajer paket distribusi kadang tertinggal dari rilis terkini karena tiap distribusi membekukan versinya sendiri. Periksa nomor versi hasil pemasangan dengan perintah pada bagian berikut, dan pastikan nomor rilisnya sesuai target sebelum melanjutkan. Tabel berikut meringkas pertimbangan setiap jalur:

Memeriksa hasil pemasangan#

Perintah berikut menjalankan Erlang tanpa shell interaktif, membaca nomor rilis OTP lewat fungsi bawaan erlang:system_info/1, lalu menghentikan VM:

# periksa nomor rilis OTP yang terpasang
erl -noshell -eval 'io:format("~s~n", [erlang:system_info(otp_release)]), halt().'

29

Angka 29 menunjukkan bahwa seri OTP yang terpasang sudah sesuai. Opsi -noshell membuat VM berjalan tanpa shell interaktif, sehingga perintah ini aman dipakai di skrip.

Pemeriksaan tambahan bisa dilakukan dengan menjalankan erl tanpa argumen. VM akan menampilkan banner semacam Erlang/OTP 29 [erts-17.1.1] [source] [64-bit] [smp:2:2] ... diikuti prompt 1>. Banner itu membawa informasi berguna: komponen runtime yang dipakai, arsitektur prosesor (64-bit), dan jumlah penjadwal yang aktif. Topik alur kerja shell membahas sesi interaktif ini bagian demi bagian, sehingga untuk pemeriksaan versi otomatis cukup bentuk -noshell di atas.

Menyiapkan rebar3#

Rebar3 adalah alat build standar ekosistem Erlang: mengompilasi proyek, mengelola dependensi, menjalankan pengujian, hingga membuat release. Tanpa alat seperti ini, proyek yang tumbuh segera membutuhkan skrip sendiri untuk urutan kompilasi, pengerjaan dependensi, dan penyalinan hasil build. Rebar3 mengambil alih semuanya dengan konvensi yang sama untuk semua proyek Erlang, sehingga struktur proyek tetap dikenal meski berganti tim. Pemasangannya paling mudah dengan mengunduh satu berkas skrip mandiri (escript) dari halaman rilis resmi proyek rebar3, memberi izin eksekusi, lalu meletakkannya di dalam PATH. Beberapa manajer paket distribusi juga menyediakan paket rebar3, dan di lingkungan yang mendukung brew tersedia brew install rebar3.

Periksa pemasangannya sebagai berikut:

# periksa versi rebar3
rebar3 --version

rebar 3.28.0 on Erlang/OTP 29 Erts 17.1.1

Keluaran mencantumkan versi rebar3 dan versi Erlang yang dipakainya, sehingga sekali jalan memastikan kedua alat kompatibel. Kode Erts 17.1.1 merujuk pada versi ERTS (Erlang Runtime System), komponen runtime VM BEAM yang membawa penjadwal dan manajemen memori.

Proyek pertama dengan rebar3#

Perintah rebar3 new membuat kerangka proyek dari templat. Templat lib menghasilkan proyek pustaka (library), bentuk yang paling umum untuk memulai:

# buat kerangka proyek pustaka bernama kalkulator
rebar3 new lib kalkulator

===> Writing kalkulator/src/kalkulator.erl
===> Writing kalkulator/src/kalkulator.app.src
===> Writing kalkulator/rebar.config
===> Writing kalkulator/.gitignore
===> Writing kalkulator/LICENSE.md
===> Writing kalkulator/README.md

Struktur hasilnya seperti berikut:

# tampilkan pohon berkas proyek
find kalkulator -type f | sort

kalkulator/.gitignore
kalkulator/LICENSE.md
kalkulator/README.md
kalkulator/rebar.config
kalkulator/src/kalkulator.app.src
kalkulator/src/kalkulator.erl

Tiga berkas di dalamnya menentukan bentuk proyek. Berkas rebar.config menyimpan konfigurasi build dan daftar dependensi:

{erl_opts, [debug_info]}.
{deps, []}.

Opsi debug_info membuat compiler menyimpan informasi debug pada berkas .beam, yang dipakai alat analisis seperti dialyzer. Daftar deps masih kosong karena proyek baru belum bergantung pada pustaka lain.

Berkas src/kalkulator.app.src adalah templat metadata aplikasi. Rebar3 akan memprosesnya menjadi berkas .app yang sah saat build:

{application, kalkulator, [
    {description, "An OTP library"},
    {vsn, "0.1.0"},
    {registered, []},
    {applications, [
        kernel,
        stdlib
    ]},
    {env, []},
    {modules, []},
    {licenses, ["Apache-2.0"]},
    {links, []}
 ]}.

Beberapa bidangnya perlu dikenal sejak awal. Bidang description dan vsn menyimpan ringkasan serta nomor versi aplikasi. Bidang applications mencantumkan aplikasi yang harus sudah berjalan sebelum aplikasi ini dimulai, dan templat bawaan sudah mengisi kernel serta stdlib sebagai fondasi OTP. Bidang registered akan berisi daftar nama proses terdaftar yang dimiliki aplikasi, sedangkan modules dibiarkan kosong karena rebar3 mengisinya secara otomatis saat build. Bidang env menyimpan konfigurasi bawaan aplikasi, sedangkan bidang licenses dan links menjadi bagian metadata paket saat dipublikasikan.

Berkas src/kalkulator.erl adalah modul kode sumber pertama, yang untuk saat ini masih berupa kerangka tanpa fungsi:

-module(kalkulator).

-export([]).

Baris -module(kalkulator). harus cocok dengan nama berkasnya, sedangkan -export([]). adalah daftar fungsi yang dapat dipanggil dari luar modul, yang akan terisi seiring proyek berkembang. Berkas README.md, LICENSE.md, dan .gitignore dari templat dapat disesuaikan belakangan dan tidak memengaruhi build.

Ringkasan#

• Halaman unduhan resmi mencantumkan rilis terkini Erlang/OTP, dan paket prabuat dari manajer paket adalah jalur pemasangan tercepat.
• Pemeriksaan versi dengan erlang:system_info(otp_release) harus menampilkan 29 untuk jalur ini.
• Rebar3 dipasang sebagai satu berkas escript dan menjadi alat build, pengelola dependensi, dan alat pengujian proyek.
• rebar3 new lib kalkulator menghasilkan proyek dengan rebar.config, templat aplikasi di src/kalkulator.app.src, dan modul pertama di src/kalkulator.erl.

Referensi#

• Download Erlang/OTP — Ericsson — Halaman resmi unduhan Erlang/OTP beserta perintah pemasangan per sistem operasi.
• Rebar3 Documentation — Erlang Ecosystem Foundation — Dokumentasi resmi rebar3, termasuk pemasangan dan perintah new.