Demo Git - JavaFX Testing & Open Source Contribution Guide

Repository ini dibuat dengan tujuan untuk mengetes JavaFX yang sudah diinstal dan juga mencoba melakukan push ke dalam sebuah repository. Panduan ini akan membantu Anda untuk pertama kali berkontribusi pada proyek open source.

📋 Prasyarat

Sebelum memulai, pastikan Anda telah menginstal:

• Java Development Kit (JDK) 11 atau lebih baru
• IntelliJ IDEA (Community Edition sudah cukup)
• Git (untuk version control)
• JavaFX (biasanya sudah termasuk dalam JDK modern)

🎯 Tujuan Pembelajaran

Setelah mengikuti panduan ini, Anda akan:

• Memahami cara fork dan clone repository
• Belajar navigasi dasar IntelliJ IDEA
• Mengerti workflow Git untuk kontribusi open source
• Memverifikasi instalasi JavaFX
• Membuat pull request pertama Anda

🚀 Langkah-langkah Kontribusi

1. Fork Repository

Fork adalah membuat salinan repository ke akun GitHub Anda sendiri.

1. Buka https://github.com/traxside/demo-git
2. Klik tombol "Fork" di pojok kanan atas
3. Pilih akun GitHub Anda sebagai destinasi
4. Biarkan semua pengaturan default, klik "Create fork"

💡 Tip: Fork berbeda dengan clone. Fork membuat salinan di GitHub Anda, sedangkan clone mengunduh ke komputer lokal.

2. Clone Repository yang Sudah Di-Fork

Clone adalah mengunduh repository dari GitHub ke komputer lokal Anda.

