Cara Aman Membersihkan Cache Swift Package Manager

SwiftPM memiliki beberapa lapisan cache

Paket command-line biasanya memiliki direktori .build berisi checkout, repositori, hasil build, dan status workspace, sedangkan SwiftPM juga memelihara cache repositori bersama agar banyak proyek tidak perlu mengunduh dependensi yang sama berulang kali. Xcode menambah satu lapisan lagi: checkout dan produk paket untuk aplikasi biasanya terkait dengan DerivedData proyek. Bersihkan lapisan tersempit yang menjelaskan gejalanya.

Pilih perintah berdasarkan cakupan

swift package clean menghapus artefak build paket saat ini — pilihan pertama untuk hasil kompilasi yang usang atau pembersihan ruang yang terbatas pada satu repositori. swift package reset mengatur ulang seluruh cache dan direktori build paket itu, sehingga dependensi dan status workspace-nya harus disiapkan lagi. swift package purge-cache mengosongkan cache repositori global SwiftPM yang dipakai bersama banyak proyek, sehingga resolve atau build berikutnya mungkin butuh jaringan dan waktu lebih lama; jangan jadikan ini kebiasaan rutin.

1. Commit atau stash perubahan kode sumber, lalu pastikan Package.swift dan Package.resolved ada di tempat yang diharapkan proyek.
2. Dari root paket, jalankan swift package clean lalu coba lagi build yang tadi gagal.
3. Jika workspace lokal paket masih tidak konsisten, jalankan swift package reset, lalu resolve dan build lagi.
4. Jalankan swift package purge-cache hanya jika cache repositori bersama terbukti terlalu besar atau rusak.
5. Periksa graf dependensi dan hasil build sebelum membersihkan DerivedData khusus Xcode.

Ketersediaan perintah mengikuti toolchain Swift yang terpasang. Jalankan swift package --help untuk memastikan subperintah yang didukung di Mac tersebut.

Simpan Package.resolved kecuali Anda memang ingin memperbarui versi

Package.resolved adalah status resolusi dependensi, bukan cache unduhan sekali pakai. Menghapusnya dapat membuat resolusi berikutnya memilih versi lain yang diizinkan Package.swift, sehingga pembersihan diam-diam berubah menjadi pembaruan dependensi. Package.swift, Sources, Tests, plugin, dan dependensi jalur lokal adalah sumber yang Anda tulis; jangan pernah menghapusnya sebagai cache. Isi .build bisa dibuat lagi, sedangkan berkas paket yang Anda tulis belum tentu.

Tangani paket di Xcode secara terpisah

Untuk masalah yang hanya muncul di Xcode, coba File > Packages > Reset Package Caches lalu Resolve Package Versions (nama menu dapat berbeda antarversi Xcode). Jika masalahnya terkait artefak paket hasil kompilasi, hapus hanya DerivedData proyek itu lewat Xcode Settings > Locations atau Finder, bukan seluruh root DerivedData. Untuk ruang disk, ukur dulu folder .build dan cache bersama sebelum purge global. AskClean dapat menunjukkan kategori penyimpanan pengembang di sekitar SwiftPM, tetapi perintah Swift resmi tetap menjadi acuan cakupan cache.

Ringkasan keputusan dan risiko

Bersihkan cache Swift Package Manager (SPM) dengan aman: kapan memakai swift package clean, reset, atau purge-cache, dan cara mempertahankan Package.resolved.

FAQ