TEMPLATE PROJECT PRAKTIKUM PPB 4721

Template ini dirancang untuk mendukung pembelajaran praktikum Pemrograman Perangkat Bergerak (PPB) 4721 dengan menggunakan Flutter sebagai framework utama. Template ini mempermudah pengelolaan proyek praktikum, sekaligus memperkenalkan penggunaan Git untuk version control dan GitHub sebagai platform repository serta alat CI/CD. Dalam repository ini, telah ditambahkan workflow otomatis untuk menghasilkan dokumentasi dalam format PDF serta mengunggahnya ke Google Drive, sehingga memudahkan pengelolaan. Dukungan Anda sangat berarti, cukup dengan memberikan bintang (Star) atau mengikuti profil GitHub saya untuk membantu saya, yang kurang mahir dalam mempromosikan diri di media sosial. Selamat belajar! 🎉

Daftar Isi

1. Requirements
2. Instalasi
3. Integrasi dengan Google Drive (opsional)
4. Penggunaan
   • Membuat projek baru
   • Generate dokumentasi
5. Kontribusi

Requirements

• Akun Github dan sudah melakukan 2FA (untuk menjalankan Github Action)
• Version Control (Git)
• Flutter SDK
• IDE Visual Studio Code

Instalasi

1. Pastikan Anda sudah login ke GitHub dan telah mengaktifkan 2FA (Two-Factor Authentication), karena ini merupakan syarat wajib untuk menjalankan GitHub Actions.
2. Tekan tombol Star di pojok kanan atas repository ini sebagai bentuk dukungan Anda.
3. Buat repository baru menggunakan template ini dengan cara klik Use this template -> Create a new repository.
4. Isi field Repository name sesuai keinginan Anda.
5. Pastikan visibilitas repository diatur sebagai Public agar fitur GitHub Pages dapat digunakan.
6. Tekan tombol Create repository untuk menginisialisasi repository.
7. Tunggu hingga GitHub selesai membuat repository.
8. Buka menu Settings untuk menyesuaikan pengaturan repository.
9. Klik dropdown Secrets and variables.
10. Pilih opsi Actions.
11. Buka tab Variables.
12. Klik tombol New repository variable.
13. Isi field Name dengan NAMA dan Value dengan nama Anda, lalu tekan Add variable.
14. Tekan tombol New repository variable kembali.
15. Isi field Name dengan NIM dan Value dengan NIM Anda, lalu tekan Add variable.
16. Buka menu Pages di sidebar.
17. Ubah dropdown Source menjadi GitHub Actions.
18. Kembali ke dashboard repository dengan mengklik nama repository di bagian atas.
19. Buka menu pengaturan detail dengan menekan Settings.
20. Centang opsi Use your GitHub Pages website, lalu tekan Save changes.
21. Tunggu hingga ikon Pending berubah menjadi tanda centang.
22. Klik link di bawah About untuk melihat dokumentasi yang telah dibuat.

Integrasi dengan Google Drive (opsional)

1. Akses Google Cloud Console
   Buka https://console.cloud.google.com/ di browser Anda.

2. Navigasi ke APIs & Services
   Klik APIs & Services pada menu utama.
   

3. Buat Proyek Baru
   Klik tab Credentials kemudian tekan tombol Create Project.
   

4. Masukkan Nama Proyek
   Tulis nama proyek pada kolom Project Name, kemudian tekan tombol Create.
   

5. Tunggu Proyek Selesai Dibuat
   Tunggu hingga proses pembuatan proyek selesai.
   

6. Kelola Service Accounts
   Klik Manage Service Accounts untuk mengelola akun layanan.
   

7. Buat Service Account Baru
   Klik Create Service Account untuk membuat akun layanan baru.
   

8. Isi Nama Akun Layanan
   Isi kolom Service Account Name, salin alamat email, dan klik Done.
   
   

9. Kelola Kunci Akun Layanan
   Klik Action pada akun layanan yang dibuat, lalu pilih Manage Keys.
   

