Untuk memisahkan berkas yang dihasilkan dari kode sumber di Mac, buat folder output khusus di dalam repositori, lalu tambahkan folder tersebut ke berkas .gitignore milik repositori. Finder membantu Anda membuat dan memeriksa folder; aturan pengabaian Git menjaga agar output yang dihasilkan tidak masuk ke commit mendatang. Hal ini berlaku untuk berkas yang belum dilacak oleh Git, jadi periksa status repositori sebelum mengandalkannya.

Membuat folder output di Finder

Buka folder repositori di Finder dan buat folder untuk output yang dihasilkan, seperti build atau dist, menggunakan File > Folder Baru atau Shift-Command-N. Biarkan berkas sumber tetap di lokasi asalnya dan konfigurasikan alat build Anda untuk menulis outputnya ke folder tersebut. Nama folder harus cocok dengan jalur output sebenarnya dari alat tersebut; membuat folder saja tidak akan mengalihkan proses build. Apple mendokumentasikan langkah-langkah pembuatan folder di Finder dalam panduan mengatur berkas di Finder.

Jika Anda tidak yakin berkas mana saja yang dihasilkan, periksa konfigurasi alat build atau dokumentasi proyek Anda sebelum memindahkan atau mengecualikan apa pun. Beberapa berkas yang dihasilkan memang dibutuhkan oleh proyek atau sengaja dimasukkan (commit). Pertahankan berkas-berkas tersebut di bawah kendali versi jika proyek membutuhkannya.

Menambahkan folder yang dihasilkan ke .gitignore

Di root repositori, buat atau buka berkas bernama .gitignore di editor teks. Finder dapat membuat folder dan memindahkan berkas, tetapi tidak menyediakan kontrol ignore Git; Git membaca pola pengabaian dari .gitignore dan konfigurasi terkait. Tambahkan aturan untuk direktori output, menggunakan jalur sebenarnya yang relatif terhadap berkas .gitignore. Sebagai contoh:

/build/

Garis miring di awal menetapkan pola ini di root repositori, dan garis miring di akhir membuatnya cocok dengan sebuah direktori. Jika output yang Anda hasilkan bersarang (nested), gunakan jalurnya, misalnya /app/generated/. Dokumentasi gitignore Git menjelaskan pencocokan pola dan menyebutkan bahwa aturan untuk seluruh proyek berada di .gitignore agar dapat dibagikan dengan hasil klon (clone) lainnya.

Untuk folder lokal yang dihasilkan dan tidak boleh memengaruhi orang lain yang bekerja pada repositori tersebut, tambahkan aturannya ke .git/info/exclude. Git mendokumentasikan hal ini sebagai alternatif khusus repositori untuk .gitignore. Gunakan aturan .gitignore yang di-commit jika output tersebut dihasilkan untuk semua orang di dalam proyek dan harus dikecualikan bagi semua kontributor.

Mengonfirmasi aturan dan menangani berkas yang sudah terlacak

Buka Terminal dan arahkan ke direktori repositori. Periksa statusnya, lalu tanyakan kepada Git aturan mana yang berlaku untuk jalur yang dihasilkan:

git status --short
git check-ignore -v build/example-file

Ganti build/example-file dengan jalur yang ada di bawah folder output Anda. Opsi -v akan melaporkan aturan pengabaian yang cocok beserta berkas yang memuatnya. Jika Git melaporkan tidak ada kecocokan, konfirmasikan jalur dan polanya: jalur di .gitignore ditafsirkan secara relatif terhadap lokasi berkas tersebut, dan suatu aturan dapat ditimpa oleh aturan pencocokan lainnya. Referensi check-ignore Git menjelaskan cara memeriksa kecocokan pengabaian.

Aturan pengabaian tidak akan menghentikan pelacakan berkas yang sudah di-commit atau di-stage di Git. Git secara eksplisit menyatakan bahwa berkas yang sudah dilacak tidak terpengaruh oleh aturan pengabaian. Untuk menghapus berkas hasil pembuatan yang sebelumnya terlacak dari indeks sambil tetap mempertahankan salinan lokalnya, gunakan git rm --cached dengan jalur yang tepat, lalu tinjau perubahannya sebelum melakukan commit. Sebagai contoh:

git rm --cached build/example-file
git status --short

Perintah ini hanya menghapus berkas yang disebutkan dari indeks Git; ini tidak secara otomatis membatalkan pelacakan (untrack) setiap berkas dalam suatu direktori. Tinjau output status, terutama jika Anda bermaksud membatalkan pelacakan seluruh struktur output, sebelum melakukan commit perubahan. Panduan GitHub tentang mengabaikan berkas juga menjelaskan perbedaan antara pengecualian lokal dan aturan .gitignore bersama.

Menggunakan Finder untuk memeriksa nama, bukan untuk menerapkan aturan Git

Finder dapat mempermudah pemeriksaan jenis berkas: pilih Finder > Pengaturan > Lanjutan dan aktifkan Tampilkan semua ekstensi nama file. Ini dapat membantu membedakan berkas sumber dari berkas yang dihasilkan ketika namanya mirip. Apple mencatat bahwa ekstensi mungkin disembunyikan secara default dan menyarankan untuk tidak mengubah ekstensi nama berkas hanya untuk mengubah format berkas. Lihat petunjuk Apple untuk menampilkan atau menyembunyikan ekstensi nama file.

Oleh karena itu, pembagian tugas yang andal adalah: Finder menyediakan folder yang terlihat untuk output yang dihasilkan, alat build menulis ke sana, dan aturan ignore Git mengecualikan berkas yang tidak terlacak dan memenuhi syarat dari kendali versi. Periksa jalur output sebenarnya dan status Git setiap kali konfigurasi build proyek berubah.

Sumber