1. Buka repository yang sudah di-fork di akun GitHub Anda
2. Klik tombol hijau "Code"
3. Salin URL repository (biasanya berformat: https://github.com/username-anda/demo-git.git)
4. Buka Command Prompt (Windows) atau Terminal (Mac/Linux):
   • Windows: Tekan Win + R, ketik cmd, tekan Enter
   • Mac: Tekan Cmd + Space, ketik "Terminal", tekan Enter
   • Linux: Tekan Ctrl + Alt + T
5. Navigasi ke folder tempat Anda ingin menyimpan project:

   cd Desktop
   # atau
   cd Documents

6. Clone repository dengan mengetik:

   git clone https://github.com/username-anda/demo-git.git

7. Masuk ke folder project:

   cd demo-git

3. Buka Project di IntelliJ IDEA

1. Buka IntelliJ IDEA
2. Pilih "Open" dari menu utama
3. Navigasi ke folder demo-git yang baru saja di-clone
4. Klik "OK"
5. Jika diminta, pilih "Trust Project"
6. Tunggu hingga IntelliJ selesai mengindex project (progress bar di bagian bawah)

💡 Tip: Jika ini pertama kali Anda membuka project Java, IntelliJ mungkin akan mengunduh dependencies. Pastikan koneksi internet stabil.

4. Memahami Struktur Project

Setelah project terbuka, Anda akan melihat struktur folder seperti ini:

demo-git/
├── src/
│   └── main/
│       └── java/
│           └── com.example.demo/
│               ├── HelloApplication.java
│               └── HelloController.java
├── src/main/resources/
│   └── com/example/demo/
│       └── hello-view.fxml
├── build.gradle
├── gradlew (Linux/Mac)
├── gradlew.bat (Windows)
└── README.md

Penjelasan file penting:

• HelloController.java: File yang akan kita ubah
• HelloApplication.java: File utama untuk menjalankan aplikasi
• hello-view.fxml: File layout tampilan aplikasi
• build.gradle: File konfigurasi Gradle untuk dependencies dan build script
• gradlew / gradlew.bat: Gradle Wrapper untuk menjalankan perintah Gradle

5. Build dan Menjalankan Aplikasi (Testing JavaFX)

Project ini menggunakan Gradle sebagai build tool. Sebelum melakukan perubahan, mari kita build dan jalankan aplikasi untuk memastikan JavaFX berfungsi:

Cara 1: Menggunakan Terminal (Recommended)

1. Buka Terminal di IntelliJ:

   • Klik "Terminal" di bagian bawah IntelliJ, atau
   • Tekan Alt + F12 (Windows/Linux) atau Option + F12 (Mac)

2. Build aplikasi terlebih dahulu:

   # Untuk Windows
   .\gradlew build
   
   # Untuk Mac/Linux
   ./gradlew build

   Perintah ini akan:

   • Mengunduh dependencies yang diperlukan
   • Mengcompile kode Java
   • Mempersiapkan aplikasi untuk dijalankan

3. Jalankan aplikasi:

   # Untuk Windows
   .\gradlew run
   
   # Untuk Mac/Linux
   ./gradlew run

4. Jika berhasil, akan muncul window aplikasi JavaFX dengan tombol dan text

💡 Penjelasan Gradle Wrapper:

• gradlew adalah Gradle Wrapper yang memastikan semua developer menggunakan versi Gradle yang sama
• Anda tidak perlu menginstall Gradle secara terpisah
• Gradle Wrapper akan otomatis mengunduh Gradle jika belum ada

Cara 2: Menggunakan IntelliJ (Alternative)

Jika cara terminal tidak berfungsi, Anda bisa menggunakan IntelliJ:

1. Di panel kiri IntelliJ, expand folder src/main/java/com.example.demo
2. Klik kanan pada HelloApplication.java
3. Pilih "Run 'HelloApplication.main()'"

🔧 Troubleshooting:

• Jika muncul error "gradlew permission denied" di Mac/Linux, jalankan: chmod +x gradlew
• Jika build gagal, pastikan koneksi internet stabil untuk mengunduh dependencies
• Jika muncul error JavaFX module, coba bersihkan cache: ./gradlew clean build

6. Membuat Branch Baru

Branch adalah cabang terpisah dari kode utama tempat Anda dapat melakukan perubahan tanpa mempengaruhi kode utama.

1. Buka Terminal di IntelliJ:
   • Klik "Terminal" di bagian bawah IntelliJ, atau
   • Tekan Alt + F12 (Windows/Linux) atau Option + F12 (Mac)
2. Pastikan Anda berada di folder project dengan mengetik:

   pwd

3. Tambahkan remote upstream (menghubungkan dengan repository asli):

   git remote add upstream https://github.com/traxside/demo-git.git

4. Buat branch baru dengan nama Anda:

   git checkout -b nama-anda-contribution

   Contoh: git checkout -b john-doe-contribution

💡 Tip: Nama branch sebaiknya deskriptif dan unik. Hindari spasi, gunakan dash (-) atau underscore (_).

7. Melakukan Perubahan Kode

Sekarang saatnya melakukan perubahan pada kode:

1. Di IntelliJ, buka file src/main/java/com.example.demo/HelloController.java
2. Cari baris kode yang berisi:

   welcomeText.setText("Welcome to JavaFX Application!");

3. Ubah menjadi:

   welcomeText.setText("Ketika button ditekan aku muncul!");

4. Simpan file dengan menekan Ctrl + S (Windows/Linux) atau Cmd + S (Mac)

8. Testing Perubahan

Sebelum melakukan commit, pastikan aplikasi masih berjalan dengan baik:

1. Build ulang aplikasi setelah perubahan:

   # Untuk Windows
   .\gradlew build
   
   # Untuk Mac/Linux
   ./gradlew build

2. Jalankan aplikasi untuk testing:

   # Untuk Windows
   .\gradlew run
   
   # Untuk Mac/Linux
   ./gradlew run

3. Klik tombol "Hello!" pada aplikasi

4. Verifikasi bahwa text yang muncul sesuai dengan perubahan yang Anda buat

💡 Tip: Selalu lakukan build dan test setelah melakukan perubahan kode untuk memastikan tidak ada error.

9. Commit Perubahan

Commit adalah menyimpan snapshot perubahan Anda dengan pesan yang menjelaskan apa yang telah diubah.

1. Di terminal IntelliJ, cek status perubahan:

   git status

   Anda akan melihat file yang berubah ditandai dengan warna merah.

2. Tambahkan semua perubahan ke staging area:

   git add .

3. Cek status lagi:

   git status

   File yang berubah sekarang akan berwarna hijau.

4. Buat commit dengan pesan yang jelas:

   git commit -m "Update welcome message in HelloController"

📝 Best Practice: Pesan commit yang baik:

• Gunakan bahasa Inggris
• Mulai dengan kata kerja (Update, Add, Fix, Remove)
• Jelaskan apa yang diubah, bukan mengapa
• Maksimal 50 karakter untuk judul

10. Push ke Repository Fork Anda

Push adalah mengirim perubahan dari komputer lokal ke repository GitHub Anda.

git push origin nama-anda-contribution

Ganti nama-anda-contribution dengan nama branch yang Anda buat sebelumnya.

11. Membuat Pull Request

Pull Request (PR) adalah permintaan untuk menggabungkan perubahan Anda ke repository asli.

1. Buka repository fork Anda di GitHub
2. Anda akan melihat notifikasi bahwa branch baru telah di-push
3. Klik tombol "Compare & pull request"
4. Isi form pull request:
   • Title: Judul yang menjelaskan perubahan
   • Description: Penjelasan detail tentang perubahan yang dibuat
5. Klik "Create pull request"

12. Menunggu Review

Setelah PR dibuat:

• Maintainer repository akan mereview perubahan Anda
• Mereka mungkin memberikan feedback atau meminta perubahan
• Jika disetujui, perubahan Anda akan di-merge ke repository utama

🎉 Selamat!

Anda telah berhasil membuat kontribusi open source pertama Anda! Anda telah belajar:

• Cara fork dan clone repository
• Menggunakan IntelliJ IDEA untuk development
• Workflow Git dasar (branch, commit, push)
• Membuat pull request

📚 Langkah Selanjutnya

Untuk terus belajar tentang kontribusi open source:

1. Cari issue "good first issue" di repository lain
2. Belajar Git lebih mendalam - branching, merging, rebasing
3. Pelajari coding standards - code style, documentation
4. Ikuti community guidelines setiap repository memiliki aturan berbeda

❓ Troubleshooting Umum

Gradle Build Errors

Jika build gagal:

1. Pastikan koneksi internet stabil untuk mengunduh dependencies
2. Coba clean build: ./gradlew clean build
3. Periksa versi Java: java -version (minimal Java 11)

Permission Denied (Mac/Linux)

Jika muncul "permission denied" saat menjalankan gradlew:

chmod +x gradlew

JavaFX Runtime Error

Jika aplikasi tidak muncul atau crash:

1. Pastikan JavaFX sudah termasuk dalam dependencies (cek build.gradle)
2. Coba jalankan dengan flag tambahan jika diperlukan

Git Command Not Found

Jika git tidak dikenali:

1. Install Git dari https://git-scm.com/
2. Restart terminal/command prompt

Permission Denied saat Push

Jika gagal push karena permission:

1. Pastikan Anda push ke repository fork, bukan repository asli
2. Cek authentication GitHub Anda

IntelliJ Tidak Mengenali Project

Jika IntelliJ tidak mengenali sebagai Java project:

1. Klik kanan pada build.gradle
2. Pilih "Import Gradle Project" atau "Refresh Gradle Project"

📞 Bantuan

Jika Anda mengalami kesulitan:

1. Baca dokumentasi resmi Git dan IntelliJ
2. Tanyakan di forum komunitas seperti Stack Overflow
3. Buat issue di repository ini untuk masalah spesifik

---

Happy Contributing! 🚀

Repository ini adalah tempat belajar yang aman. Jangan takut untuk mencoba dan membuat kesalahan - itu bagian dari proses pembelajaran!