10. Buat Kunci Baru
    Tekan Add Key, pilih Create New Key, dan pilih tipe JSON.
    
    

11. Simpan File JSON
    File JSON akan diunduh otomatis. Simpan file ini dengan aman.

12. Berikan Akses ke Google Drive
    Buka folder Google Drive, klik Dibagikan, tambahkan alamat email akun layanan sebagai editor, dan tekan Bagikan.
    
    

13. Salin Folder ID Google Drive
    Salin bagian Folder ID dari URL folder. Contoh:
    https://drive.google.com/drive/u/1/folders/1jTQi9ApagFOppBTYl9Q0bAiiSf6R1yi7
    Folder ID adalah: 1jTQi9ApagFOppBTYl9Q0bAiiSf6R1yi7.

14. Tambahkan Secrets di GitHub
    Buka menu Settings di GitHub, pilih Actions, dan klik New Repository Secret.
    

Isi:

• Name: FOLDER_ID
• Secret: Folder ID yang disalin sebelumnya.

Klik Add Secret.

15. Encode File JSON ke Base64
    Gunakan perintah berikut di terminal:
    base64 <nama_file>.json > encoded_credentials.txt
    Salin isi file encoded_credentials.txt.

16. Tambahkan Secret untuk Credentials
    Tambahkan secret baru:

• Name: CREDENTIALS
• Secret: Hasil Base64 encode.

Klik Add Secret.

17. Selesai
    Setiap kali Anda melakukan push ke repositori, GitHub Actions akan membuat file PDF dan mengunggahnya ke Google Drive.

Penggunaan

Membuat projek baru

1. Clone remote repository ke lokal dengan perintah:
   git clone <URL_REPOSITORY>
   Alternatif lain, gunakan Cloud IDE yang mendukung Flutter, seperti Project IDX, jika tidak ingin bekerja di lingkungan lokal.
2. Buat Folder Praktikum:
   • Buat folder dengan nama praktikum_X, di mana X adalah angka antara 1-14 sesuai nomor praktikum.
   • Jika folder tersebut digunakan untuk tugas akhir, gunakan nama uts atau uas sebagai nama folder.
3. Inisialisasi Proyek Flutter:
   Pindah ke dalam folder yang baru dibuat dan inisialisasi proyek Flutter
4. Tambahkan Folder Screenshots:
   Buat folder bernama screenshots di dalam proyek untuk menyimpan tangkapan layar hasil kerja Anda.
5. Commit dan Push Perubahan:
   Setelah semua langkah selesai, lakukan commit dan push ke GitHub:

   git add .  
   git commit -m "Inisialisasi proyek praktikum_X"  
   git push -u origin <branch>  
   Ganti `<branch>` dengan nama branch yang sesuai, seperti `main` atau `praktikum_X`.

Generate Dokumentasi

• Dokumentasi proyek akan di-generate secara otomatis oleh GitHub Actions saat Anda melakukan push ke repository.
• Dokumentasi akan diunggah ke lokasi yang telah ditentukan sesuai dengan pengaturan repository Anda.

Kontribusi

1. Fork Repository:
   Fork repository ini ke akun GitHub Anda untuk memulai pengembangan.
2. Buat Branch Baru:
   Buat branch baru untuk fitur atau perbaikan yang ingin Anda kembangkan:
   git checkout -b nama_fitur
3. Lakukan Perubahan:
   Lakukan perubahan pada kode sesuai dengan fitur yang ingin ditambahkan atau perbaikan yang dilakukan. Pastikan perubahan Anda terdokumentasi dengan baik di dalam komentar kode.
4. Commit dan Push:
   • Commit perubahan Anda dengan pesan yang deskriptif:
     git commit -m "Menambahkan fitur nama_fitur"
   • Push branch baru Anda ke repository fork:
     git push origin nama_fitur
5. Buat Pull Request:
   Setelah perubahan selesai, buat Pull Request (PR) ke repository utama dan tambahkan deskripsi tentang perubahan yang dilakukan untuk ditinjau oleh kontributor lainnya.