Prasyarat

Sebelum memulai, pastikan Anda telah menginstal Free Pascal Compiler (FPC) versi 3.2.2 atau lebih baru.

Verifikasi Instalasi FPC:

fpc -iV

Perintah di atas akan menampilkan nomor versi seperti 3.2.2 atau lebih tinggi.

Pastikan FPC Ada di PATH:

which fpc        # Untuk Linux/macOS/FreeBSD
where fpc        # Untuk Windows

Jika FPC tidak ditemukan, lakukan langkah berikut tergantung pada sistem operasi Anda:

• Linux/FreeBSD: Instal melalui manajer paket dengan perintah apt install fpc atau pkg install fpc.
• macOS: Instal melalui Homebrew dengan perintah brew install fpc atau unduh dari website resmi Free Pascal.
• Windows: Unduh installer dari website resmi Free Pascal dan tambahkan ke PATH Anda.

Langkah Utama: Menginstal PasBuild

Anda memiliki dua opsi untuk menginstal PasBuild.

Opsi 1: Bootstrap dari Sumber

Clone repositori PasBuild:

git clone https://github.com/graemeg/pasbuild.git
cd pasbuild

Ikuti instruksi di BOOTSTRAP.txt untuk melakukan kompilasi bootstrap:

# Linux/macOS/FreeBSD
mkdir -p target/units
echo '1.0.0' > target/version.inc
fpc -Mobjfpc -O1 -FEtarget -FUtarget/units -Fitarget -Fusrc/main/pascal src/main/pascal/PasBuild.pas

Verifikasi build
./target/PasBuild --version

Untuk menginstal ke sistem (opsional), gunakan perintah berikut:

sudo cp target/PasBuild /usr/local/bin/pasbuild

Opsi 2: Biner yang Telah Dibangun

Download versi terbaru dari GitHub Releases dan ekstrak ke PATH Anda.

Jenis Proyek

PasBuild mendukung dua jenis proyek:

• Proyek Aplikasi - Program eksekusi dengan titik masuk utama.
• Proyek Perpustakaan - Kerangka kerja/perpustakaan yang hanya terdiri dari unit (tanpa eksekusi).

Perbandingan Aplikasi dan Perpustakaan

Aspek	Aplikasi	Perpustakaan
Sumber Utama	Diperlukan: unit harus berupa program	Opsional: program bootstrap otomatis dihasilkan
Keluaran Kompilasi	Biner eksekusi	Unit yang dikompilasi (.ppu)
Konten Paket	Biner eksekusi + LICENSE + README	Kode sumber atau unit yang dikompilasi
Program Bootstrap	Tidak diperlukan	Dihasilkan secara otomatis di target/

Membuat Proyek Pertama Anda

Dengan menggunakan pasbuild init

Cara tercepat untuk memulai proyek baru adalah dengan menggunakan perintah pasbuild init:

mkdir myapp
cd myapp
pasbuild init

Selama proses, Anda akan diminta untuk mengisi informasi berikut:

Project type (application/library) [application]:
Project name [myapp]: MyApplication
Version [1.0.0]:
Author [yourusername]: Your Name
License (MIT/BSD-3-Clause/GPL-3.0/Apache-2.0/Proprietary) [MIT]: BSD-3-Clause

Tekan ENTER untuk menerima nilai default yang ditunjukkan dalam tanda kurung siku.

Struktur yang Dihasilkan (Aplikasi):

myapp/
├── project.xml
├── LICENSE
└── src/
├── main/
│   └── pascal/
│       └── Main.pas
└── test/
└── pascal/
└── TestRunner.pas

Struktur yang Dihasilkan (Perpustakaan):

mylib/
├── project.xml
├── LICENSE
└── src/
├── main/
│   └── pascal/
│       (kosong - tambahkan unit perpustakaan Anda di sini)
└── test/
└── pascal/
└── TestRunner.pas

Penyetelan Proyek Manual

Jika Anda lebih suka membuat file secara manual, ikuti langkah-langkah berikut:

1. Buat struktur direktori:

mkdir -p myapp/src/main/pascal
cd myapp

2. Buat project.xml:

<?xml version="1.0" encoding="UTF-8"?>
<project>
<name>MyApplication</name>
<version>1.0.0</version>
<author>Your Name</author>
<license>BSD-3-Clause</license>

<build>
<mainSource>Main.pas</mainSource>
<executableName>myapp</executableName>
<outputDirectory>target</outputDirectory>
</build>
</project>

3. Buat file Main.pas di src/main/pascal:

Tambahkan kode Pascal sederhana sebagai titik masuk aplikasi Anda. Contoh:

program Main;
begin
WriteLn('Hello, Pascal!');
end.

Konfigurasi Lanjutan

Setelah proyek awal Anda siap, Anda dapat melakukan beberapa konfigurasi lanjutan untuk menyesuaikan proyek Anda, termasuk:

• Penting untuk memanfaatkan project.xml untuk menentukan dependensi dan konfigurasi build lainnya.
• Menambahkan unit tambahan dalam direktori src/main/pascal dan mendefinisikan mereka di project.xml.

Menambahkan Dependensi:

Untuk menambahkan dependensi, cukup tambahkan entri di bagian <build> dalam project.xml. Contoh:

<dependencies>
<dependency>MyLibrary</dependency>
</dependencies>

Best Practices

Berikut adalah beberapa praktik terbaik yang perlu diperhatikan saat mengembangkan proyek menggunakan Pascal dan PasBuild:

• Selalu gunakan sistem kontrol versi seperti Git untuk melacak perubahan dalam kode Anda.
• Buat dokumentasi yang jelas untuk proyek Anda agar lebih mudah untuk dipahami oleh orang lain.
• Gunakan pengujian unit untuk memastikan bahwa kode Anda berfungsi dengan baik dan tidak ada bug.
• Jaga agar kode Anda terstruktur dengan baik dan mudah dibaca untuk meningkatkan pemeliharaan di masa mendatang.
• Lakukan regular backup dan buat release notes setiap kali Anda merilis versi baru dari aplikasi Anda.

Pengelolaan Masalah

Jika Anda mengalami masalah, berikut adalah beberapa langkah untuk melakukan troubleshooting:

• Periksa versi FPC Anda dan pastikan itu memenuhi syarat minimal.
• Pastikan semua file sumber berada pada jalur yang benar dan memiliki izin yang tepat.
• Baca log kesalahan jika aplikasi Anda tidak menghasilkan output yang diharapkan.
• Jika Anda mengalami masalah dengan dependensi, pastikan semua unit telah ditambahkan di project.xml.
• Cobalah untuk membersihkan proyek (dengan perintah pasbuild clean) sebelum melakukan build ulang.

Kesimpulan

Dengan mengikuti panduan ini, Anda telah berhasil menginstal Free Pascal dan PasBuild, serta membuat proyek pertama Anda. Selanjutnya, Anda dapat menjelajahi lebih banyak fitur dan mendalami bahasa Pascal untuk mengembangkan aplikasi yang lebih kompleks.

Untuk bantuan lebih lanjut, pertimbangkan untuk menghubungi profesional atau bergabung dengan komunitas pemrograman untuk berbagi pengalaman dan belajar dari satu sama lain.

Jika Anda memerlukan jasa setup lebih lanjut, silakan klik tautan berikut: